Claude SEO Skills For Repeatable Search Work.

Claude-SEO-Skills

A collection of Claude skills for SEO tasks. Each folder under skills/ is a self-contained, fully functional Claude skill.

Each skill performs a real technical-SEO audit — crawling a site (or scanning local HTML), checking it against documented rules, and producing a prioritized, paste-ready report. They're built to be read and learned from as much as run: the rationale behind every check lives in each skill's references/audit-checks.md.

• See what they produce: examples/ — illustrative sample reports.
• Understand how they work: docs/CONVENTIONS.md — the design behind every skill.

Requirements

• Python 3.8+ to run the audit scripts. No pip install required — every script uses only the Python standard library. (The one optional dependency, brotli, is used if present and skipped if not.)
• Node 16+ only if you use the npx installer below. Claude itself runs the skills; you don't need Node to use them once installed.

Skill architecture

Every skill folder follows the standard Claude skill structure:

skill-name/
├── SKILL.md                     # YAML frontmatter (name, description) + workflow
├── references/
│   ├── audit-checks.md          # every check: definition, why it matters, fix
│   └── report-template.md       # the exact Markdown structure of the output
└── scripts/
    ├── fetch_pages.py                # shared: crawl once → page_cache.json (crawl skills)
    ├── extract_*.py / collect_*.py   # the extractor → inventory.json (reads --from-cache)
    ├── audit_*.py                    # the auditor → audit_report.json
    ├── md_to_docx.py                 # shared: render the report as a .docx
    └── findings_to_csv.py            # shared: flatten audit_report.json → findings.csv

All skills share one pipeline — fetch → extract → audit → report — and a four-level severity model (High / Medium / Low / Info). The page-based audits crawl the site once into a shared page_cache.json (via fetch_pages.py) and each extractor reads from it with --from-cache, so a full audit fetches once instead of crawling per area; each extractor also keeps a standalone mode (live URL, --local, --url-list). See docs/CONVENTIONS.md for the full design and a guide to adding your own skill.

Export reports to Word (.docx) or CSV

Every skill can hand back its report as a Word document, not just Markdown. Ask for "a Word doc", "a .docx", or "a shareable report" and the skill writes the report and converts it with its bundled scripts/md_to_docx.py:

python3 scripts/md_to_docx.py report.md --output report.docx

Like everything else here, the converter is standard-library only — a .docx is just a ZIP of OOXML, so no pip install is needed. It renders headings, tables, lists, links, bold/italic, and code blocks. The export happens after the report is written, so the .docx keeps the prioritized fixes and rewritten values Claude produced — it's the report reformatted, not a raw dump of the findings JSON.

When you want the data rather than the write-up — to filter, sort, or triage in Sheets or Excel — every skill also bundles scripts/findings_to_csv.py, which flattens the audit's audit_report.json into a CSV with one row per finding:

python3 scripts/findings_to_csv.py audit_report.json --output findings.csv

Also standard-library only. It prepends check and severity columns and joins list fields (like the pages sharing a duplicate value) with ; . This one is a direct dump of the structured findings, so it complements the .docx: the Word doc for stakeholders, the CSV for working the issue list.

Run everything at once

Available skills

Install

Install all skills into your global Claude skills directory (~/.claude/skills/):

npx claude-seo-skills install

Other options:

# Install only specific skills
npx claude-seo-skills install sitemap-audit robots-txt-audit

# Install into the current project's ./.claude/skills instead of the global dir
npx claude-seo-skills install --project

# Install into a custom directory, overwriting anything already there
npx claude-seo-skills install --dir ~/my-skills --force

# List available skills
npx claude-seo-skills list

Or install the CLI globally:

npm install -g claude-seo-skills
claude-seo-skills install

Manual usage

You can also copy a skill folder into your Claude skills directory (e.g., ~/.claude/skills/ for Claude Code) or upload it where skills are supported. Claude will invoke the skill automatically when a request matches its description.