Teach your agent to use GEOly right
Tell the agent which route to take, which brand to look up first, how to read each metric, and which calls cost credits — plus seven ready-made slash commands.
Tools alone aren’t enough.The skill is a playbook written for agents.
Use the CLI if it’s installed locally, otherwise MCP.
Find the organization and brand before calling data tools, so it never queries the wrong one.
Citation rate, mention rate, AIGVR, and Share of Model, described the same as in the dashboard.
What the skill covers.Version 0.8.0, kept in step with the live tools.
Up to 55 MCP tools per connection, each with what it does, its parameters, and what a call costs, including the new AI shopping performance tool and the AI verdict attribute matrix and quotes.
How visibility, mention rate, citation rate, share of mentions, and win rate are calculated, which numbers never belong in the same comparison, and what to say when there’s no data.
Category leaders, brand momentum, white space, AI search demand, and AI shopping boards: locate with free tools first, then pay to read.
Seven slash commands.One command, one finished report — no tool chain to assemble.
Once the skill is installed and MCP is connected, these seven show up as clickable slash commands in any client that supports MCP prompts. Each one pins down which tools to call, how to compute, and the exact output format — and you can keep asking follow-ups afterwards. A command is not registered at all if your connection is missing any tool it needs, so the chain listed below is the one it really calls.
/geoly_weekly_pulseWeekly Visibility PulseThis week vs last: your headline metrics, the per-platform split, the competitors that moved most, new entrants, and which cited domains shifted. Formatted to paste into a channel.
- Arguments
- None. On a multi-brand connection, pass brand (name or id).
- Output
- A one-line TL;DR, your brand (mention / citation rate and sentiment with pp deltas), a per-platform table, movers up and down, a cited-domain shift table, and where to look next. Under 50 lines.
- Calls
get_brand_contextget_daily_trendget_brand_overviewget_brand_boardget_citation_overview
/geoly_competitor_radarCompetitor Movement RadarScan week over week for competitors that really moved: how far, which platforms they show up on, and which domains carry them while never mentioning you.
- Arguments
- threshold_pp — how many percentage points count as a move. Default 5.
- Output
- Leads with the biggest threat, then gaining competitors, losing competitors, and where your brand is most exposed.
- Calls
get_brand_contextget_brand_boardget_platform_matrixget_citation_overview
/geoly_platform_scorecardAI Platform ScorecardScore every platform: answers, mention rate, citation rate, AIGVR, sentiment, share of mentions, and the strongest competitor there.
- Arguments
- None.
- Output
- A per-platform table plus strongest / weakest / priority platform. Priority is picked by answers × (1 − mention rate) — the pool where you are absent most. Platforms your plan covers but with no answers yet read "no data yet", never 0%.
- Calls
get_brand_contextget_daily_trendget_brand_overviewget_platform_matrix
/geoly_topic_heatmapTopic × Platform HeatmapLay AIGVR out as a topic × platform grid, calibrated to your own average so each cell reads as blind spot / weak / moderate / strong / dominant.
- Arguments
- None.
- Output
- The heatmap (up to 15 topics by answer volume), a blind-spot list, and your strongholds. Blind spots are followed up with the domains that cite competitors in that topic and not you. Cells with no data read "—" and are never called a blind spot.
- Calls
get_brand_contextget_platform_matrixget_citation_overview
/geoly_source_gap_auditCitation Source AuditHow your own domains perform as cited sources, which domains AI cites instead, and the content gaps where competitors are cited and you are not.
- Arguments
- None.
- Output
- Your position (share and rank, plus the you / competitor / other split), your cited domains, the content gaps, and where to act.
- Calls
get_brand_contextget_citation_overviewget_domain_detail
/geoly_campaign_trackerCampaign Impact TrackerBefore/after around a launch date: how mention and citation rates moved per platform, and whether the URLs you name got picked up as AI citations.
- Arguments
- campaign_date — the launch date (YYYY-MM-DD, the business date the app shows); urls — comma-separated URLs to track, or omit to look at your own domains broadly.
- Output
- The before/after table, source pickup, and how to read it — including the reminder that this is correlation, not proof of cause.
- Calls
get_brand_contextget_daily_trendget_brand_overviewget_url_detailget_citation_overview
/geoly_prompt_set_graderPrompt Set GraderGrade the prompt set you monitor: topic balance, tag hygiene, funnel coverage, branded vs unbranded split, duplicates, and platform data coverage.
- Arguments
- None.
- Output
- An A–F composite, a grade per dimension, and the top 3 fixes — each naming actual topics, tags, duplicate pairs or platforms. Under 10 prompts, it says the grades are not meaningful yet.
- Calls
get_brand_contextget_prompt_listget_topic_list
What’s in the package.Five files, 332 KB of caliber guidance.
You install two skills: geoly-mcp (0.8.0 today) covers connection, tool selection and calibers; geoly-geo-reporting covers reporting only — which KPI to pick, how to read a trend, and the caliber mistakes people make most. Below is the geoly-mcp file list; agents read the parts they need rather than loading all of it.
SKILL.md44 KB · The main document: CLI or MCP first, the org/brand discovery order, which calls cost credits, a question → tool selection table, and recipes.references/tools-catalog.md87 KB · The full tool catalog: purpose, parameters, price and views for every tool, plus the legacy names that expire on 2026-11-30.references/metric-calibers.md28 KB · Metric glossary and caliber traps: definition, denominator, where to read it, and how to reconcile two numbers that disagree.references/public-tools.md39 KB · How to use public industry data: the locale, platform and time-window conventions, plus competitive-intelligence tool chains.CHANGELOG.md134 KB · Version by version. When an old pull does not match today, this is where you find which release changed the caliber.What the skill mostly stops.The data is right; the mistakes are calibers.
Three ways to install.Pick whichever is easiest.
npx skills add geoly-ai/agent-skillsInstalls to .agents/skills/ and links it for each agent on your machine.
The skill is free. Your account’s industry data credits are used only when the agent calls industry data tools. To see exactly which tools it can reach, open the MCP tool catalog.
FAQ
What people ask most before installing
The skill doesn’t provide data. It teaches agents how to use GEOly’s MCP or CLI, so connect MCP or install the CLI first.
Teach your agent how to use GEOly
The skill is free and works with MCP or the CLI.