Skip to content
Get packs

Single Descriptive H1 Audit

Checks and writes page H1 headings so each page has one clear, topical main heading

Source Download skill
Repository
thedaviddias/Front-End-Checklist
Stars
74,632
Licence
MIT
Files
2 files

What it does

Once installed, the agent can review a page's heading structure for common SEO problems: missing H1 tags, multiple H1s, empty headings, or headings that only show the brand name. It can also suggest or write a better H1 for a landing page or blog post, and review CMS templates that might output empty headings. The guidance is a checklist-style set of rules drawn from the Front-End Checklist SEO page.

Great for

  • Website owners or marketers checking whether landing pages have a clear main heading
  • Front-end developers reviewing page templates in a CMS or React/Next.js app
  • Content writers who want an H1 that matches a page's topic and target keyword

Skip it if

  • Sites that need a full SEO audit beyond headings (the skill covers only H1 structure, not content, speed or links)
  • Pages where the H1 is intentionally chosen by brand or legal rules, since the skill may suggest changes that conflict with those constraints

Try asking

  • “Audit the heading structure of this page and tell me if it has zero, multiple or empty H1 tags”
  • “Write a descriptive H1 for my project management software landing page targeting enterprise teams”
  • “Review our CMS blog template to check it cannot output an empty H1”
Step-by-step guide: how to use Single Descriptive H1 AuditInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    h1.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip h1.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip h1.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent the rendered HTML or the page URL plus its target keyword so it can judge whether the H1 reflects the topic
  • Ask for a before-and-after example so you can compare the suggested H1 with the current one before changing anything
  • Check the agent's suggestions against your brand guidelines, since it recommends keywords and topic focus that may not fit every site

What's inside

  • references/rule.md
  • SKILL.md

Redistributed unmodified from thedaviddias/Front-End-Checklist under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.