For Claude Code, Codex, Cursor, and other skill-ready agentsWorks with any skill-ready agent

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.

Pick the right route

Use the CLI if it’s installed locally, otherwise MCP.

Discover, then query

Find the organization and brand before calling data tools, so it never queries the wrong one.

Explain it the GEOly way

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.

The full tool catalog

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.

Metric definitions

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.

Public industry data, the right way

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.

Command docs

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 Pulse

This 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 Radar

Scan 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 Scorecard

Score 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 Heatmap

Lay 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 Audit

How 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 Tracker

Before/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 Grader

Grade 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.

One tool is the headline KPIget_brand_overview’s aigvr.score / mentionRate / citationRate are the numbers shown at the top of /overview. Nothing else is the headline.
Never average a daily seriesDaily rates are weighted by that day’s completed records. For a window value read the totals row, or re-weight by completedRecords — a plain arithmetic mean will not match the dashboard.
A missing day is not a zeroA gap in the daily line means no monitoring ran that day, not zero visibility. Check completedRecords: 0 or an absent row means nothing was collected.
Mention ≠ citation, AIGVR ≠ shareA mention is being named; a citation is one of your pages actually being referenced. AIGVR is absolute visibility, Share of Model is your share against competitors. Neither pair substitutes for the other.
The board counts only brands you trackget_brand_board uses the tracked_brand_v1 caliber: rank and share are computed across you plus the competitors you added. Never put it in one table with get_platform_matrix’s discovered-brand caliber.

Three ways to install.Pick whichever is easiest.

Skill docs
Run in your project folder
npx skills add geoly-ai/agent-skills
Installs 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.