About nextjs-seo-audit
An SEO audit skill for HTML pages and Next.js sites, organized into 10 specialist areas. It provides checklists for audits and fixes covering metadata, structured data, performance, mobile use, and technical SEO.
Key features
- 01Coordinate 10 SEO audit sub-skills
- 02Review headings, keywords, and internal links
- 03Check metadata and structured data
- 04Assess speed, mobile, and Core Web Vitals
- 05Review technical SEO and backlink strategy
- 06Report actionable statuses and a score
Use cases
- 01Audit an HTML page or full website
- 02Find SEO issues in a Next.js page
- 03Validate JSON-LD and social sharing metadata
- 04Review performance and mobile readiness
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/nextjs-seo-auditin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.gitignoreLICENSEREADME.mdDetails
From the project READMEnextjs-seo-audit
A comprehensive SEO audit skill that teaches you how to analyse HTML pages and provide actionable recommendations across 10 skill areas.
When to activate
Use this skill when the user asks you to:
- Run an SEO audit on a page, component, or full website
- Fix specific SEO issues (headings, meta tags, schema, speed, etc.)
- Optimise a Next.js or HTML page for search engines
- Validate structured data (JSON-LD), Open Graph, or Twitter Cards
- Check page performance, semantic HTML, or mobile-friendliness
- Analyse outbound links or backlink strategy
How to run a full audit
When performing a full SEO audit, run all 10 sub-skills in order on the provided HTML. Read each sub-skill's SKILL.md for the detailed checklist:
| # | Skill | SKILL.md | Focus area |
|---|---|---|---|
| 1 | On-Page Optimization | skills/onpage-optimization/SKILL.md | Headings, keywords, internal links |
| 2 | Schema JSON Optimization | skills/schema-json-optimization/SKILL.md | JSON-LD structured data |
| 3 | Meta Data Optimization | skills/meta-data-optimization/SKILL.md | Title, description, OG, Twitter Cards |
| 4 | Semantic Layout | skills/semantic-layout/SKILL.md | HTML5 semantic elements, accessibility |
| 5 | Site Speed Optimization | skills/site-speed-optimization/SKILL.md | Scripts, stylesheets, images |
| 6 | Mobile Optimization | skills/mobile-optimization/SKILL.md | Viewport, responsive design, touch targets |
| 7 | Backlink Monitoring | skills/backlink-monitoring/SKILL.md | External links, dofollow/nofollow strategy |
| 8 | International SEO | skills/international-seo/SKILL.md | Hreflang, multi-language, regional targeting |
| 9 | Technical SEO | skills/technical-seo/SKILL.md | Sitemap, robots.txt, canonical, crawlability |
| 10 | Core Web Vitals | skills/core-web-vitals/SKILL.md | LCP, CLS, INP, performance scoring |
Output format
For each check, report:
- Status:
✅ PASS,⚠️ WARN, or❌ FAIL - Message: Clear, actionable description of the finding
At the end, provide a summary:
SEO Audit Summary
─────────────────
✅ Pass: X
⚠️ Warn: Y
❌ Fail: Z
──────────────
Score: XX%
Global thresholds reference
These thresholds are used across all sub-skills:
| Parameter | Value |
|---|---|
| Title length | 30–60 characters |
| Meta description length | 120–160 characters |
| Keyword density (ideal) | 1.0–3.0% |
| Internal links (min per page) | 3 |
| Max fixed-width before warning | 500px |
| Min touch target size | 48px × 48px |
| Max inline CSS length | 5000 characters |
| Max external scripts | 10 |
| Required OG tags | og:title, og:description, og:image, og:url, og:type |
| Required Twitter Card tags | twitter:card, twitter:title, twitter:description |
| Required semantic elements | header, main, footer, nav |
| Recommended semantic elements | article, section, aside, figure |