Claude-skills
CLAUDE.md0 starsChanged 5 months agoMITView on GitHub
This repository contains Claude SEO, a Tier 4 Claude Code skill for comprehensive SEO analysis across all industries. It follows the Agent Skills open standard and the 3-layer architecture (directive, orchestration, execution). 26 sub-skills (21 core + 1 orchestrator + 1 framework integration + 2 extension mirrors + 1 security), 18 sub-agents (15 core + 1 framework integration + 2 extension mirrors), and an extensible reference system cover technical SEO, content quality, schema markup, image optimization, sitemap architecture, AI search…
- Pipes a download into a shell
- Reads credentials
- Commits and pushes
In this repository73 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ab-testingSkill
- ad-creativeSkill
- adsSkill
- ai-seoSkill
- analyticsSkill
- asoSkill
- churn-preventionSkill
- cold-emailSkill
- co-marketingSkill
- community-marketingSkill
- competitor-profilingSkill
- competitorsSkill
- content-strategySkill
- copy-editingSkill
- copywritingSkill
- croSkill
- customer-researchSkill
- directory-submissionsSkill
- emailsSkill
- free-toolsSkill
- imageSkill
- launchSkill
- lead-magnetsSkill
- marketing-ideasSkill
- marketing-loopsSkill
- marketing-planSkill
- marketing-psychologySkill
- offersSkill
- onboardingSkill
- paywallsSkill
- popupsSkill
- pricingSkill
- product-marketingSkill
- programmatic-seoSkill
- prospectingSkill
- public-relationsSkill
- referralsSkill
- revopsSkill
- sales-enablementSkill
- schemaSkill
- seo-auditSkill
- signupSkill
- site-architectureSkill
- smsSkill
- socialSkill
- videoSkill
- cyber-neoSkill
- seo-auditSkill
- seo-backlinksSkill
- seo-clusterSkill
- seo-competitor-pagesSkill
- seo-content-briefSkill
- seo-contentSkill
- seo-dataforseoSkill
- seo-driftSkill
- seo-ecommerceSkill
- seo-flowSkill
- seo-geoSkill
- seo-googleSkill
- The first 60 shown.
The file
We split this CLAUDE.md into the rules it gives an agent
11 rules. About 0 are common, 2 are distinctive, and 9 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
9
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Very specific: line 181
Keep SKILL.md files under 500 lines / 5000 tokens
- Distinctive: line 184
Follow kebab-case naming for all skill directories
- Very specific: line 187
Test with python3 -m pytest tests/ after changes (if applicable)
- Very specific: line 192
URL validation: All scripts that accept user URLs must call validate_url() from google_auth.py before making API calls.
- Very specific: line 193
OAuth tokens: Never store client_secret in the token file.
- Very specific: line 194
No hardcoded paths: Use os.path.dirname(os.path.abspath(__file__)) for relative paths, never /home/username/...
- Very specific: line 208
Before presenting any PDF to the user: verify the review passes ("status": "PASS")
- Very specific: line 209
Cross-skill enforcement: After completing ANY analysis command (audit, page, technical, content, schema, geo, local, maps), offer: …
- Very specific: line 260
aimhaccepts day-to-day pushes: No release-gate ceremony required for the private remote. - Distinctive: line 265
History stays shared: Never rewrite history on either remote with force-push unless explicitly authorized for that specific operation.
- Very specific: line 283
After cutting a new release (git tag + gh release create), run:
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Claude SEO: Universal SEO Analysis Skill
Project Overview
This repository contains Claude SEO, a Tier 4 Claude Code skill for comprehensive SEO analysis across all industries. It follows the Agent Skills open standard and the 3-layer architecture (directive, orchestration, execution). 26 sub-skills (21 core + 1 orchestrator + 1 framework integration + 2 extension mirrors + 1 security), 18 sub-agents (15 core + 1 framework integration + 2 extension mirrors), and an extensible reference system cover technical SEO, content quality, schema markup, image optimization, sitemap architecture, AI search optimization, local SEO (GBP, citations, reviews, map pack), maps intelligence, semantic topic clustering, search experience optimization (SXO), SEO drift monitoring, e-commerce SEO, and international SEO with cultural adaptation profiles.
Architecture
claude-seo/
CLAUDE.md # Project instructions (this file)
CONTRIBUTORS.md # Community credits (Pro Hub Challenge)
AGENTS.md # Multi-platform agent instructions (Cursor, Antigravity)
.claude-plugin/
plugin.json # Plugin manifest (v2.2.0)
marketplace.json # Marketplace catalog for distribution
skills/ # 26 sub-skills (auto-discovered)
seo/ # Main orchestrator skill
SKILL.md # Entry point, routing table, core rules
references/ # On-demand knowledge files (12 files)
seo-audit/SKILL.md # Full site audit with parallel agents
seo-page/SKILL.md # Deep single-page analysis
seo-technical/SKILL.md # Technical SEO (9 categories)
seo-content/SKILL.md # E-E-A-T and content quality
seo-schema/SKILL.md # Schema.org markup detection/generation
seo-sitemap/SKILL.md # XML sitemap analysis/generation
seo-images/SKILL.md # Image optimization analysis
seo-geo/SKILL.md # AI search / GEO optimization
seo-local/SKILL.md # Local SEO (GBP, citations, reviews, map pack)
seo-maps/SKILL.md # Maps intelligence (geo-grid, GBP audit, reviews, competitors)
seo-plan/SKILL.md # Strategic SEO planning
seo-programmatic/SKILL.md # Programmatic SEO at scale
seo-competitor-pages/SKILL.md # Competitor comparison pages
seo-hreflang/SKILL.md # International SEO / hreflang
seo-google/ # Google SEO APIs
SKILL.md
references/ # API reference files (10 files)
seo-backlinks/SKILL.md # Backlink profile analysis
seo-cluster/ # Semantic topic clustering (v1.9.0, by Lutfiya Miller)
SKILL.md
references/ # Clustering methodology, architecture, workflow
templates/ # cluster-map.html interactive visualization
seo-sxo/ # Search Experience Optimization (v1.9.0, by Florian Schmitz)
SKILL.md
references/ # Page-type taxonomy, user stories, personas, wireframes
seo-drift/ # SEO drift monitoring (v1.9.0, by Dan Colta)
SKILL.md
references/ # Comparison rules (17 rules, 3 severity levels)
seo-ecommerce/ # E-commerce SEO (v1.9.0, by Matej Marjanovic)
SKILL.md
references/ # Marketplace API endpoints
seo-dataforseo/SKILL.md # Live SEO data via DataForSEO MCP (extension mirror)
seo-image-gen/ # AI image generation for SEO assets (extension mirror)
SKILL.md
references/ # Image gen reference files (7 files)
agents/ # 18 subagents (auto-discovered)
seo-technical.md # Crawlability, indexability, security
seo-content.md # E-E-A-T, readability, thin content
seo-schema.md # Structured data validation
seo-sitemap.md # Sitemap quality gates
seo-performance.md # Core Web Vitals, page speed
seo-visual.md # Screenshots, mobile rendering
seo-geo.md # AI crawler access, GEO, citability
seo-local.md # GBP, NAP, citations, reviews, local schema
seo-maps.md # Geo-grid, GBP audit, reviews, competitor radius
seo-google.md # Google API analyst (CrUX, GSC, GA4)
seo-backlinks.md # Backlink profile analyst (Moz, Bing, CC, verify)
seo-dataforseo.md # DataForSEO data analyst
seo-image-gen.md # SEO image audit analyst
seo-cluster.md # Semantic clustering analysis
seo-sxo.md # Search experience optimization
seo-drift.md # SEO drift monitoring
seo-ecommerce.md # E-commerce SEO analysis
hooks/ # Quality gate hooks
hooks.json # PostToolUse schema validation
scripts/ # Python execution scripts (50 tracked + dev-only helpers)
google_auth.py # Credential management (OAuth, SA, API key, 4-tier detection)
backlinks_auth.py # Backlink API credential management (Moz, Bing)
moz_api.py # Moz Link Explorer API (DA/PA, spam, domains, anchors)
bing_webmaster.py # Bing Webmaster Tools API (links, competitor comparison)
commoncrawl_graph.py # Common Crawl web graph parser (PageRank, in-degree)
verify_backlinks.py # Backlink existence verification crawler
pagespeed_check.py # PSI v5 + CrUX API
crux_history.py # CrUX History API (25-week trends)
gsc_query.py # Search Console (queries, pages, sitemaps, sites)
gsc_inspect.py # URL Inspection (single + batch)
indexing_notify.py # Indexing API v3 (URL_UPDATED/URL_DELETED)
ga4_report.py # GA4 organic traffic reports
google_report.py # PDF/HTML report generator (WeasyPrint + matplotlib)
youtube_search.py # YouTube Data API v3
nlp_analyze.py # Cloud Natural Language API
keyword_planner.py # Google Ads Keyword Planner
fetch_page.py # Page fetcher with UA rotation
parse_html.py # HTML parser for SEO elements
capture_screenshot.py # Playwright screenshots
analyze_visual.py # Visual analysis helper
drift_baseline.py # SEO drift baseline capture (SQLite)
drift_compare.py # SEO drift comparison engine (17 rules)
drift_report.py # SEO drift HTML report generator
drift_history.py # SEO drift history query
dataforseo_costs.py # DataForSEO cost estimation and budget tracking
dataforseo_merchant.py # Google Shopping / Amazon data fetching
dataforseo_normalize.py # DataForSEO response normalization utility
sync_flow.py # FLOW prompt library sync (GitHub API, CC BY 4.0 headers, --dry-run, --ref)
url_safety.py # Canonical URL/SSRF safety module (validate, DNS-pin, safe fetch)
render_page.py # Shared headless renderer (SPA-aware, Playwright)
lcp_subparts.py # LCP subparts breakdown via CrUX API
preload_check.py # Speculation Rules / bfcache / prerender / preload detector
agent_ux_check.py # Agent-friendly page auditor
content_quality.py # QRG-aligned content quality detector
content_humanize.py # AI-pattern remover (rewrites AI-typical phrasing)
content_verify.py # Claim extractor + citation-gap detector
schema_generate.py # JSON-LD generators for high-leverage v2 schema types
schema_ecommerce_validate.py # Product schema validator (merchant-listing requirements)
iptc_ai_label.py # IPTC DigitalSourceType audit/injection for AI imagery
parasite_risk.py # Parasite-SEO risk scanner
gbp_deprecation_lint.py # GBP feature-deprecation linter
domain_history.py # Expired-domain heritage check
seo_updates.py # Primary-source Google updates query tool
indexnow_submit.py # IndexNow submitter
ucp_check.py # UCP (Universal Commerce Protocol) profile auditor
unlighthouse_run.py # Unlighthouse CLI wrapper (site-wide Lighthouse)
validate_backlink_report.py # Backlink report validation
portability_check.py # Cross-platform portability lint for SKILL.md files
release_sign.py # SHA-256 manifest generator for release signing
verify_release.py # Verify checkout integrity against a release manifest
mobile_analysis.py # Mobile rendering analysis (gitignored, dev-only)
schema/ # Schema.org JSON-LD templates
extensions/ # Optional add-on install helpers
dataforseo/ # DataForSEO MCP install scripts
firecrawl/ # Firecrawl MCP install scripts
banana/ # Banana MCP install scripts
docs/ # Extended documentationCommands
| Command | Purpose |
/seo audit <url> | Full site audit with up to 15 parallel subagents |
/seo page <url> | Deep single-page analysis |
/seo technical <url> | Technical SEO audit (9 categories) |
/seo content <url> | E-E-A-T and content quality analysis |
/seo content-brief <topic> | Detailed SEO content brief: keywords, outline, internal links |
/seo schema <url> | Schema.org detection, validation, generation |
/seo sitemap <url> | XML sitemap analysis or generation |
/seo images <url or optimize> | Image SEO: on-page audit, SERP analysis, file optimization |
/seo geo <url> | AI search / Generative Engine Optimization |
/seo plan <type> | Strategic SEO planning by industry |
/seo programmatic | Programmatic SEO analysis and planning |
/seo competitor-pages | 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> | International SEO / hreflang audit |
/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 backlinks setup | Setup instructions for free backlink APIs |
/seo backlinks verify <url> | Verify known backlinks still exist |
/seo cluster <seed-keyword> | SERP-based semantic clustering and content architecture |
/seo sxo <url> | Search Experience Optimization: page-type analysis, personas |
/seo drift baseline <url> | Capture SEO baseline for change monitoring |
/seo drift compare <url> | Compare current state to stored baseline |
/seo drift history <url> | Show drift history over time |
/seo ecommerce <url> | E-commerce SEO: product schema, marketplace intelligence |
/seo flow <url> | Apply the FLOW framework: stage prompts and structured search-and-conversion output |
/seo firecrawl [command] <url> | Full-site crawling and site mapping (extension) |
/seo dataforseo [command] | Live SEO data via DataForSEO MCP (extension) |
/seo image-gen [use-case] <desc> | AI image generation for SEO assets (extension) |
Development Rules
- Keep SKILL.md files under 500 lines / 5000 tokens
- Reference files should be focused and under 200 lines
- Scripts must have docstrings, CLI interface, and JSON output
- Follow kebab-case naming for all skill directories
- Agents invoked via Agent tool, never via Bash
- Python dependencies install into
~/.claude/skills/seo/.venv/ - Test with
python3 -m pytest tests/after changes (if applicable)
Security Rules
- Never commit credentials:
.env,client_secret*.json,oauth-token.json,service_account*.jsonare all in.gitignore - URL validation: All scripts that accept user URLs must call
validate_url()fromgoogle_auth.pybefore making API calls. This blocks private IPs, loopback, and GCP metadata endpoints (SSRF protection). - OAuth tokens: Never store
client_secretin the token file. Read it from the client_secret.json file at runtime. - No hardcoded paths: Use
os.path.dirname(os.path.abspath(__file__))for relative paths, never/home/username/... - Config location:
~/.config/claude-seo/google-api.jsonand~/.config/claude-seo/backlinks-api.json(user-space, not in repo)
Report Generation Rules
- All SEO reports must use
scripts/google_report.pyas the canonical report generator - Dependencies:
matplotlib>=3.8.0(charts) +weasyprint>=61.0(HTML-to-PDF), both inrequirements.txt - Format: A4 PDF via WeasyPrint + matplotlib charts at 200 DPI
- Style: Clean white title page with navy (#1e3a5f) accent, Times New Roman body font
- Color palette: Navy #1e3a5f (headers), dark gold #b8860b (accents), forest green #2d6a4f (pass), warm amber #d4740e (warnings), deep red #c53030 (fail), warm cream #faf9f7 (backgrounds)
- Structure: Title page → TOC with scores → Executive Summary → Data sections → Recommendations → Methodology
- Charts: 85% width, max-height 120mm, figure captions on every chart, saved to
charts/at 200 DPI - No
page-break-inside: avoidon any element (causes white gaps in WeasyPrint) - Post-generation review:
_review_pdf()runs automatically, checking for empty images, thin sections, duplicates - Before presenting any PDF to the user: verify the review passes (
"status": "PASS") - Cross-skill enforcement: After completing ANY analysis command (audit, page, technical, content, schema, geo, local, maps), offer: "Generate a PDF report? Use
/seo google report" - Google logo appears on title page when using Google API data ("Powered by Google APIs")
Ecosystem
Part of the Claude Code skill family:
- Claude Banana -- standalone image gen (bundled as extension here)
- Claude Blog -- companion blog engine, consumes SEO findings
- AI Marketing Claude -- community marketing suite (copy, emails, ads, funnels, CRO)
Key Principles
- Progressive Disclosure: Metadata always loaded, instructions on activation, resources on demand
- Industry Detection: Auto-detect SaaS, e-commerce, local, publisher, agency
- Parallel Execution: Full audits spawn up to 15 subagents simultaneously
- Extension System: DataForSEO MCP for live data, Firecrawl MCP for site crawling, Banana MCP for AI image generation
Repository Topology (public + private)
This project is mirrored across two GitHub remotes that share git history. Both originate from the same local checkout; neither is a GitHub fork of the other (different orgs, no parent/child relationship in the GitHub UI).
| Remote | URL | Visibility | Role |
origin | https://github.com/AgriciDaniel/claude-seo | Public | Published distribution. Users discover, clone, and install from here. main only reflects released history. |
aimh | https://github.com/AI-Marketing-Hub/claude-seo | Private | Working repo inside the AI Marketing Hub org. Daily development. v2 branch + post-release work lives here before promotion to public. |
Workflow
Daily development:
- Work on
v2(or feature branches offv2) locally. git push aimh <branch>to publish work-in-progress to the private repo (Dependabot, Actions, and CI run there).
Promoting to public on release:
- Merge
v2into localmainwhen ready to release (fast-forward). - Tag the release locally (
git tag -a vX.Y.Z). - Push the tag and main to both remotes in this order:
- First:
git push aimh main && git push aimh vX.Y.Z - Then:
git push origin main && git push origin vX.Y.Z - The "tag before merge" sequence (see
feedback_push_cautionmemory) applies onoriginto avoid thecurl|bashoutage window where users pull a tag that doesn't yet point at code onmain.
- First:
gh release create vX.Y.Z --repo AgriciDaniel/claude-seo(public-only)./release-blogto publish the release post.
Safety rules
- Never push to
origin/mainautonomously. The public is release-only; pushes are user-authorized per-release. aimhaccepts day-to-day pushes. No release-gate ceremony required for the private remote.- Tags push to private first. v2.0.0 is the current example: tag lives
on
aimh(private) but not yet onorigin(public) — that's intentional until release. - History stays shared. Never rewrite history on either remote with force-push unless explicitly authorized for that specific operation.
Verifying the topology
# Both remotes configured
git remote -v # expects: origin (public) + aimh (private)
# Both share main HEAD
git ls-remote --heads aimh main
git ls-remote --heads origin main # origin = aimh/main + 1 public-branding commit (intentional; see docs/WORKFLOW-public-private.md)Full workflow reference: docs/WORKFLOW-public-private.md.
Release Blog Post
After cutting a new release (git tag + gh release create), run:
/release-blogThis generates a blog post on https://claude-seo.md/blog/, handles cover image generation, SEO metadata, FAQ schema, internal linking, sitemap/llms.txt updates, Vercel deployment, and Google indexing.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

