Agent skill

SEO

Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments…

AGPL-3.0Auto-check passedMarketing & SEO

Install SEO

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo .claude/skills/seo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .claude/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/yaojingang/GEOHub/tree/main/skills/seo

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/seo .agents/skills/seo && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .agents/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/seo .cursor/skills/seo && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .cursor/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/yaojingang/GEOHub.git --path skills/seo

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/seo .gemini/skills/seo && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .gemini/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/seo .github/skills/seo && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .github/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add yaojingang/GEOHub --skill seo -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install yaojingang/GEOHub seo --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/seo .opencode/skills/seo && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "seo" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/seo into .opencode/skills/seo/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "seo", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: seo
GitHub stars: 165
Token cost: ~421 tokens
SKILL.md length: 152 words
Files: 12 (incl. scripts, references)
Skills in repo: 9
Repo updated: Aug 31, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments…

Works in 5 steps: Read references/seo-method.md and… → Run python3 scripts/run_seo.py --input… → Use the selected work mode and action… → …
一句话SEO、技术SEO、自然搜索、收录诊断、关键词页面映射 and website SEO
SKILL.md covers Workflow, Output contract and Boundaries
Runs Python scripts from its folder; calls python3 and python

What it does

SEO is an agent skill from yaojingang/GEOHub. Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments, international or ecommerce SEO, and AI-search foundations. Use for 一句话SEO、技术SEO、自然搜索、收录诊断、关键词页面映射 and website SEO. Exclude paid search, ASO, ranking guarantees, link spam, live mutation without authorization, and unsupported metrics.

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `agents/interface.yaml`, `evals/semantic_config.json` and `evals/trigger_cases.json`).

It sits in Marketing & SEO, covering AI search optimization, Technical SEO and E-commerce operations. It works with Google Search Console and Python. The repository describes itself as: GEOHub: open, evidence-bounded GEO and SEO agent skills for AI Search, with research-grounded discovery, diagnosis, content, measurement, and one-line SEO planning. The licence is AGPL-3.0.

When your agent uses it

一句话SEO、技术SEO、自然搜索、收录诊断、关键词页面映射 and website SEO
Tasks that involve AI search optimization
Tasks that involve Technical SEO

Example prompts

“/seo”

Requirements

Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Read references/seo-method.md and normalize the request into references/input-example.json shape.
Run python3 scripts/run_seo.py --input --output or python -m geo_seo_hub seo --input --output .
Use the selected work mode and action plan to collect the named evidence. Preserve the coverage ledger and rerun inputs.
State observations, inference, hypotheses, and missing evidence separately. The deterministic planner keeps findings empty; later analysis…
Keep audit and planning read-only. Implement only when the user explicitly authorizes the target, change, verification, and rollback…

What it can do on your machine

Read from SKILL.md and the folder at commit 2210f7f. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
- python3
- python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO loads about 421 tokens when it runs, and up to ~974 if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 152 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~108
When it runs · the whole SKILL.md, loaded when a task matches: ~421
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~974

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from yaojingang/GEOHub at commit 2210f7f, republished under its AGPL-3.0 licence (© yaojingang). 152 words, ~421 tokens.

Download SKILL.mdSave it as .claude/skills/seo/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.

name: seo
description: Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments, international or ecommerce SEO, and AI-search foundations. Use for 一句话SEO、技术SEO、自然搜索、收录诊断、关键词页面映射 and website SEO. Exclude paid search, ASO, ranking guarantees, link spam, live mutation without authorization, and unsupported metrics.

GEOHub — One-line SEO

Workflow

Read references/seo-method.md and normalize the request into references/input-example.json shape.
Run python3 scripts/run_seo.py --input <brief.json> --output <runs-root> or python -m geo_seo_hub seo --input <brief.json> --output <runs-root>.
Use the selected work mode and action plan to collect the named evidence. Preserve the coverage ledger and rerun inputs.
State observations, inference, hypotheses, and missing evidence separately. The deterministic planner keeps findings empty; later analysis needs a separately validated evidence-backed contract.
Keep audit and planning read-only. Implement only when the user explicitly authorizes the target, change, verification, and rollback boundary.

Output contract

Return the normalized brief, seo-plan.json, a Markdown report, evidence ledger, quality report, and run manifest under one Artifact Bus run.

Boundaries

Never invent search volume, difficulty, rankings, traffic, backlinks, crawl, index, competitor, conversion, or citation metrics. Keep provider and surface rules separate. Crawling, indexing, ranking, rich results, traffic, revenue, and AI citations remain unguaranteed outcomes.

Files

SKILL.md and 11 other files (scripts, references) in skills/seo of yaojingang/GEOHub.

SKILL.md
agents/interface.yaml
evals/output/cases.jsonl
evals/semantic_config.json
evals/trigger_cases.json
manifest.json
references/input-example.json
references/seo-method.md
reports/output_quality_scorecard.md
reports/skill-ir.json
reports/trust-report.md
scripts/run_seo.py

Open the folder on GitHubat commit 2210f7f

Compare with similar skills

SEO next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
SEO this skillyaojingang/GEOHub	165	—	~421	Automated safety check: Pass	AGPL-3.0	1 mo ago
Qiaomu SEOjoeseesun/qiaomu-seo	441	—	~2.6k	Automated safety check: Pass	MIT	2 mo ago
Universal SEO AnalysisAgriciDaniel/claude-seo	19k	—	~4.9k	Automated safety check: Pass	MIT	4 days ago
GEO Schema Auditorzubair-trabzada/geo-seo-claude	11k	2 repos	~3.7k	Automated safety check: Notes	MIT	today
SEOAgriciDaniel/codex-seo	797	—	~3.7k	Automated safety check: Pass	MIT	27 days ago
Site Launch Checklistsamber/cc-skills	228	—	~13k	Automated safety check: Notes	MIT	8 days ago

Similar skills

Qiaomu SEO
joeseesun/qiaomu-seo
Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.
441 GitHub stars~2.6k tokensUpdated 2 mo ago
Marketing & SEOAuto-check passed
Universal SEO Analysis
AgriciDaniel/claude-seo
Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.
19k GitHub stars~4.9k tokensUpdated 4 days ago
Marketing & SEOAuto-check passed
GEO Schema Auditor
zubair-trabzada/geo-seo-claude
Audits a page's Schema.org structured data for AI discoverability, validates it, generates JSON-LD to fill gaps and writes a GEO-SCHEMA-REPORT.md.
11k GitHub starsUsed in 2 repos~3.7k tokens
Marketing & SEOAuto-check: notes
SEO
AgriciDaniel/codex-seo
Comprehensive SEO analysis for any website, page, business, or topic.
797 GitHub stars~3.7k tokensUpdated 27 days ago
Marketing & SEOAuto-check passed
Site Launch Checklist
samber/cc-skills
Pre-launch checklist for shipping a new website or web app. An agent skill from samber/cc-skills.
228 GitHub stars~13k tokensUpdated 8 days ago
Marketing & SEOAuto-check: notes
SEO
Nexus-JPF/note-companion
Use and read this skill immediately if the user request is in any way related to SEO or a site's organic search or AI search presence.
870 GitHub stars~2.2k tokensUpdated 2 days ago
Marketing & SEOAuto-check passed

Questions about SEO

What does SEO do?

Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments…. SEO is an agent skill from yaojingang/GEOHub. Turn one natural-language request into an evidence-bounded SEO work plan across technical SEO, crawling and indexing, Search Console incidents, keyword-to-page mapping, migrations, experiments, international or ecommerce SEO, and AI-search foundations.

When should I use SEO?

SEO fits situations like: 一句话SEO、技术SEO、自然搜索、收录诊断、关键词页面映射 and website SEO; tasks that involve AI search optimization; tasks that involve Technical SEO.

How do I install SEO in Claude Code?

Run `npx skills add yaojingang/GEOHub --skill seo -a claude-code`. Or copy the skill folder (skills/seo in yaojingang/GEOHub) into .claude/skills/seo in your project. Claude Code loads it when a task matches its description.

How do I install SEO in Codex?

Run `npx skills add yaojingang/GEOHub --skill seo -a codex`. Or copy the skill folder (skills/seo in yaojingang/GEOHub) into .agents/skills/seo in your project. Codex loads it when a task matches its description.

Can I use SEO in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yaojingang/GEOHub --skill seo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo, .gemini/skills/seo, .github/skills/seo and .opencode/skills/seo in your project.

What does SEO need to run?

Going by SKILL.md and its folder, SEO needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and python). Our summary lists: Python 3.

Does SEO access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does SEO use?

SEO is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO use?

About 421 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 553 tokens, read only when the agent opens those files.

What are the alternatives to SEO?

Skills that share tags, products or a category with SEO: Qiaomu SEO (joeseesun/qiaomu-seo, 441 stars), Universal SEO Analysis (AgriciDaniel/claude-seo, 19k stars), GEO Schema Auditor (zubair-trabzada/geo-seo-claude, 11k stars) and SEO (AgriciDaniel/codex-seo, 797 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO?

yaojingang (a GitHub user) maintains it in yaojingang/GEOHub, which has 165 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 31, 2026.

Source: yaojingang/GEOHub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

SEO

Install SEO

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

GEOHub — One-line SEO

Workflow

Output contract

Boundaries

Files

Compare with similar skills

Similar skills

Qiaomu SEO

Universal SEO Analysis

GEO Schema Auditor

SEO

Site Launch Checklist

SEO

More from yaojingang/GEOHub

Geo Site Diagnose

Geo

Geo Content

Geo Diagnose

Geo Discover

Geo Knowledge

Questions about SEO

Install SEO

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

GEOHub — One-line SEO

Workflow

Output contract

Boundaries

Files

Compare with similar skills

Similar skills

More from yaojingang/GEOHub

Related

Questions about SEO