seo▌
agricidaniel/claude-seo · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
Full-site and single-page SEO analysis with technical audits, content quality assessment, schema validation, and AI search optimization.
- ›Orchestrates 12 specialized sub-skills across technical SEO, E-E-A-T content evaluation, Core Web Vitals (INP), schema markup detection and generation, and image optimization
- ›Detects business type (SaaS, local service, e-commerce, publisher, agency) and applies industry-specific quality gates and scoring methodology
- ›Analyzes AI search readiness incl
SEO: Universal SEO Analysis Skill
Invocation: /seo $1 $2 where $1 is the command and $2 is the URL or argument.
Scripts: Located at the plugin root scripts/ directory.
Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 16 specialized sub-skills and 11 subagents (+ 3 optional extension sub-skills: seo-dataforseo, seo-firecrawl, and seo-image-gen).
Quick Reference
| Command | What it does |
|---|---|
/seo audit <url> |
Full website audit with parallel subagent delegation |
/seo page <url> |
Deep single-page analysis |
/seo sitemap <url or generate> |
Analyze or generate XML sitemaps |
/seo schema <url> |
Detect, validate, and generate Schema.org markup |
/seo images <url or optimize> |
Image SEO: on-page audit, SERP analysis, file optimization |
/seo technical <url> |
Technical SEO audit (9 categories) |
/seo content <url> |
E-E-A-T and content quality analysis |
/seo geo <url> |
AI Overviews / Generative Engine Optimization |
/seo plan <business-type> |
Strategic SEO planning |
/seo programmatic [url|plan] |
Programmatic SEO analysis and planning |
/seo competitor-pages [url|generate] |
Competitor comparison page generation |
/seo local <url> |
Local SEO analysis (GBP, citations, reviews, map pack) |
/seo maps [command] [args] |
Maps intelligence (geo-grid, GBP audit, reviews, competitors) |
/seo hreflang [url] |
Hreflang/i18n SEO audit and generation |
/seo google [command] [url] |
Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |
/seo backlinks <url> |
Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) |
/seo firecrawl [command] <url> |
Full-site crawling and site mapping (extension) |
/seo dataforseo [command] |
Live SEO data via DataForSEO (extension) |
/seo image-gen [use-case] <description> |
AI image generation for SEO assets (extension) |
Orchestration Logic
When the user invokes /seo audit, delegate to subagents in parallel:
- Detect business type (SaaS, local, ecommerce, publisher, agency, other)
- Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
- If Google API credentials detected (
python scripts/google_auth.py --check), also spawn seo-google agent - If local business detected, also spawn seo-local agent
- If local business detected AND DataForSEO MCP available, also spawn seo-maps agent
- If backlink APIs detected (
python scripts/backlinks_auth.py --check), also spawn seo-backlinks agent - If Firecrawl MCP available, use
firecrawl_mapto discover all site URLs before analysis - Collect results and generate unified report with SEO Health Score (0-100)
- Create prioritized action plan (Critical -> High -> Medium -> Low)
- Offer PDF report: "Generate a professional PDF report? Use
/seo google report full"
For individual commands, load the relevant sub-skill directly.
After any analysis command completes, offer to generate a PDF report via scripts/google_report.py.
Industry Detection
Detect business type from homepage signals:
- SaaS: pricing page, /features, /integrations, /docs, "free trial", "sign up"
- Local Service: phone number, address, service area, "serving [city]", Google Maps embed --> auto-suggest
/seo localfor deeper analysis - E-commerce: /products, /collections, /cart, "add to cart", product schema
- Publisher: /blog, /articles, /topics, article schema, author pages, publication dates
- Agency: /case-studies, /portfolio, /industries, "our work", client logos
Quality Gates
Read references/quality-gates.md for thin content thresholds per page type.
Hard rules:
- WARNING at 30+ location pages (enforce 60%+ unique content)
- HARD STOP at 50+ location pages (require user justification)
- Never recommend HowTo schema (deprecated Sept 2023)
- FAQ schema for Google rich results: only government and healthcare sites (Aug 2023 restriction); existing FAQPage on commercial sites -> flag Info priority (not Critical), noting AI/LLM citation benefit; adding new FAQPage -> not recommended for Google benefit
- All Core Web Vitals references use INP, never FID
Reference Files
Load these on-demand as needed (do NOT load all at startup):
references/cwv-thresholds.md: Current Core Web Vitals thresholds and measurement detailsreferences/schema-types.md: All supported schema types with deprecation statusreferences/eeat-framework.md: E-E-A-T evaluation criteria (Sept 2025 QRG update)references/quality-gates.md: Content length minimums, uniqueness thresholdsreferences/local-seo-signals.md: Local ranking factors, review benchmarks, citation tiers, GBP statusreferences/local-schema-types.md: LocalBusiness subtypes, industry-specific schema and citation sources
Maps-specific references (loaded by seo-maps skill, not at startup):
references/maps-geo-grid.md,references/maps-gbp-checklist.md,references/maps-api-endpoints.md,references/maps-free-apis.md
Scoring Methodology
SEO Health Score (0-100)
Weighted aggregate of all categories:
| Category | Weight |
|---|---|
| Technical SEO | 22% |
| Content Quality | 23% |
| On-Page SEO | 20% |
| Schema / Structured Data | 10% |
| Performance (CWV) | 10% |
| AI Search Readiness | 10% |
| Images | 5% |
Priority Levels
- Critical: Blocks indexing or causes penalties (immediate fix required)
- High: Significantly impacts rankings (fix within 1 week)
- Medium: Optimization opportunity (fix within 1 month)
- Low: Nice to have (backlog)
Sub-Skills
This skill orchestrates 15 specialized sub-skills (+ 2 extensions):
- seo-audit -- Full website audit with parallel delegation
- seo-page -- Deep single-page analysis
- seo-technical -- Technical SEO (9 categories)
- seo-content -- E-E-A-T and content quality
- seo-schema -- Schema markup detection and generation
- seo-images -- Image optimization, SERP analysis, file optimization
- seo-sitemap -- Sitemap analysis and generation
- seo-geo -- AI Overviews / GEO optimization
- seo-plan -- Strategic planning with templates
- seo-programmatic -- Programmatic SEO analysis and planning
- seo-competitor-pages -- Competitor comparison page generation
- seo-hreflang -- Hreflang/i18n SEO audit and generation
- seo-local -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location)
- seo-maps -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius)
- seo-google -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4)
- seo-backlinks -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO)
- seo-firecrawl -- Full-site crawling and site mapping via Firecrawl MCP (extension)
- seo-dataforseo -- Live SEO data via DataForSEO MCP (extension)
- seo-image-gen -- AI image generation for SEO assets via Gemini (extension)
Subagents
For parallel analysis during audits:
seo-technical-- Crawlability, indexability, security, CWVseo-content-- E-E-A-T, readability, thin contentseo-schema-- Detection, validation, generationseo-sitemap-- Structure, coverage, quality gatesseo-performance-- Core Web Vitals measurementseo-visual-- Screenshots, mobile testing, above-foldseo-geo-- AI crawler access, llms.txt, citability, brand mention signalsseo-local-- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (conditional: spawned when Local Service detected)seo-maps-- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (conditional: spawned when Local Service detected AND DataForSEO MCP available)seo-google-- CWV field data, URL indexation status, organic traffic trends (conditional: spawned when Google API credentials detected)seo-backlinks-- Backlink profile data: DA/PA, referring domains, anchor text, toxic links (conditional: spawned when Moz/Bing API keys detected or always for CC domain-level metrics)seo-dataforseo-- Live SERP, keyword, backlink, local SEO data (extension, optional)seo-image-gen-- SEO image audit and generation plan (extension, optional)seo-firecrawl-- Full-site crawl and site mapping (extension, optional; used by audit for URL discovery)
Error Handling
| Scenario | Action |
|---|---|
| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |
| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |
| Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. |
| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |
How to use seo on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add seo
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches seo from GitHub repository agricidaniel/claude-seo and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate seo. Access the skill through slash commands (e.g., /seo) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
Task Automation & Efficiency
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Knowledge Enhancement
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Quality Improvement
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client with skill support
- ›Clear understanding of task or problem to solve
- ›Willingness to iterate and refine outputs
Time Estimate
15-45 minutes depending on use case complexity
Installation Steps
- 1.Install skill using provided installation command
- 2.Test with simple use case relevant to your work
- 3.Evaluate output quality and relevance
- 4.Iterate on prompts to improve results
- 5.Integrate into regular workflow if valuable
Common Pitfalls
- ⚠Expecting perfect results without iteration
- ⚠Not providing enough context in prompts
- ⚠Using skill for tasks outside its intended scope
- ⚠Accepting outputs without review and validation
Best Practices▌
✓ Do
- +Start with clear, specific prompts
- +Provide relevant context and constraints
- +Review and refine all outputs before using
- +Iterate to improve output quality
- +Document successful prompt patterns
✗ Don't
- −Don't use without understanding skill limitations
- −Don't skip validation of outputs
- −Don't share sensitive information in prompts
- −Don't expect skill to replace human judgment
💡 Pro Tips
- ★Be specific about desired format and style
- ★Ask for multiple options to choose from
- ★Request explanations to understand reasoning
- ★Combine AI efficiency with human expertise
When to Use This▌
✓ Use When
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid When
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
Learning Path▌
- 1Familiarize yourself with skill capabilities and limitations
- 2Start with low-risk, non-critical tasks
- 3Progress to more complex and valuable use cases
- 4Build expertise through regular use and experimentation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.8★★★★★58 reviews- ★★★★★Rahul Santra· Dec 28, 2024
seo fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Mia Desai· Dec 28, 2024
seo is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Sofia Desai· Dec 16, 2024
seo fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Arya Kapoor· Dec 12, 2024
I recommend seo for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Chaitanya Patil· Nov 27, 2024
seo has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Pratham Ware· Nov 19, 2024
Registry listing for seo matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Mia Shah· Nov 19, 2024
Useful defaults in seo — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Yuki Huang· Nov 7, 2024
Registry listing for seo matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Luis Zhang· Nov 3, 2024
Keeps context tight: seo is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Evelyn Gonzalez· Oct 26, 2024
seo reduced setup friction for our internal harness; good balance of opinion and flexibility.
showing 1-10 of 58