internal-linking-optimizer

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.

インストール
CLI
npx skills add https://github.com/aaron-he-zhu/seo-geo-claude-skills --skill internal-linking-optimizer

CLI を使用してこのスキルをインストールし、ワークスペースで SKILL.md ワークフローの使用を開始します。

最終更新日: 4/22/2026

SEO & GEO Skills Library

20 skills. 15 commands. Rank in search. Get cited by AI.

GitHub Stars
Version
License
Last Commit
Claude Code

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.

Quick Start in 60 seconds

  1. Install — three most common paths (full table of 7 native + fallback at Installation):

    • Claude Code: /plugin marketplace add aaron-he-zhu/seo-geo-claude-skills
    • OpenClaw: clawhub.ai/plugins/aaron-seo-geo
    • Universal (any agent): npx skills add aaron-he-zhu/seo-geo-claude-skills
  2. Try it immediately:

    Research keywords for my SaaS product targeting small teams
    

    A skill will auto-activate — no command needed.

  3. Or use a direct command:

    /seo:audit-page https://example.com/blog/my-article
    

For terminology, see GLOSSARY.md.

Why This Library

  • 120-item quality frameworks — CORE-EEAT (80 items) + CITE (40 items) with veto gates, not narrative guesswork
  • 8 languages, 750+ triggers — EN, ZH, JA, KO, ES, PT with formal, casual, and misspelling variants
  • Zero dependencies — pure markdown skills, no Python, no venv, no API keys required
  • Tool-agnostic — works standalone or with 14 MCP servers (Ahrefs, Semrush, Cloudflare, and more)
  • Native install in 7 agents — Claude Code, OpenClaw, Gemini CLI, Qwen Code, Amp, Kimi, CodeBuddy — plus 35+ more via npx skills

Installation

Works natively in Claude Code, OpenClaw, Gemini CLI, Qwen Code, Amp, Kimi Code CLI, CodeBuddy — plus 35+ more agents via npx skills. No other dependencies.

  1. 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
    
    Claude Code Plugin (alternative)

    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.

    Git Submodule (version-pinned)

    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
    
    Fork & Customize

    For teams wanting custom modifications:

    1. Fork this repository on GitHub
    2. Clone your fork:
      git clone https://github.com/YOUR-ORG/seo-geo-claude-skills.git
      
    3. Customize skills, add internal connectors, or adjust scoring weights
    4. Install from your fork:
      npx skills add YOUR-ORG/seo-geo-claude-skills
      
    5. Pull upstream updates:
      git remote add upstream https://github.com/aaron-he-zhu/seo-geo-claude-skills.git
      git fetch upstream && git merge upstream/main
      
    Manual install (without CLI)
    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/
    
  2. Use immediately — no tool integrations required:

    Research keywords for [your topic] and identify high-value opportunities
    
  3. Run a command for a one-shot task:

    /seo:audit-page https://example.com/your-page
    
  4. Optionally connect tools — edit CONNECTORS.md to map ~~placeholders to your toolstack (Ahrefs, SEMrush, Google Analytics, etc.)

Operating Model

Every skill in this repo now follows the same lightweight contract:

  • Trigger: when this skill must be the next move
  • Quick Start: shortest successful invocation
  • Skill Contract: what the skill reads, writes, and promotes
  • Handoff: reusable summary for later skills or later sessions
  • Next Best Skill: one primary follow-up, not a long menu

The four cross-cutting skills form the protocol layer:

  • content-quality-auditor = publish readiness gate
  • domain-authority-auditor = citation trust gate
  • entity-optimizer = canonical entity profile
  • memory-management = campaign memory loop

Shared references:

Automation

Prompt-based hooks run automatically during your session — no configuration needed:

  • Session start: loads your project memory and reminds you of open items
  • After writing content: recommends a quality audit before publishing
  • Session end: offers to save findings for next time

Memory

Three-tier temperature model keeps project context across sessions:

  • HOT (80 lines, auto-loaded): goals, hero keywords, active veto items
  • WARM (on-demand): audit summaries, research findings, content plans
  • COLD (archive): historical data, queried only when needed

Findings promote automatically when referenced frequently. Stale items archive after 90 days.

Where to Begin

Your Goal Start Here Then
Starting from scratch keyword-researchcompetitor-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

Methodology

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

Skills

Research — understand your market before creating content

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

Build — create content optimized for search and AI

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

Optimize — improve existing content and technical health

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

Monitor — track performance and catch issues early

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

Cross-cutting — protocol layer across all phases

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

Commands

One-shot tasks with explicit input and structured output.

User commands (10)

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

Maintenance commands (5)

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:

  • keyword-research + content-gap-analysis → comprehensive content strategy
  • seo-content-writer + geo-content-optimizer → dual-optimized content
  • on-page-seo-auditor + technical-seo-checker → complete site audit
  • rank-tracker + alert-manager → proactive monitoring
  • content-quality-auditor + content-refresher → data-driven content refresh
  • content-quality-auditor + domain-authority-auditor → complete 120-item assessment
  • domain-authority-auditor + backlink-analyzer → domain authority deep-dive
  • entity-optimizer + schema-markup-generator → complete entity markup
  • memory-management + any skill → persistent project context

Inter-Skill Handoff Protocol

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.

Reference Materials

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).

Finding the Right Skill

Not sure which skill to use? Here's a quick guide by goal:

Researchkeyword-research (keywords, topics, search volume) | competitor-analysis (competitive intel, benchmarking) | serp-analysis (SERP features, AI overviews) | content-gap-analysis (missing topics, content opportunities)

Buildseo-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)

Optimizeon-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)

Monitorrank-tracker (keyword positions, trends) | backlink-analyzer (link profile, toxic links) | performance-reporter (SEO/GEO reports) | alert-manager (ranking drops, traffic alerts)

Protocolcontent-quality-auditor (80-item CORE-EEAT) | domain-authority-auditor (40-item CITE) | entity-optimizer (knowledge graph, brand entity) | memory-management (campaign memory, project context)

Full use-case search index (40 entries)
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 & advanced install

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

Contributing

See CONTRIBUTING.md for how to add new skills, improve existing ones, or request features.

Ecosystem

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

Community

Disclaimer

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.

License

Apache License 2.0