Geo Discover Agent Skill

Discover evidence-aware GEO questions, query rewrites, intent clusters, and prioritized content opportunities from a structured brief. Use for AI search intent mining, question or keyword expansion, query research, FAQ discovery, 拓词, and GEO topic discovery in Chinese or English.

4k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

101

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/yaojingang/GEOHub --skill geo-discover

What comes with it

13 096 bytes besides the instruction

agents/interface.yaml

evals/output/cases.jsonl

evals/semantic_config.json

evals/trigger_cases.json

manifest.json

references/discovery-method-v2.md

references/discovery-method.md

references/input-example.json

reports/output_quality_scorecard.md

reports/skill-ir.json

reports/trust-report.md

scripts/run_discover.py

The instruction itself

4 sections, as written by the author

GEO Discover

Workflow

Read references/discovery-method.md; read references/discovery-method-v2.md when requesting a non-legacy execution mode.
Prepare a protocol 1.0.0 file-backed GEO brief.
Run python3 scripts/run_discover.py --input <brief.json> --output <runs-root> --execution-mode <legacy|deterministic|research|provider>. Legacy remains the compatibility default.
Inspect quality-report.json and run-lineage.json; surface all warnings and failed checks.
Deliver the Artifact Bus directory as the output contract.

Output contract

Treat the output argument as the runs root. Produce <runs-root>/<run-id>/input/geo-brief.json, run-manifest.json, run-lineage.json, evidence-ledger.json, query-map.json, opportunity-map.json, and quality-report.json. Return the actual <runs-root>/<run-id> directory.

Boundaries

Legacy and deterministic modes are offline and file-backed. Research mode consumes only approved evidence already present in the brief. Provider mode needs an explicit runtime adapter; the packaged CLI has no adapter and degrades to deterministic generation with a recorded failure. Discovery records missing evidence and never invents platform responses, volume, ranking, conversion, competitor, or customer data. Diagnosis and content generation remain separate Registry stages.

How to use it

Copy the folder

Take yaojingang/geo-discover from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.