GEO Diagnose
SkillWeb & browsingLets your agent audit a website or page and find gaps in how well AI search engines can find and cite it.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the GEO Diagnose skill
About this capability
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.
What this skill tells your AI
The instructions your AI receives, as published by yaojingang/geohub in skills/geo-diagnose/SKILL.md and read by ahel’s review.
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.
Signals
- GitHub stars
- 160
- Forks
- 27
- Last commit
- Aug 2026
ahel review
K6low
bundled executables the agent is told to run
Automated review, not a security audit. Ruleset v1+k2.
Advanced
- Catalog kind
- skill
- Gateway key
geo-diagnose- Source
- github.com/yaojingang/geohub