/SKILL.md
Comprehensive SEO audit skill for Next.js and HTML pages. Covers on-page optimisation, JSON-LD schema validation, meta tags, Open Graph, semantic HTML, site speed, mobile responsiveness, and backlink analysis. Use when a user asks to audit, optimise, or fix SEO issues on a webpage or website.
npx skillsauth add thisisahsaniqbal/nextjs-seo-audit nextjs-seo-auditInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A comprehensive SEO audit skill that teaches you how to analyse HTML pages and provide actionable recommendations across 10 skill areas.
Use this skill when the user asks you to:
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 |
For each check, report:
✅ PASS, ⚠️ WARN, or ❌ FAILAt the end, provide a summary:
SEO Audit Summary
─────────────────
✅ Pass: X
⚠️ Warn: Y
❌ Fail: Z
──────────────
Score: XX%
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 |
testing
Audits sitemap references, robots.txt directives, canonical tags, crawlability, URL structure, redirect chains, and indexability. Use when checking technical SEO foundations or fixing crawl/index issues.
development
Audits stylesheet loading, inline CSS volume, image alt text, image formats, and Next.js Image component usage. Use when checking page speed related to HTML structure. For render-blocking scripts, image dimensions, lazy loading, and resource hints, see the core-web-vitals skill.
development
Validates HTML5 semantic elements, ARIA landmarks, skip navigation, and page structure. Use when auditing semantic HTML, accessibility, or content structure for SEO. For the lang attribute, see the international-seo skill.
testing
Validates existing JSON-LD structured data and suggests relevant schemas based on auto-detected page type. Does NOT enforce all schema types — only checks what is applicable to the current page context. Use when auditing or generating structured data for search engine rich results.