20 SEO & GEO skills for Claude Code, Cursor, Codex, and 35+ AI agents. Keyword research, content writing, technical audits, rank tracking. CORE-EEAT + CITE frameworks.
npx skills add https://github.com/aaron-he-zhu/seo-geo-claude-skills --skill alert-managerقم بتثبيت هذه المهارة باستخدام واجهة سطر الأوامر (CLI) وابدأ في استخدام سير عمل SKILL.md في مساحة عملك.
20 skills. 15 commands. Rank in search. Get cited by AI.
English | 中文 | 日本語 | 한국어 | Espanol | Portugues
Claude Skills and Commands for Search Engine Optimization (SEO) and Generative Engine Optimization (GEO). Zero dependencies, works with Claude Code, Cursor, Codex, and 35+ other agents. Content quality scored by the CORE-EEAT Benchmark (80 items). Domain authority scored by CITE Domain Rating (40 items).
SEO gets you ranked in search results. GEO gets you cited by AI systems (ChatGPT, Perplexity, Google AI Overviews). This library covers both.
New to the terminology? See GLOSSARY.md.
Install — three most common paths (full table of 7 native + fallback at Installation):
/plugin marketplace add aaron-he-zhu/seo-geo-claude-skillsnpx skills add aaron-he-zhu/seo-geo-claude-skillsTry it immediately:
Research keywords for my SaaS product targeting small teams
A skill will auto-activate — no command needed.
Or use a direct command:
/seo:audit-page https://example.com/blog/my-article
For terminology, see GLOSSARY.md.
npx skillsWorks natively in Claude Code, OpenClaw, Gemini CLI, Qwen Code, Amp, Kimi Code CLI, CodeBuddy — plus 35+ more agents via
npx skills. No other dependencies.
Install — pick the command for your tool:
| Your tool | Install command |
|---|---|
| Claude Code | /plugin marketplace add aaron-he-zhu/seo-geo-claude-skills |
| OpenClaw | clawhub install aaron-he-zhu/<skill> · bundle |
| Gemini CLI | gemini extensions install https://github.com/aaron-he-zhu/seo-geo-claude-skills |
| Qwen Code | qwen extensions install https://github.com/aaron-he-zhu/seo-geo-claude-skills |
| Amp | amp skill add aaron-he-zhu/seo-geo-claude-skills |
| Kimi Code CLI | kimi plugin install https://github.com/aaron-he-zhu/seo-geo-claude-skills.git |
| CodeBuddy | in-app: /plugin marketplace add aaron-he-zhu/seo-geo-claude-skills then /plugin install aaron-seo-geo |
| Cursor / Codex / opencode / Windsurf / Cline / Copilot / 35+ more | npx skills add aaron-he-zhu/seo-geo-claude-skills |
All installation methods remain available at all times. If any marketplace is temporarily unavailable, use an alternative method.
Install a single skill via skills.sh:
npx skills add aaron-he-zhu/seo-geo-claude-skills -s keyword-research
Already listed in the table above. Use this method if you need to load locally:
# Or load locally
claude --plugin-dir ./seo-geo-claude-skills
Includes marketplace.json, plugin.json, and pre-configured MCP servers. See CONNECTORS.md for MCP setup.
Add as a submodule for version-pinned updates within an existing project:
git submodule add https://github.com/aaron-he-zhu/seo-geo-claude-skills.git .claude/skills/seo-geo
Update to the latest version:
git submodule update --remote .claude/skills/seo-geo
For teams wanting custom modifications:
git clone https://github.com/YOUR-ORG/seo-geo-claude-skills.git
npx skills add YOUR-ORG/seo-geo-claude-skills
git remote add upstream https://github.com/aaron-he-zhu/seo-geo-claude-skills.git
git fetch upstream && git merge upstream/main
git clone https://github.com/aaron-he-zhu/seo-geo-claude-skills.git
mkdir -p ~/.claude/skills/ && cp -r seo-geo-claude-skills/* ~/.claude/skills/
Use immediately — no tool integrations required:
Research keywords for [your topic] and identify high-value opportunities
Run a command for a one-shot task:
/seo:audit-page https://example.com/your-page
Optionally connect tools — edit CONNECTORS.md to map ~~placeholders to your toolstack (Ahrefs, SEMrush, Google Analytics, etc.)
Every skill in this repo now follows the same lightweight contract:
The four cross-cutting skills form the protocol layer:
content-quality-auditor = publish readiness gatedomain-authority-auditor = citation trust gateentity-optimizer = canonical entity profilememory-management = campaign memory loopShared references:
Prompt-based hooks run automatically during your session — no configuration needed:
Three-tier temperature model keeps project context across sessions:
Findings promote automatically when referenced frequently. Stale items archive after 90 days.
| Your Goal | Start Here | Then |
|---|---|---|
| Starting from scratch | keyword-research → competitor-analysis |
→ seo-content-writer |
| Write new content | keyword-research |
→ seo-content-writer + geo-content-optimizer |
| Improve existing content | /seo:audit-page <URL> |
→ content-refresher or seo-content-writer |
| Fix technical issues | /seo:check-technical <URL> |
→ technical-seo-checker |
| Assess domain authority | /seo:audit-domain <domain> |
→ backlink-analyzer |
| Full quality assessment | content-quality-auditor + domain-authority-auditor |
→ 120-item combined report |
| Build entity/brand presence | entity-optimizer |
→ schema-markup-generator + geo-content-optimizer |
| Generate performance report | /seo:report <domain> <period> |
→ periodic monitoring |
Skills are organized into four execution phases plus one protocol layer. Use them in order for new projects, or jump to any phase as needed.
RESEARCH BUILD OPTIMIZE MONITOR
───────── ───────── ───────── ─────────
Keywords Content On-Page Rankings
Competitors Meta Tags Technical Backlinks
SERP Schema Links Performance
Gaps GEO Refresh Alerts
CROSS-CUTTING / PROTOCOL LAYER ─────────────────────────────────
Content Quality Gate · Citation Trust Gate · Entity Truth · Memory Loop
| Skill | What it does |
|---|---|
| keyword-research | Discover keywords with intent analysis, difficulty scoring, and topic clustering |
| competitor-analysis | Analyze competitor SEO/GEO strategies and find their weaknesses |
| serp-analysis | Analyze search results and AI answer patterns for target queries |
| content-gap-analysis | Find content opportunities your competitors cover but you don't |
| Skill | What it does |
|---|---|
| seo-content-writer | Write search-optimized content with proper structure and keyword placement |
| geo-content-optimizer | Make content quotable and citable by AI systems |
| meta-tags-optimizer | Create compelling titles, descriptions, and Open Graph tags |
| schema-markup-generator | Generate JSON-LD structured data for rich results |
| Skill | What it does |
|---|---|
| on-page-seo-auditor | Audit on-page elements with a scored report and fix recommendations |
| technical-seo-checker | Check crawlability, indexing, Core Web Vitals, and site architecture |
| internal-linking-optimizer | Optimize internal link structure for better crawling and authority flow |
| content-refresher | Update outdated content to recover or improve rankings |
| Skill | What it does |
|---|---|
| rank-tracker | Track keyword positions over time in both SERP and AI responses |
| backlink-analyzer | Analyze backlink profile, find opportunities, detect toxic links |
| performance-reporter | Generate SEO/GEO performance reports for stakeholders |
| alert-manager | Set up alerts for ranking drops, traffic changes, and technical issues |
| Skill | What it does |
|---|---|
| content-quality-auditor | Publish Readiness Gate with full 80-item CORE-EEAT audit and ship/no-ship verdict |
| domain-authority-auditor | Citation Trust Gate with full 40-item CITE audit and authority verdict |
| entity-optimizer | Canonical Entity Profile for brand/entity truth across search and AI systems |
| memory-management | Campaign Memory Loop for durable context, promotion, and archive rules |
One-shot tasks with explicit input and structured output.
Day-to-day SEO/GEO work. Use these directly from any Claude Code, Cursor, or Codex session.
| Command | Description |
|---|---|
/seo:audit-page <URL> |
Full on-page SEO + CORE-EEAT content quality audit with scored report |
/seo:check-technical <URL> |
Technical SEO health check (crawlability, speed, security) |
/seo:generate-schema <type> |
Generate JSON-LD structured data markup |
/seo:optimize-meta <URL> |
Optimize title, description, and OG tags |
/seo:report <domain> <period> |
Comprehensive SEO/GEO performance report |
/seo:audit-domain <domain> |
Full CITE domain authority audit with 40-item scoring and veto checks |
/seo:write-content <topic> |
Write SEO + GEO optimized content from a topic and target keyword |
/seo:keyword-research <seed> |
Research and analyze keywords for a topic or niche |
/seo:setup-alert <metric> |
Configure monitoring alerts for critical metrics |
/seo:geo-drift-check [URL] |
(experimental, v9.0+) Validate predicted GEO Score against actual AI-engine citations |
For library maintainers / power users. Safe to ignore for daily use.
| Command | Description |
|---|---|
/seo:wiki-lint |
Wiki health check: detect contradictions, orphans, stale claims, missing pages |
/seo:contract-lint |
Auditor Runbook drift detection, handoff schema check, jargon leak scan (v7.1.0+) |
/seo:p2-review |
Evaluate v7.1.0 deferred items against trigger conditions; tombstone review (2026-07-10) |
/seo:sync-versions |
Propagate canonical version from .claude-plugin/plugin.json to all cross-agent manifests (v9.0+, replaces scripts/sync-versions.py) |
/seo:validate-library |
Library-level quality gate: description budgets, YAML field order, language coverage, duplicate triggers (v9.0+, replaces scripts/validate-descriptions.py) |
Command files: commands/
graph TD
A[New Content Project] --> B[Keyword Research]
B --> C[Competitor Analysis]
C --> D[Content Gap Analysis]
D --> E[Write SEO Content]
E --> F[GEO Optimization]
F --> G[Meta Tags + Schema]
G --> H[CORE-EEAT Quality Audit]
H --> H2[On-Page Audit]
H2 --> I[Publish]
I --> J[Track Rankings]
J --> K{Performance OK?}
K -->|Yes| L[Continue Monitoring]
K -->|No| M[Content Refresh]
M --> H
Skill combos that work well together:
When a skill points to its Next Best Skill, preserve this context for the next move:
| Context | How to Pass | Example |
|---|---|---|
| Objective | State what was analyzed, created, or fixed | "Objective: refreshed declining pricing page" |
| Key findings / output | Carry forward the highest-signal result | "Key output: GEO section rewrite + publish verdict = fix before ship" |
| Evidence | Include URLs, datasets, or sections reviewed | "Evidence: GSC last 90 days, page URL, competitor SERP snapshot" |
| Open loops | Note blockers, missing inputs, or unresolved risks | "Open loops: missing author bio and current customer proof" |
| Target keyword | Include in the skill invocation | "Run content-refresher for keyword 'cloud hosting'" |
| Content type | State explicitly | "Content type: how-to guide" |
| CORE-EEAT scores | Summarize dimension scores | "Current scores: C:75 O:60 R:80 E:45 — focus on Exclusivity" |
| CITE scores | Summarize dimension + veto status | "CITE: C:82 I:65 T:71 E:58, no veto triggers" |
| Priority items | List specific item IDs | "Priority: improve O08, E07, R06" |
| Content URL | Include for fetch-capable skills | "Analyze https://example.com/page" |
Memory-managed handoff: If memory-management is active, prior audit results are automatically available via the hot cache in CLAUDE.md. Skills should check for cached scores before re-running audits.
Shared references used by multiple skills:
| Reference | Items | Used by |
|---|---|---|
| core-eeat-benchmark.md | 80 | content-quality-auditor, seo-content-writer, geo-content-optimizer, content-refresher, on-page-seo-auditor |
| cite-domain-rating.md | 40 | domain-authority-auditor, backlink-analyzer, competitor-analysis, performance-reporter |
Most skills also include references/ subdirectories with skill-specific templates, rubrics, and checklists (e.g. http-status-codes, robots-txt, kpi-definitions, report-templates).
Not sure which skill to use? Here's a quick guide by goal:
Research — keyword-research (keywords, topics, search volume) | competitor-analysis (competitive intel, benchmarking) | serp-analysis (SERP features, AI overviews) | content-gap-analysis (missing topics, content opportunities)
Build — seo-content-writer (blog posts, articles, SEO copy) | geo-content-optimizer (AI citations, LLM optimization) | meta-tags-optimizer (titles, descriptions, OG tags) | schema-markup-generator (JSON-LD, rich snippets)
Optimize — on-page-seo-auditor (page audit, SEO score) | technical-seo-checker (speed, crawlability, Core Web Vitals) | internal-linking-optimizer (link structure, silos) | content-refresher (update old content, fix decay)
Monitor — rank-tracker (keyword positions, trends) | backlink-analyzer (link profile, toxic links) | performance-reporter (SEO/GEO reports) | alert-manager (ranking drops, traffic alerts)
Protocol — content-quality-auditor (80-item CORE-EEAT) | domain-authority-auditor (40-item CITE) | entity-optimizer (knowledge graph, brand entity) | memory-management (campaign memory, project context)
| You're looking for... | Use this skill |
|---|---|
| Find keywords / topic ideas / what to write about | keyword-research |
| Search volume / long-tail keywords / ranking opportunities | keyword-research |
| Analyze competitors / competitive intelligence / who ranks for X | competitor-analysis |
| Competitor keywords / competitor backlinks / benchmarking | competitor-analysis |
| SERP analysis / what ranks for X / featured snippets | serp-analysis |
| AI overviews / SERP features / why does this page rank | serp-analysis |
| Content gaps / what am I missing / untapped topics | content-gap-analysis |
| Competitor content analysis / content opportunities / content strategy gaps | content-gap-analysis |
| Write a blog post / article writing / content creation | seo-content-writer |
| SEO copywriting / draft optimized content / write for SEO | seo-content-writer |
| Optimize for AI / get cited by ChatGPT / AI optimization | geo-content-optimizer |
| GEO optimization / appear in AI answers / LLM citations | geo-content-optimizer |
| Title tag / meta description / improve CTR | meta-tags-optimizer |
| Open Graph / Twitter cards / social media preview | meta-tags-optimizer |
| Schema markup / structured data / JSON-LD / rich snippets | schema-markup-generator |
| FAQ schema / How-To schema / product markup | schema-markup-generator |
| On-page SEO audit / SEO score / page optimization | on-page-seo-auditor |
| Header tags / image optimization / check my page | on-page-seo-auditor |
| Technical SEO / page speed / Core Web Vitals | technical-seo-checker |
| Crawl issues / indexing problems / mobile-friendly check | technical-seo-checker |
| Internal links / site architecture / link structure | internal-linking-optimizer |
| Page authority distribution / content silos / site navigation | internal-linking-optimizer |
| Update old content / refresh content / content decay | content-refresher |
| Declining rankings / revive old blog posts / outdated content | content-refresher |
| Track rankings / keyword positions / how am I ranking | rank-tracker |
| SERP monitoring / ranking trends / position tracking | rank-tracker |
| Analyze backlinks / link profile / toxic links | backlink-analyzer |
| Link building / off-page SEO / link authority | backlink-analyzer |
| SEO report / performance report / traffic report | performance-reporter |
| SEO dashboard / report to stakeholders / monthly report | performance-reporter |
| SEO alerts / monitor rankings / ranking notifications | alert-manager |
| Traffic alerts / watch competitor changes / alert me | alert-manager |
| Content quality audit / EEAT score / how good is my content | content-quality-auditor |
| CORE-EEAT audit / content assessment / quality score | content-quality-auditor |
| Domain authority audit / domain trust / site credibility | domain-authority-auditor |
| CITE audit / domain rating / how authoritative is my site | domain-authority-auditor |
| Entity optimization / knowledge graph / knowledge panel | entity-optimizer |
| Brand entity / entity disambiguation / Wikidata | entity-optimizer |
| Remember project context / save SEO data / track campaign | memory-management |
| Store keyword data / save progress / project memory | memory-management |
Browse all 20 skills: GitHub · ClawHub · skills.sh
For the full install table (7 native agents + universal fallback + submodule/fork/manual), see Installation above. A few less-common commands:
# Single skill via ClawHub
clawhub install aaron-he-zhu/keyword-research
# Preview available skills (skills.sh)
npx skills add aaron-he-zhu/seo-geo-claude-skills --list
# Global install for all agents (skills.sh)
npx skills add aaron-he-zhu/seo-geo-claude-skills -g -y --all
See CONTRIBUTING.md for how to add new skills, improve existing ones, or request features.
| Repository | What it provides | How it connects |
|---|---|---|
| CORE-EEAT Content Benchmark | 80-item content quality scoring framework | Powers content-quality-auditor and publish readiness gate |
| CITE Domain Rating | 40-item domain authority scoring framework | Powers domain-authority-auditor and citation trust gate |
These skills assist with SEO and GEO workflows but do not guarantee search rankings, AI citations, or traffic results. SEO and GEO outcomes depend on many factors outside the scope of this tool. Always verify recommendations with qualified professionals before making significant changes to your content strategy. AI-generated analysis should be reviewed by domain experts before being relied upon for business decisions.
Not legal advice. Several skills and references (SECURITY.md scraping boundaries, CORE-EEAT T04 FTC disclosure, memory-management GDPR provisions, scoring-rubric.md WCAG/ADA section, llm-crawler-handling.md EU AI Act) cite statutes, case law, and regulator guidance current as of release date. Laws, penalty figures, and judicial interpretations evolve; jurisdictional coverage varies. Consult qualified legal counsel before relying on any legal summary in this repository for compliance decisions.
Apache License 2.0