Skip to content

Latest commit

 

History

History
83 lines (67 loc) · 3.81 KB

SKILL.md

File metadata and controls

83 lines (67 loc) · 3.81 KB
name description license metadata
nextjs-seo-audit
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.
MIT

nextjs-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