SEO Audits That
Think Like Experts
11 SKILL.md files that teach AI coding agents to run comprehensive, industry-standard SEO audits on any HTML page — no dependencies, no setup.
Works with Cursor · Claude Code · VS Code Copilot & more
Built different from traditional SEO tools
Instead of running scripts or crawling URLs, this project lets AI agents perform audits by reading simple markdown instructions.
No Code to Run
The AI agent reads plain-language instructions and audits pages using its own capabilities. There is nothing to install, compile, or execute.
No Dependencies
The entire toolkit is a set of SKILL.md files. No npm packages, no build steps, no configuration files required.
Multi-Agent Compatible
Designed for Cursor, Claude Code, VS Code Copilot, Gemini CLI, Roo Code, Amp, and any agent that reads markdown.
Actionable Results
Every check returns a clear PASS, WARN, or FAIL status alongside specific, copy-paste-ready fix instructions.
10 SEO Audit Skills
Each skill is a standalone SKILL.md file covering a specific area of SEO — from meta tags to Core Web Vitals.
Validates heading hierarchy, keyword density and placement, and internal/external link structure for any HTML page.
Validates existing JSON-LD structured data and suggests relevant schemas based on auto-detected page type. Only checks what is applicable to the current page context.
Validates title tags, meta descriptions, Open Graph tags, and Twitter Cards for search engine and social media optimisation.
Validates HTML5 semantic elements, ARIA landmarks, skip navigation, and page structure for SEO and accessibility.
Audits stylesheet loading, inline CSS volume, image alt text, image formats, and Next.js Image component usage.
Validates viewport meta configuration, responsive design, font sizes, touch target sizes, and mobile-hostile patterns.
Analyses outbound links for dofollow/nofollow strategy, domain diversity, anchor text quality, and sponsored/UGC attributes.
Validates hreflang tags, multi-language configuration, regional targeting, and internationalisation best practices.
Audits sitemap references, robots.txt directives, canonical tags, crawlability, URL structure, redirect chains, and indexability.
Audits HTML patterns that affect Core Web Vitals (LCP, CLS, INP). Checks for layout shift causes, largest contentful paint blockers, and interaction responsiveness issues.
How It Works
No configuration, no API keys — just clone the skills into your project and ask your AI agent.
Discovery
Agent finds SKILL.md files at startup and loads metadata
Matching
When you ask an SEO question, the agent routes to the relevant skill(s)
Auditing
The agent reads detailed instructions with exact rules, thresholds, and checklists
Reporting
Results are reported as PASS / WARN / FAIL with actionable fixes
Works with every major AI agent
Drop the skill files into your project and your favourite AI coding assistant picks them up automatically — no configuration required.
Cursor
Scans workspace for SKILL.md files
Claude Code
Auto-discovers SKILL.md in workspace
VS Code Copilot
Reads SKILL.md from workspace
Gemini CLI
Scans project for skills at startup
Antigravity
Auto-discovers skills in workspace
Roo Code
Discovers via workspace root
Amp
Auto-discovered in workspace
Goose
Configured skill directories
Any agent that reads SKILL.md files from the workspace is compatible.
Quick Start
Get up and running in under 30 seconds — just clone and ask.
$ git clone https://github.com/thisisAhsanIqbal/nextjs-seo-audit.git .agent/skills/nextjs-seo-audit$ git submodule add https://github.com/thisisAhsanIqbal/nextjs-seo-audit.git .agent/skills/nextjs-seo-audit