Agent skill

Voyage Geo Aeo Analysis

by onvoyage-ai in onvoyage-ai/voyage-geo-agent

Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards

MITAuto-check: notesMarketing & SEO

Install Voyage Geo Aeo Analysis

skills CLI
$ npx skills add onvoyage-ai/voyage-geo-agent --skill voyage-geo-aeo-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install onvoyage-ai/voyage-geo-agent voyage-geo-aeo-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/onvoyage-ai/voyage-geo-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/voyage-geo-aeo-analysis .claude/skills/voyage-geo-aeo-analysis && rm -rf skills-src

Use ~/.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/

Facts

Skill name
voyage-geo-aeo-analysis
GitHub stars
384
Token cost
~806 tokens
SKILL.md length
358 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards

  • Tasks that involve AI search optimization
  • SKILL.md covers When To Use, Workflow, CLI Quick Reference and Guardrails
  • Calls pip

What it does

Voyage Geo Aeo Analysis is an agent skill from onvoyage-ai/voyage-geo-agent. Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards

Its SKILL.md is about 810 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. 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

  • “/voyage-geo-aeo-analysis”

Requirements

  • Python 3

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

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    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

Voyage Geo Aeo Analysis loads about 806 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 358 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~806

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:27
    ys are missing, ask user to add them to `.env` (never print secrets)

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). 358 words, ~806 tokens.

Download SKILL.mdSave it as .claude/skills/voyage-geo-aeo-analysis/SKILL.md (or your agent's skills folder).
name
voyage-geo-aeo-analysis
description
Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards
user_invocable
true

voyage-geo-aeo-analysis

You are an AI brand analyst running Generative Engine Optimization (GEO/AEO) audits. Guide the user through setup, execution, and interpretation for both brand analysis and category leaderboard workflows.

When To Use

Use this skill when the user wants to:

  • Measure AI visibility for a brand
  • Rank brands in a category by AI visibility
  • Compare provider/model performance
  • Identify brand mention gaps and narrative gaps
  • Generate executive-ready GEO reports

Workflow

  1. Validate environment first:
  • Ensure voyage-geo is installed
  • Run voyage-geo providers
  • Confirm at least one execution provider is configured
  • Confirm processing provider is configured
  • If keys are missing, ask user to add them to .env (never print secrets)
  • Run voyage-geo providers --test
  1. Ask the user which workflow they want:
  • brand-run (single brand GEO analysis)
  • leaderboard (category-wide ranking)
  1. If workflow is brand-run, collect:
  • Brand name (required)
  • Website URL (optional but recommended)
  • Competitors (optional)
  • Focus keywords/categories (optional)
  • Providers, query count, output formats
  1. Execute brand-run:
  • voyage-geo run -b "<brand>" -w "<url>" -p <providers> -q <n> -f html,json,csv,markdown
  1. Read brand-run outputs:
  • data/runs/<run-id>/analysis/summary.json
  • data/runs/<run-id>/analysis/analysis.json
  1. Present brand-run findings:
  • Mention rate, sentiment, mindshare rank, provider comparison
  • Brand themes, USP coverage gaps, competitor narrative deltas
  • Top recommendations and HTML report path
  1. If workflow is leaderboard, collect:
  • Category (required)
  • Providers, query count, output formats
  • Optional max-brands
  1. Execute leaderboard in two stages:
Show full SKILL.md (140 more words)Show less
  • Generate and review queries:
    • voyage-geo leaderboard "<category>" -p <providers> -q <n> --stop-after query-generation
  • Review data/runs/<run-id>/queries.json with user
  • Resume full execution:
    • voyage-geo leaderboard "<category>" --resume <run-id> -p <providers> -f html,json,csv,markdown
  1. Read leaderboard outputs:
  • data/runs/<run-id>/analysis/leaderboard.json
  1. Present leaderboard findings:
  • Rankings table, #1 brand, biggest gaps, provider preferences, surprises
  • HTML report path
  1. End by asking:
  • "Want to dig deeper or rerun with different providers/queries?"

CLI Quick Reference

  • pip install voyage-geo
  • voyage-geo providers
  • voyage-geo providers --test
  • voyage-geo run -b "<name>" -w "<url>" -p chatgpt,gemini,claude -f html,json,csv,markdown
  • voyage-geo leaderboard "<category>" -p chatgpt,gemini,claude -q 20 --stop-after query-generation
  • voyage-geo leaderboard "<category>" --resume <run-id> -p chatgpt,gemini,claude -f html,json,csv,markdown

Guardrails

  • For brand-run, do not proceed without a brand name.
  • For leaderboard, do not proceed without a category.
  • Do not echo API keys.
  • If providers are not configured, stop and request keys.
  • Always confirm model/provider selection before running.

© 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 voyage-geo-aeo-analysis of onvoyage-ai/voyage-geo-agent.

Open the folder on GitHubat commit 2ed1cfa

Compare with similar skills

Voyage Geo Aeo Analysis 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.

Voyage Geo Aeo Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Voyage Geo Aeo Analysis this skillonvoyage-ai/voyage-geo-agent384—~806Automated safety check: NotesMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
GEO Monthly Delta Reportzubair-trabzada/geo-seo-claude11k—~2.4kAutomated safety check: NotesMIT
SEO DataforseoAgriciDaniel/codex-seo7992 repos~4.6kAutomated safety check: PassMIT

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • 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.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • Fire Your SEO Agency

    leopard627/fire-your-seo-agency

    SEO·AEO·GEO·LLMO·NEO(네이버) 다섯 레인을 진단하고 직접 구현하며, 인용되는 콘텐츠를 계속 생산하는 서브 블로그·콘텐츠 운영 파이프라인까지 세팅하는 스킬.

    711 GitHub stars~1.1k tokensUpdated 15 days ago
    Marketing & SEOAuto-check passed

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

    384 GitHub stars~989 tokensUpdated 7 mo ago
    Auto-check passed
  • Geo Run

    onvoyage-ai/voyage-geo-agent

    Run a full GEO analysis — guides you through setup, brand research, query generation, execution, analysis, and reporting

    384 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check: notes

Categories

Questions about Voyage Geo Aeo Analysis

What does Voyage Geo Aeo Analysis do?

Run complete GEO analysis workflows with voyage-geo, including both brand runs and category leaderboards. Voyage Geo Aeo Analysis is an agent skill from onvoyage-ai/voyage-geo-agent.

When should I use Voyage Geo Aeo Analysis?

Voyage Geo Aeo Analysis fits situations like: tasks that involve AI search optimization.

How do I install Voyage Geo Aeo Analysis in Claude Code?

Run `npx skills add onvoyage-ai/voyage-geo-agent --skill voyage-geo-aeo-analysis -a claude-code`. Or copy the skill folder (voyage-geo-aeo-analysis in onvoyage-ai/voyage-geo-agent) into .claude/skills/voyage-geo-aeo-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Voyage Geo Aeo Analysis in Codex?

Run `npx skills add onvoyage-ai/voyage-geo-agent --skill voyage-geo-aeo-analysis -a codex`. Or copy the skill folder (voyage-geo-aeo-analysis in onvoyage-ai/voyage-geo-agent) into .agents/skills/voyage-geo-aeo-analysis in your project. Codex loads it when a task matches its description.

Can I use Voyage Geo Aeo Analysis 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 voyage-geo-aeo-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/voyage-geo-aeo-analysis, .gemini/skills/voyage-geo-aeo-analysis, .github/skills/voyage-geo-aeo-analysis and .opencode/skills/voyage-geo-aeo-analysis in your project.

What does Voyage Geo Aeo Analysis need to run?

Going by SKILL.md and its folder, Voyage Geo Aeo Analysis needs the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does Voyage Geo Aeo Analysis access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Voyage Geo Aeo Analysis 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 Voyage Geo Aeo Analysis use?

Voyage Geo Aeo Analysis 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 Voyage Geo Aeo Analysis use?

About 806 tokens (SKILL.md is roughly 3.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 Voyage Geo Aeo Analysis?

Skills that share tags, products or a category with Voyage Geo Aeo Analysis: 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 GEO Monthly Delta Report (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Voyage Geo Aeo Analysis?

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.