← All skills

🧰 Heading Outline Audit

Reads a web page's HTML and prints its H1-H6 outline, then flags missing or duplicate H1s, skipped levels, empty headings and headings used only for styling.

Site auditsBeginner · Copy and use. No edits needed.FreePublished Nov 2, 2026
Tested on✓ CodexSee test log
Free download

ZIP with SKILL.md and any reference files.

Download ZIP

What it does

Point the skill at an HTML file (or paste the page source) and it shows the heading structure as an indented outline, the way a screen reader or a search crawler would walk it. Then it lists concrete fixes: which heading to promote, demote, merge or rewrite.

Use it when: you redesigned a template, moved content between sections, or a page “feels” messy and you want a quick structure check before publishing.

Works with: Claude Code, Claude.ai (Skills upload), Cursor and Codex. Install the ZIP, then ask your agent to audit the headings of a page or folder.

Read-only by default. It doesn’t fetch live URLs or judge keyword choices; it only checks the structure that’s in the HTML you give it.

Output preview

Task given to the agent: “Read and follow .agents/skills/heading-outline-audit/SKILL.md before you answer. Use that skill's output format. Audit the heading structure of this page source. Read-only; report in the skill's format. <html><body> <header><h3>Menu</h3><nav><a href='/'>Home</a></nav></header> <h1>Zion National Park in Late Fall</h1> <h2>When to go</h2><p>Late October to mid-November is quieter.</p> <h4>Shuttle schedule</h4><p>Reduced after the main season.</p> <h2>Hikes</h2> <h3>Angels Landing</h3><p>Permit lottery required.</p> <h3></h3><p>The Narrows can be very cold.</p> <h3>Angels Landing</h3><p>Chains section notes.</p> <h1>Where to stay in Springdale and nearby towns if you are visiting in the shoulder season</h1> <footer><h2>Follow us</h2></footer> </body></html> ”

AFTER · with the skill
Heading outline: pasted page
  H3 Menu
H1 Zion National Park in Late Fall
  H2 When to go
    H4 Shuttle schedule
  H2 Hikes
    H3 Angels Landing
    H3 
    H3 Angels Landing
H1 Where to stay in Springdale and nearby towns if you are visiting in the shoulder season
  H2 Follow us

| # | Issue | Heading | Fix |
| 1 | MULTI_H1 | `H1 Zion National Park in Late Fall`; `H1 Where to stay in Springdale and nearby towns if you are visiting in the shoulder season` | Keep one `h1` for the page topic; demote the second to `h2` or a normal paragraph if it’s a separate promo block. |
| 2 | SKIP | `H4 Shuttle schedule` after `H2 When to go` | Demote to `h3`, or add an `h3` section heading between the `h2` and `h4`. |
| 3 | EMPTY | `H3` | Add visible text, or change it to a non-heading element if it’s decorative. |
| 4 | DUPLICATE | `H3 Angels Landing` | Differentiate the sections, or merge them into one heading if they describe the same topic. |
| 5 | STYLE_ONLY | `H3 Menu` | Change to `span`/`p`, or remove the heading if it’s only a nav label. |
| 6 | STYLE_ONLY | `H2 Follow us` | Change to a non-heading element in the footer unless it starts a real content section. |

Summary: 8 headings, 6 issues (NO_H1 0, MULTI_H1 1, SKIP 1, EMPTY 1, DUPLICATE 1, STYLE_ONLY 2, LONG 0)

Real, unedited output from recorded runs on Nov 2, 2026 · Codex (codex-cli 0.163.0) · model gpt-5.4-mini. Test inputs are fixtures (fictional brand, example.com links). AI output can be wrong: check facts before you publish anything like it.

Install

Unzip first. You get a folder named heading-outline-audit containing SKILL.md.

Claude Code

Put the folder in your personal skills directory, or in the project to share it with your team.

~/.claude/skills/heading-outline-audit/SKILL.md.claude/skills/heading-outline-audit/SKILL.md

Claude Code picks up new skills in the current session (run /reload-skills if the skills folder didn't exist when the session started). The skill loads when a task matches its description.

Claude.ai

Turn on code execution (Settings → Capabilities), then go to Customize → Skills, click +, then Create skill → Upload a skill, and select the ZIP. Full guide.

Cursor

Put the folder in your user or project skills directory. Cursor also reads .claude/skills.

~/.cursor/skills/heading-outline-audit/SKILL.md.cursor/skills/heading-outline-audit/SKILL.md

Codex

Put the folder in your user or repository skills directory, then restart Codex or run /skills to check it is listed.

~/.agents/skills/heading-outline-audit/SKILL.md.agents/skills/heading-outline-audit/SKILL.md

These are the standard skill locations for each tool. The tools a skill is verified on are listed under “Tested on” above, if any.

Test log

Date (UTC)ToolModelRunResultChecksTokens in / out
Nov 2, 2026Codexgpt-5.4-miniTestPassed
4/4
  • ✓ codex exited cleanly
  • ✓ skill was loaded (SKILL.md read)
  • ✓ output has substance (80+ words) (252 words)
  • ✓ no obvious secret leak
25,013 / 492

Each row is a real run recorded by our test runner. For each tool, the latest test run decides whether it appears under “Tested on”. Baseline runs do the same task with no skill installed and never count.