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.
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.
Install Geo Site Diagnose
$ npx skills add yaojingang/GEOHub --skill geo-site-diagnose -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install yaojingang/GEOHub geo-site-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-site-diagnose .claude/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .claude/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-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-site-diagnose -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install yaojingang/GEOHub geo-site-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-site-diagnose .agents/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .agents/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-diagnose -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install yaojingang/GEOHub geo-site-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-site-diagnose .cursor/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .cursor/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-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-site-diagnose -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install yaojingang/GEOHub geo-site-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-site-diagnose .gemini/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .gemini/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-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-site-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-site-diagnose .github/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .github/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-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-site-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-site-diagnose .opencode/skills/geo-site-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-site-diagnose" agent skill from https://github.com/yaojingang/GEOHub/tree/main/skills/geo-site-diagnose into .opencode/skills/geo-site-diagnose/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-site-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-site-diagnose- GitHub stars
- 165
- Token cost
- ~515 tokens
- SKILL.md length
- 200 words
- Files
- 35 (incl. scripts, references, assets)
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
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.
- Works in 6 steps: Read… → Extract the single public URL. Ask only… → Run python3 scripts/run_site_diagnose.py… → …
- 网站 GEO 诊断、全站 GEO 体检、网站 GEO 审计
- SKILL.md covers Workflow, Output contract and Boundaries
- Runs JavaScript scripts from its folder; calls python3
What it does
Geo Site Diagnose is an agent skill from 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. Use for 网站 GEO 诊断、全站 GEO 体检、网站 GEO 审计, or requests such as “帮我诊断网站GEO并附上网址”. Excludes single-page or brand-only diagnosis, live AI ranking or citation measurement, authenticated sites, and website modification.
Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 40 other files, including scripts, reference files and assets (for example `agents/interface.yaml`, `assets/echarts.min.js` and `assets/report.js`).
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
- 网站 GEO 诊断、全站 GEO 体检、网站 GEO 审计
- Requests such as 帮我诊断网站GEO并附上网址
Example prompts
- “帮我诊断网站GEO并附上网址”
- “/geo-site-diagnose”
Requirements
- Python 3
- Node.js
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Read references/site-diagnosis-method.md, references/crawler-policy.md, and references/scoring-policy.md.
- Extract the single public URL. Ask only for the URL when it is missing.
- Run python3 scripts/run_site_diagnose.py --url --output --locale --max-pages 10 --render auto.
- Inspect quality-report.json, diagnostic confidence, source gaps, and limitations before presenting scores.
- Validate the report against references/report-module-contract.md and references/report-design-system.md.
- Deliver the complete Artifact Bus run directory and open report.html for the user.
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/ (JavaScript, from the files we listed), 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 Site Diagnose loads about 515 tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 100 tokens; SKILL.md has 200 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). 200 words, ~515 tokens.
Download SKILL.mdSave it as
.claude/skills/geo-site-diagnose/SKILL.md (or your agent's skills folder). This skill also uses 34 other files; get the full folder from GitHub.- name
- geo-site-diagnose
- description
- 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. Use for 网站 GEO 诊断、全站 GEO 体检、网站 GEO 审计, or requests such as “帮我诊断网站GEO并附上网址”. Excludes single-page or brand-only diagnosis, live AI ranking or citation measurement, authenticated sites, and website modification.
GEOHub Website Diagnosis
Workflow
- Read
references/site-diagnosis-method.md,references/crawler-policy.md, andreferences/scoring-policy.md. - Extract the single public URL. Ask only for the URL when it is missing.
- Run
python3 scripts/run_site_diagnose.py --url <URL> --output <runs-root> --locale <locale> --max-pages 10 --render auto. - Inspect
quality-report.json, diagnostic confidence, source gaps, and limitations before presenting scores. - Validate the report against
references/report-module-contract.mdandreferences/report-design-system.md. - Deliver the complete Artifact Bus run directory and open
report.htmlfor the user.
Output contract
Return a bounded run containing source snapshots, crawl and sampling manifests, structured site and page diagnoses, evidence ledger, remediation backlog, quality and lineage artifacts, and one offline report.html. Read references/report-contract.md for the file contract and report format boundary.
The offline report runtime is packaged under assets/. Governed trigger and output cases are stored under evals/.
Boundaries
Fetch only public HTTP(S) resources on the approved canonical host. Discovery is bounded to 500 inventory URLs, five sitemaps, ten representative pages, 15 MB, and 90 seconds. Preserve blocked or unavailable pages as source_gap. Scores describe observed readiness signals and never claim live AI ranking, recall, citations, traffic, or business effects.
Do not use this Skill for single-page diagnosis, brand-only diagnosis, authenticated sources, live citation measurement, or website modification.
© 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 34 other files (scripts, references, assets) in skills/geo-site-diagnose of yaojingang/GEOHub.
- SKILL.md
- agents/interface.yaml
- assets/ECHARTS-LICENSE.txt
- assets/ECHARTS-NOTICE.txt
- assets/echarts.min.js
- assets/report-shell.html
- assets/report.css
- assets/report.js
- evals/output/cases.jsonl
- evals/output/fixtures/visual-quality.json
- evals/semantic_config.json
- evals/trigger_cases.json
- manifest.json
- references/crawler-policy.md
- references/input-example.json
- … and 20 more
Open the folder on GitHubat commit 2210f7f
Compare with similar skills
Geo Site 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 Site Diagnose this skillyaojingang/GEOHub | 165 | — | ~515 | 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
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 Diagnose
yaojingang/GEOHub
Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence.
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 Site Diagnose
What does Geo Site Diagnose do?
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 Site Diagnose is an agent skill from 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.
When should I use Geo Site Diagnose?
Geo Site Diagnose fits situations like: 网站 GEO 诊断、全站 GEO 体检、网站 GEO 审计; requests such as 帮我诊断网站GEO并附上网址.
How do I install Geo Site Diagnose in Claude Code?
Run `npx skills add yaojingang/GEOHub --skill geo-site-diagnose -a claude-code`. Or copy the skill folder (skills/geo-site-diagnose in yaojingang/GEOHub) into .claude/skills/geo-site-diagnose in your project. Claude Code loads it when a task matches its description.
How do I install Geo Site Diagnose in Codex?
Run `npx skills add yaojingang/GEOHub --skill geo-site-diagnose -a codex`. Or copy the skill folder (skills/geo-site-diagnose in yaojingang/GEOHub) into .agents/skills/geo-site-diagnose in your project. Codex loads it when a task matches its description.
Can I use Geo Site 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-site-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-site-diagnose, .gemini/skills/geo-site-diagnose, .github/skills/geo-site-diagnose and .opencode/skills/geo-site-diagnose in your project.
What does Geo Site Diagnose need to run?
Going by SKILL.md and its folder, Geo Site Diagnose needs JavaScript for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; Node.js.
Does Geo Site 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 Site 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 Site Diagnose use?
Geo Site 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 Site Diagnose use?
About 515 tokens (SKILL.md is roughly 2.1k 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 3.5k tokens, read only when the agent opens those files.
What are the alternatives to Geo Site Diagnose?
Skills that share tags, products or a category with Geo Site 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 Site 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.