majiayu000/claude-arsenal
xiaohongshu
xiaohongshu
286 148
View 
Check Headings
check-headings
Analyze and validate HTML heading hierarchy (H1-H6) on web pages. Use when users ask to check headings structure, verify H1 presence, analyze SEO heading hierarchy, find heading issues, or audit page structure. Detects missing H1, multiple H1s, skipped levels, empty headings, and hierarchy violat...
SKILL.md
Full skill instructions
Check Headings
Analyze and validate HTML heading hierarchy (H1-H6) on web pages for SEO and accessibility compliance.
Quick Start
Run the heading checker from the scripts directory:
cd /path/to/html-checker/scripts
bun src/check-headings.ts <URL>
CLI Options
| Option | Short | Default | Description |
|---|---|---|---|
--verbose | -v | false | Show detailed heading content |
--json | -j | false | Output results as JSON |
Checks Performed
| Check | Severity | Description |
|---|---|---|
| Missing H1 | Error | Page has no H1 heading |
| Multiple H1 | Warning | Page has more than one H1 |
| Skipped Level | Warning | Heading level skipped (e.g., H2 to H4) |
| Empty Heading | Error | Heading tag with no text content |
| Wrong Order | Warning | Heading appears before its parent level |
Usage Examples
Basic check
bun src/check-headings.ts https://example.com
Verbose output with heading content
bun src/check-headings.ts https://example.com --verbose
JSON output for automation
bun src/check-headings.ts https://example.com --json
Output
The checker provides:
- Summary - Total headings found per level
- Issues - List of problems with severity
- Hierarchy - Visual tree of heading structure
- Recommendations - Actionable fixes
Example Output
Heading Analysis for https://example.com
Summary:
H1: 1 H2: 5 H3: 12 H4: 3 H5: 0 H6: 0
Issues Found: 2
[WARNING] Skipped level: H2 -> H4 at line 45
[ERROR] Empty heading: H3 at line 78
Hierarchy:
H1: Welcome to Example
H2: About Us
H3: Our Mission
H3: Our Team
H2: Services
H4: Web Development <-- Skipped H3
SEO Best Practices
- One H1 per page: The H1 should match the page's main topic
- Sequential hierarchy: Don't skip levels (H2 -> H4)
- Descriptive headings: Avoid generic text like "Read More"
- Keyword inclusion: Include target keywords naturally
- Logical structure: Headings should outline page content
Accessibility (WCAG)
- SC 1.3.1: Headings must convey structure
- SC 2.4.6: Headings must be descriptive
- SC 2.4.10: Section headings organize content
Related Files
- Scripts:
/plugins/html-checker/scripts/ - Check Links:
/plugins/html-checker/skills/check-links/
More skills from majiayu000
majiayu000/claude-arsenal
technical-spec
technical spec
286 141
View majiayu000/claude-arsenal
product-ux-expert
product ux expert
286 133
View majiayu000/claude-arsenal
database-patterns
database patterns
286 119
View majiayu000/claude-skill-registry
agent-task-conductor
Conduct multi-agent task orchestration and workflow coordination.
663 1
View majiayu000/claude-skill-registry
conductor-setup
Initialize project with Conductor artifacts (product definition,
663 1
View majiayu000/claude-skill-registry
animation-designer
Expert in web animations, transitions, and motion design using Framer Motion and CSS
663 1
View majiayu000/claude-skill-registry
diagramming
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
663 1
View majiayu000/claude-skill-registry-data
h3-pg
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
23 1
View majiayu000/claude-skill-registry
conductor-development
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
663 1
View majiayu000/claude-skill-registry
conductor-status
Display project status, active tracks, and next actions
663 1
View majiayu000/claude-skill-registry
dockerization
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
663 1
View Popular AI tools
Video
Kaiber
Generate, edit, and beat-sync AI video with leading models in one workspace.
Paid
View Productivity
Vimcal
The world's fastest calendar for remote work
Free
View Images
IMGCreator.ai
Transform Your Design with AI Designer by ImgCreator.ai
Freemium
View Content & writing
Akool AI
Revolutionizing Video Production with AI-Powered Creativity
Paid
View Images
Clipdrop Uncrop
Extend an image past the frame and let AI fill the new aspect ratio.
Freemium
View Security
StarByFace
Discover your celebrity doppelgänger with StarByFace!
Free
View C
Finance
ChainClarity
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Freemium
View Coding & apps
Opus Clip
Opus.ai: Revolutionize Your Web Experience
Free
View