Geo Fundamentals
wasp-lang/wasp
Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).
Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting
Install Geo Run
$ npx skills add onvoyage-ai/voyage-geo-agent --skill geo-run -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install onvoyage-ai/voyage-geo-agent geo-run --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/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/geo-run .claude/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .claude/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-runType 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 onvoyage-ai/voyage-geo-agent --skill geo-run -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install onvoyage-ai/voyage-geo-agent geo-run --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/geo-run .agents/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .agents/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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 onvoyage-ai/voyage-geo-agent --skill geo-run -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install onvoyage-ai/voyage-geo-agent geo-run --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/geo-run .cursor/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .cursor/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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/onvoyage-ai/voyage-geo-agent.git --path .claude/skills/geo-run--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 onvoyage-ai/voyage-geo-agent --skill geo-run -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install onvoyage-ai/voyage-geo-agent geo-run --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/geo-run .gemini/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .gemini/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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 onvoyage-ai/voyage-geo-agent geo-runInstalls 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 onvoyage-ai/voyage-geo-agent --skill geo-run -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/geo-run .github/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .github/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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 onvoyage-ai/voyage-geo-agent --skill geo-run -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install onvoyage-ai/voyage-geo-agent geo-run --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/geo-run .opencode/skills/geo-run && 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-run" agent skill from https://github.com/onvoyage-ai/voyage-geo-agent/tree/main/.claude/skills/geo-run into .opencode/skills/geo-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-run", 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-run- GitHub stars
- 384
- Token cost
- ~1.3k tokens
- SKILL.md length
- 554 words
- Files
- 1
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting
- Works in 4 steps: Gather Brand Info → Check Setup & Choose Models → Confirm & Run → …
- Tasks that involve AI search optimization
- SKILL.md covers CLI Reference, Step 1: Gather Brand Info, Step 2: Check Setup & Choose… and Step 3: Confirm & Run, plus 2 more sections
- Calls pip; needs OPENROUTER_API_KEY and OPENAI_API_KEY
What it does
Geo Run is an agent skill from onvoyage-ai/voyage-geo-agent. Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Marketing & SEO, covering AI search optimization. It works with OpenRouter, OpenAI and Perplexity. The repository describes itself as: Agentic Generative Engine Optimizaiton. The licence is MIT.
When your agent uses it
- Tasks that involve AI search optimization
Example prompts
- “/geo-run”
Requirements
- Python 3
- A credential in OPENROUTER_API_KEY
- A credential in OPENAI_API_KEY
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 2ed1cfa. 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
Shell commands in SKILL.md call:
pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
openrouter.aiplatform.openai.comconsole.anthropic.comaistudio.google.comdocs.perplexity.ai
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
OPENROUTER_API_KEYOPENAI_API_KEYANTHROPIC_API_KEYGOOGLE_API_KEYPERPLEXITY_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Geo Run loads about 1.3k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 554 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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:70
- Write keys to `.env` file. NEVER echo keys back to the user.
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from onvoyage-ai/voyage-geo-agent at commit 2ed1cfa, republished under its MIT licence (© onvoyage-ai). 554 words, ~1,303 tokens.
Download SKILL.mdSave it as
.claude/skills/geo-run/SKILL.md (or your agent's skills folder).- name
- geo-run
- description
- Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting
- user_invocable
- true
Run GEO Analysis
You are an AI brand analyst running a Generative Engine Optimization audit. Guide the user through the full pipeline interactively.
CLI Reference
pip install voyage-geo # install if needed
voyage-geo providers # list configured providers
voyage-geo providers --test # health check providers
voyage-geo run -b "<name>" -w "<url>" -p chatgpt,gemini,claude -f html,json,csv,markdownFlags for run:
--brand / -b(required) — brand name--website / -w— brand website URL--providers / -p— comma-separated provider names (default: all via OpenRouter)--queries / -q— number of queries (default: 20)--iterations / -i— iterations per query (default: 1)--formats / -f— report formats (default: html,json)--concurrency / -c— concurrent API requests (default: 10)--output-dir / -o— output directory (default: ./data/runs)
Step 1: Gather Brand Info
Ask the user:
- "What brand do you want to analyze?" (required)
- "What's the website URL?" (optional but recommended)
- "Who are the main competitors?" (optional — AI will research if not provided)
- "Any specific keywords or product categories to focus on?"
Do NOT proceed until you have at least the brand name.
Step 2: Check Setup & Choose Models
Check if
voyage-geois installed. If not:pip install voyage-geoRun
voyage-geo providersto see which API keys are configured.Present the available models as a checklist and ask the user which ones to include:
Model Provider Key needed ChatGPT OpenRouter or OpenAI OPENROUTER_API_KEYorOPENAI_API_KEYClaude OpenRouter or Anthropic OPENROUTER_API_KEYorANTHROPIC_API_KEYGemini OpenRouter or Google OPENROUTER_API_KEYorGOOGLE_API_KEYPerplexity OpenRouter or Perplexity OPENROUTER_API_KEYorPERPLEXITY_API_KEYDeepSeek OpenRouter OPENROUTER_API_KEYGrok OpenRouter OPENROUTER_API_KEYLlama OpenRouter OPENROUTER_API_KEYMistral OpenRouter OPENROUTER_API_KEYCohere OpenRouter OPENROUTER_API_KEYQwen OpenRouter OPENROUTER_API_KEYKimi OpenRouter OPENROUTER_API_KEYGLM OpenRouter OPENROUTER_API_KEYTip: OpenRouter (https://openrouter.ai/keys) gives access to all models with one key.
After the user picks models, check which API keys are missing for those models.
- If keys are missing, ask the user to provide them. Link to:
- OpenRouter: https://openrouter.ai/keys
- OpenAI: https://platform.openai.com/api-keys
- Anthropic: https://console.anthropic.com/
- Google: https://aistudio.google.com/apikey
- Perplexity: https://docs.perplexity.ai/
- Write keys to
.envfile. NEVER echo keys back to the user.
- If keys are missing, ask the user to provide them. Link to:
Check the Processing provider line in the
voyage-geo providersoutput.- The processing provider is used for internal LLM calls (research, query generation, analysis) — it's separate from the execution providers above.
- If it says "configured", you're good — no action needed.
- If it says "NOT CONFIGURED", the user needs at least one of:
ANTHROPIC_API_KEY,OPENAI_API_KEY,GOOGLE_API_KEY, orOPENROUTER_API_KEY. If the user already hasOPENROUTER_API_KEYset for execution providers, the processing provider will auto-detect it — re-runvoyage-geo providersto confirm.
Verify with
voyage-geo providers --testConfirm the final model list with the user before proceeding.
Show full SKILL.md (160 more words)Show less
Step 3: Confirm & Run
Summarize the analysis plan:
- Brand name, website, competitors
- Which providers will be queried
- Number of queries (default 20) and iterations (default 1)
- Ask "Ready to run? Want to adjust anything?"
Once confirmed, run:
voyage-geo run -b "<name>" -w "<url>" -p <list> -q <n> -f html,json,csv,markdownStep 4: Present Results
After the run completes:
- Read the executive summary from
data/runs/<run-id>/analysis/summary.json - Read the full analysis from
data/runs/<run-id>/analysis/analysis.json - Present key findings conversationally:
- "Your brand was mentioned in X% of AI responses"
- "Sentiment is [positive/neutral/negative]"
- "You rank #N among competitors for AI mindshare"
- "Strongest on [provider], weakest on [provider]"
- Present narrative analysis findings:
- What themes/attributes AI models associate with the brand (from
analysis.narrative.brand_themes) - USP coverage gaps — which selling points AI models are NOT mentioning (from
analysis.narrative.gaps) - How the brand's narrative compares to competitors (from
analysis.narrative.competitor_themes)
- What themes/attributes AI models associate with the brand (from
- Highlight the top recommendations
- Tell them where the HTML report is:
data/runs/<run-id>/reports/report.html - Ask "Want to dig deeper into any of these findings?"
Allowed Tools
- Bash
- Read
- Glob
- Grep
- Write
- Edit
© onvoyage-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/geo-run of onvoyage-ai/voyage-geo-agent.
Open the folder on GitHubat commit 2ed1cfa
Compare with similar skills
Geo Run 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 Run this skillonvoyage-ai/voyage-geo-agent | 384 | — | ~1.3k | Automated safety check: Notes | MIT | |
| Geo Fundamentalswasp-lang/wasp | 19k | 9 repos | ~861 | Automated safety check: Pass | MIT | |
| SEO GeoReScienceLab/opc-skills | 1.8k | 4 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude | 11k | — | ~2.8k | Automated safety check: Notes | MIT | |
| Fire Your SEO Agencyleopard627/fire-your-seo-agency | 711 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Marketing OsYuzzyuk/marketing-os | 540 | — | ~2.5k | Automated safety check: Pass | MIT |
Similar skills
SEO Geo
ReScienceLab/opc-skills
SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.
GEO-First SEO Audit Tool
zubair-trabzada/geo-seo-claude
Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.
Fire Your SEO Agency
leopard627/fire-your-seo-agency
SEO·AEO·GEO·LLMO·NEO(네이버) 다섯 레인을 진단하고 직접 구현하며, 인용되는 콘텐츠를 계속 생산하는 서브 블로그·콘텐츠 운영 파이프라인까지 세팅하는 스킬.
Marketing Os
Yuzzyuk/marketing-os
A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.
AI Visibility
Ryze-AI-Adgent/open-seo-mcp-skills
Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from actual GA4 referral data, not prompt sampling.
More from onvoyage-ai/voyage-geo-agent
Geo Leaderboard
onvoyage-ai/voyage-geo-agent
Run a category-wide GEO leaderboard — compare all brands in a category to see who has the strongest AI visibility
Voyage Geo Aeo Analysis
onvoyage-ai/voyage-geo-agent
Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards
Related
Works with
Categories
Questions about Geo Run
What does Geo Run do?
Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting. Geo Run is an agent skill from onvoyage-ai/voyage-geo-agent.
When should I use Geo Run?
Geo Run fits situations like: tasks that involve AI search optimization.
How do I install Geo Run in Claude Code?
Run `npx skills add onvoyage-ai/voyage-geo-agent --skill geo-run -a claude-code`. Or copy the skill folder (.claude/skills/geo-run in onvoyage-ai/voyage-geo-agent) into .claude/skills/geo-run in your project. Claude Code loads it when a task matches its description.
How do I install Geo Run in Codex?
Run `npx skills add onvoyage-ai/voyage-geo-agent --skill geo-run -a codex`. Or copy the skill folder (.claude/skills/geo-run in onvoyage-ai/voyage-geo-agent) into .agents/skills/geo-run in your project. Codex loads it when a task matches its description.
Can I use Geo Run 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 onvoyage-ai/voyage-geo-agent --skill geo-run -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-run, .gemini/skills/geo-run, .github/skills/geo-run and .opencode/skills/geo-run in your project.
What does Geo Run need to run?
Going by SKILL.md and its folder, Geo Run needs the command-line tools its instructions call (pip) and credentials named OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY and GOOGLE_API_KEY. Our summary lists: Python 3; A credential in OPENROUTER_API_KEY; A credential in OPENAI_API_KEY.
Does Geo Run access the network?
SKILL.md names 5 domains. As links in the text: openrouter.ai, platform.openai.com, console.anthropic.com, aistudio.google.com and docs.perplexity.ai. This is read from the text; nothing was executed.
Is Geo Run safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Geo Run use?
Geo Run is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Geo Run use?
About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Geo Run?
Skills that share tags, products or a category with Geo Run: Geo Fundamentals (wasp-lang/wasp, 19k stars), SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars) and Fire Your SEO Agency (leopard627/fire-your-seo-agency, 711 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Geo Run?
onvoyage-ai (a GitHub organization) maintains it in onvoyage-ai/voyage-geo-agent, which has 384 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on February 24, 2026.
Source: onvoyage-ai/voyage-geo-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.