seo

agricidaniel/claude-seo · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/agricidaniel/claude-seo --skill seo
0 commentsdiscussion
summary

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
skill.md

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:

  1. Detect business type (SaaS, local, ecommerce, publisher, agency, other)
  2. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
  3. If Google API credentials detected (python scripts/google_auth.py --check), also spawn seo-google agent
  4. If local business detected, also spawn seo-local agent
  5. If local business detected AND DataForSEO MCP available, also spawn seo-maps agent
  6. If backlink APIs detected (python scripts/backlinks_auth.py --check), also spawn seo-backlinks agent
  7. If Firecrawl MCP available, use firecrawl_map to discover all site URLs before analysis
  8. Collect results and generate unified report with SEO Health Score (0-100)
  9. Create prioritized action plan (Critical -> High -> Medium -> Low)
  10. 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 local for 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 details
  • references/schema-types.md: All supported schema types with deprecation status
  • references/eeat-framework.md: E-E-A-T evaluation criteria (Sept 2025 QRG update)
  • references/quality-gates.md: Content length minimums, uniqueness thresholds
  • references/local-seo-signals.md: Local ranking factors, review benchmarks, citation tiers, GBP status
  • references/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):

  1. seo-audit -- Full website audit with parallel delegation
  2. seo-page -- Deep single-page analysis
  3. seo-technical -- Technical SEO (9 categories)
  4. seo-content -- E-E-A-T and content quality
  5. seo-schema -- Schema markup detection and generation
  6. seo-images -- Image optimization, SERP analysis, file optimization
  7. seo-sitemap -- Sitemap analysis and generation
  8. seo-geo -- AI Overviews / GEO optimization
  9. seo-plan -- Strategic planning with templates
  10. seo-programmatic -- Programmatic SEO analysis and planning
  11. seo-competitor-pages -- Competitor comparison page generation
  12. seo-hreflang -- Hreflang/i18n SEO audit and generation
  13. seo-local -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location)
  14. seo-maps -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius)
  15. seo-google -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4)
  16. seo-backlinks -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO)
  17. seo-firecrawl -- Full-site crawling and site mapping via Firecrawl MCP (extension)
  18. seo-dataforseo -- Live SEO data via DataForSEO MCP (extension)
  19. seo-image-gen -- AI image generation for SEO assets via Gemini (extension)

Subagents

For parallel analysis during audits:

  • seo-technical -- Crawlability, indexability, security, CWV
  • seo-content -- E-E-A-T, readability, thin content
  • seo-schema -- Detection, validation, generation
  • seo-sitemap -- Structure, coverage, quality gates
  • seo-performance -- Core Web Vitals measurement
  • seo-visual -- Screenshots, mobile testing, above-fold
  • seo-geo -- AI crawler access, llms.txt, citability, brand mention signals
  • seo-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

How to use seo on Cursor

AI-first code editor with Composer

1

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
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/agricidaniel/claude-seo --skill seo

The skills CLI fetches seo from GitHub repository agricidaniel/claude-seo and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/seo

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

GET_STARTED →

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. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 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

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.858 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

1 / 6