Aeo
alirezarezvani/claude-skills
Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources.
Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence.
Install Geo Diagnose
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install yaojingang/GEOHub geo-diagnose --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/geo-diagnose .claude/skills/geo-diagnose && rm -rf skills-srcUse ~/.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/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .claude/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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 install https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnoseType 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.
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install yaojingang/GEOHub geo-diagnose --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/geo-diagnose .agents/skills/geo-diagnose && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .agents/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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.
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install yaojingang/GEOHub geo-diagnose --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/geo-diagnose .cursor/skills/geo-diagnose && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .cursor/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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 https://github.com/yaojingang/GEOHub.git --path skills/geo-diagnose--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install yaojingang/GEOHub geo-diagnose --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/geo-diagnose .gemini/skills/geo-diagnose && rm -rf skills-srcUse ~/.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/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .gemini/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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.
$ gh skill install yaojingang/GEOHub geo-diagnoseInstalls 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).
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/geo-diagnose .github/skills/geo-diagnose && rm -rf skills-srcUse ~/.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/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .github/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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.
$ npx skills add yaojingang/GEOHub --skill geo-diagnose -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install yaojingang/GEOHub geo-diagnose --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yaojingang/GEOHub.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/geo-diagnose .opencode/skills/geo-diagnose && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "geo-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-diagnose into .opencode/skills/geo-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-diagnose", 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
geo-diagnose- GitHub stars
- 165
- Token cost
- ~434 tokens
- SKILL.md length
- 158 words
- Files
- 13 (incl. scripts, references)
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence.
- Works in 5 steps: Read references/diagnosis-method.md;… → Prepare the diagnosis brief contract. → Run python3 scripts/run_diagnose.py… → …
- Brand diagnosis
- SKILL.md covers Workflow, Output contract and Boundaries
- Runs Python scripts from its folder; calls python3
What it does
Geo Diagnose is an agent skill from yaojingang/GEOHub. Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence. Use for brand diagnosis, website or page audits, GEO gap analysis, and 品牌诊断、网站诊断、页面诊断. Excludes live AI-platform recall, ranking, and citation-share measurement.
Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 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 and Citation management. It works with 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
- Brand diagnosis
- GEO gap analysis
Example prompts
- “/geo-diagnose”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Read references/diagnosis-method.md; read references/audit-catalog.md for non-legacy audit execution.
- Prepare the diagnosis brief contract.
- Run python3 scripts/run_diagnose.py --input --output --execution-mode . Legacy remains the compatibility default.
- Inspect quality-report.json, run-lineage.json, source_status, audit components, and limitations before using findings.
- Deliver the complete Artifact Bus run directory.
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
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
Geo Diagnose loads about 434 tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 75 tokens; SKILL.md has 158 words of instructions outside code blocks.
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). 158 words, ~434 tokens.
Download SKILL.mdSave it as
.claude/skills/geo-diagnose/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.- name
- geo-diagnose
- description
- Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence. Use for brand diagnosis, website or page audits, GEO gap analysis, and 品牌诊断、网站诊断、页面诊断. Excludes live AI-platform recall, ranking, and citation-share measurement.
GEO Diagnose
Workflow
- Read
references/diagnosis-method.md; readreferences/audit-catalog.mdfor non-legacy audit execution. - Prepare the diagnosis brief contract.
- Run
python3 scripts/run_diagnose.py --input <brief.json> --output <runs-root> --execution-mode <legacy|deterministic|research|provider>. Legacy remains the compatibility default. - Inspect
quality-report.json,run-lineage.json,source_status, audit components, and limitations before using findings. - Deliver the complete Artifact Bus run directory.
Output contract
Return <runs-root>/<run-id>/ containing the normalized input and replayable HTML snapshots under input/sources/, structured diagnosis, deterministic Markdown report, evidence-linked remediation query map, opportunity map, quality report, run lineage, and run manifest. Non-legacy diagnosis adds versioned audit results, reconstructable score components, execution status, and a semantic digest to diagnosis.json.
Boundaries
Fetch only explicit public HTTP(S) canonical URLs without query strings. Accept remote HTML/XHTML only and keep unavailable or unsupported sources as source_gap. Every observed, provided, or inferred finding carries a content-derived evidence ID. Provider audit mode has no packaged adapter and records a degraded deterministic fallback. Never claim live AI-platform recall, ranking, or citation share.
© yaojingang, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 12 other files (scripts, references) in skills/geo-diagnose of yaojingang/GEOHub.
- SKILL.md
- agents/interface.yaml
- evals/output/cases.jsonl
- evals/semantic_config.json
- evals/trigger_cases.json
- manifest.json
- references/audit-catalog.md
- references/diagnosis-method.md
- references/input-example.json
- reports/output_quality_scorecard.md
- reports/skill-ir.json
- reports/trust-report.md
- scripts/run_diagnose.py
Open the folder on GitHubat commit 2210f7f
Compare with similar skills
Geo Diagnose 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Geo Diagnose this skillyaojingang/GEOHub | 165 | — | ~434 | Automated safety check: Pass | AGPL-3.0 | |
| Aeoalirezarezvani/claude-skills | 28k | — | ~2.7k | Automated safety check: Pass | MIT | |
| SEO ProfoundAgriciDaniel/claude-seo | 19k | 1 repos | ~441 | Automated safety check: Pass | MIT | |
| Citation Source Gap Finderirinabuht12-oss/marketing-skills | 4.1k | — | ~601 | Automated safety check: Pass | None | |
| Beyondseobeyondtahir/beyondseo | 161 | — | ~4.3k | Automated safety check: Pass | MIT | |
| Universal SEO AnalysisAgriciDaniel/claude-seo | 19k | — | ~4.9k | Automated safety check: Pass | MIT |
Similar skills
SEO Profound
AgriciDaniel/claude-seo
Profound LLM citation tracker (extension). An agent skill from AgriciDaniel/claude-seo.
Citation Source Gap Finder
irinabuht12-oss/marketing-skills
Find the exact pages AI assistants cite when answering questions in your category, and identify which ones you can get into.
Beyondseo
beyondtahir/beyondseo
Audit websites, apply authorised SEO improvements and plan content, competitors and backlinks with evidence, design checks and optional project monitoring.
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.
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.
More from yaojingang/GEOHub
All 9 skills in this repoGeo Site Diagnose
yaojingang/GEOHub
Crawl one public website from a supplied URL, select up to ten representative page types, score evidence-lined GEO readiness, and generate a standalone visual HTML report.
Geo
yaojingang/GEOHub
Route GEO and generative engine optimization requests to an available GEOHub capability.
Geo Content
yaojingang/GEOHub
Create evidence-lined GEO titles, explainers, neutral comparisons, method-backed rankings, page blueprints, refinements, and article-friendly Markdown.
Geo Discover
yaojingang/GEOHub
Discover evidence-aware GEO questions, query rewrites, intent clusters, and prioritized content opportunities from a structured brief.
Geo Knowledge
yaojingang/GEOHub
Build and query an evidence-lined GEO knowledge graph from approved source bundles.
Geo Measure
yaojingang/GEOHub
Measure GEO visibility from an approved, file-backed engine observation bundle.
Related
Works with
Categories
Questions about Geo Diagnose
What does Geo Diagnose do?
Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence. Geo Diagnose is an agent skill from yaojingang/GEOHub. Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence.
When should I use Geo Diagnose?
Geo Diagnose fits situations like: brand diagnosis; GEO gap analysis.
How do I install Geo Diagnose in Claude Code?
Run `npx skills add yaojingang/GEOHub --skill geo-diagnose -a claude-code`. Or copy the skill folder (skills/geo-diagnose in yaojingang/GEOHub) into .claude/skills/geo-diagnose in your project. Claude Code loads it when a task matches its description.
How do I install Geo Diagnose in Codex?
Run `npx skills add yaojingang/GEOHub --skill geo-diagnose -a codex`. Or copy the skill folder (skills/geo-diagnose in yaojingang/GEOHub) into .agents/skills/geo-diagnose in your project. Codex loads it when a task matches its description.
Can I use Geo Diagnose 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 geo-diagnose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/geo-diagnose, .gemini/skills/geo-diagnose, .github/skills/geo-diagnose and .opencode/skills/geo-diagnose in your project.
What does Geo Diagnose need to run?
Going by SKILL.md and its folder, Geo Diagnose needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Geo Diagnose 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 Geo Diagnose 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 Geo Diagnose use?
Geo Diagnose 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 Geo Diagnose use?
About 434 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 1.6k tokens, read only when the agent opens those files.
What are the alternatives to Geo Diagnose?
Skills that share tags, products or a category with Geo Diagnose: Aeo (alirezarezvani/claude-skills, 28k stars), SEO Profound (AgriciDaniel/claude-seo, 19k stars), Citation Source Gap Finder (irinabuht12-oss/marketing-skills, 4.1k stars) and Beyondseo (beyondtahir/beyondseo, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Geo Diagnose?
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.