How do I install the Geo Citation Audit skill?

Run npx skillmds@latest add lionelndong/geo-citation-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Geo Citation Audit safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Geo Citation Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Geo Citation Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Geo Citation Audit?

lionelndong (@lionelndong) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Geo Citation Audit by lionelndong — Agent Skill

Name: Geo Citation Audit
Rating: 4.2 (5 reviews)
Author: lionelndong

Geo Citation Audit

Measure pleasur.ai's AI-citation share across ChatGPT / Perplexity / Gemini / Google AI Overviews for the tracked query list, using SemRush (data API for AIO-presence screening + AI Toolkit via browser for share-of-voice / mention + citation gaps) and direct engine queries. Scores each query into the GEO ledger and surfaces the highest-leverage gaps to fix. The GEO Lead's core measurement loop.

lionelndong Updated Aug 19, 2026 0 repo stars

File contents

GEO Citation Audit

The measurement half of the GEO loop. Turns the tracked query list into a scored citation ledger and a ranked list of "competitor cited, we're not" gaps to prescribe fixes for. SemRush is the mandated instrument — see GEO-PLAYBOOK.md (instructions bundle) for the full method; this skill is the repeatable procedure.

Input

life/resources/geo-queries.md — tracked queries by cluster + competitor list. If absent, build it first (category + competitor + "best AI girlfriend / companion / NSFW chat" intent prompts; align clusters with EO's keyword clusters).
life/resources/geo-ledger.csv — prior scores (for week-over-week deltas).
SEMRUSH_API_KEY, SEMRUSH_USERNAME, SEMRUSH_PASSWORD, FIRECRAWL_API_KEY, POSTHOG_* via Doppler.

Process

Screen AIO presence (cheap, SemRush data API). For the due queries, batch phrase_these / phrase_this with export_columns=Ph,Nq,Fk and read the SERP-features list; the AI-Overview feature code flags which queries even trigger a Google AI Overview. Confirm the current AIO code once against a query you know shows one. Drop queries that never trigger AIO from the Google-AIO column (don't optimize a surface that isn't there). Cost: ~10 units/line.
Pull SemRush AI Toolkit (browser — the high-value surface). Drive the always-on VPS Chrome (claude-in-chrome), logged into semrush.com with the Doppler creds, to the AI Toolkit. Capture, filtered to our topics ("ai girlfriend", "ai companion", "nsfw ai chat"):
- AI Share of Voice (us vs tracked competitors), by engine.
- Mentions + impressions + trend.
- AI mention gap (competitors mentioned, not us) and AI citation gap (pages cite competitors, not us) → the Cited-pages target list. If the AI Toolkit is gated behind an add-on not on the plan, record the exact entitlement + price and escalate in the report (don't fake the numbers); proceed with steps 1, 3, 4.
Direct-query the priority queries (ground truth). For the top ~10 due queries, ask the engines directly — VPS Chrome for ChatGPT / Gemini / Google AI Overview; Perplexity via its API or browser. Record verbatim: cited? (y/n), position/prominence, sentiment, and which competitor is cited if we aren't. Save evidence snippets.
Score into the ledger. For each query × platform write cited?, position, sentiment, last_checked, fix_filed, wow_delta to life/resources/geo-ledger.csv. Compute the GEO score (visibility + position + sentiment) and the citation-share total + WoW trend.
Surface the gaps. Emit a ranked list of the highest-leverage gaps (intent × answerable × right-to-win) where competitors are cited and we're absent — this feeds the GEO loop's 2 daily fixes (prescribe → hand to EO / CTO / Affiliates / Community Lead per GEO-PLAYBOOK.md).

Output

Updated life/resources/geo-ledger.csv (scored, with WoW deltas).
A ranked gap list (query, platform, competitor-cited, suggested fix-type + owner) for the fix loop.
AI-driven traffic note from PostHog (AI/LLM referrers → sessions/signups) for the trend.

Quality bar

Every "cited" verdict backed by a captured snippet (no guessing).
AIO-presence screen done before scoring the Google-AIO column.
AI Toolkit numbers are real pulls or an explicit "gated — escalated" note, never fabricated.
Adult-reality honesty: mark hard-blocked surfaces and stop scoring them.

When to run

Every GEO measurement cycle (per HEARTBEAT.md), and on demand before a monthly GEO report.

---name: geo-citation-auditdescription: Measure pleasur.ai's AI-citation share across ChatGPT / Perplexity / Gemini / Google AI Overviews for the tracked query list, using SemRush (data API for AIO-presence screening + AI Toolkit via browser for share-of-voice / mention + citation gaps) and direct engine queries. Scores each query into the GEO ledger and surfaces the highest-leverage gaps to fix. The GEO Lead's core measurement loop.---# GEO Citation AuditThe measurement half of the GEO loop. Turns the tracked query list into a scored citation ledger anda ranked list of "competitor cited, we're not" gaps to prescribe fixes for. **SemRush is themandated instrument** — see `GEO-PLAYBOOK.md` (instructions bundle) for the full method; this skillis the repeatable procedure.## Input- `life/resources/geo-queries.md` — tracked queries by cluster + competitor list. If absent, build it first (category + competitor + "best AI girlfriend / companion / NSFW chat" intent prompts; align clusters with EO's keyword clusters).- `life/resources/geo-ledger.csv` — prior scores (for week-over-week deltas).- `SEMRUSH_API_KEY`, `SEMRUSH_USERNAME`, `SEMRUSH_PASSWORD`, `FIRECRAWL_API_KEY`, `POSTHOG_*` via Doppler.## Process1. **Screen AIO presence (cheap, SemRush data API).** For the due queries, batch `phrase_these` / `phrase_this` with `export_columns=Ph,Nq,Fk` and read the SERP-features list; the AI-Overview feature code flags which queries even trigger a Google AI Overview. Confirm the current AIO code once against a query you know shows one. Drop queries that never trigger AIO from the Google-AIO column (don't optimize a surface that isn't there). Cost: ~10 units/line.2. **Pull SemRush AI Toolkit (browser — the high-value surface).** Drive the always-on VPS Chrome (claude-in-chrome), logged into semrush.com with the Doppler creds, to the AI Toolkit. Capture, filtered to our topics ("ai girlfriend", "ai companion", "nsfw ai chat"): - AI Share of Voice (us vs tracked competitors), by engine. - Mentions + impressions + trend. - **AI mention gap** (competitors mentioned, not us) and **AI citation gap** (pages cite competitors, not us) → the Cited-pages target list. If the AI Toolkit is gated behind an add-on not on the plan, record the exact entitlement + price and escalate in the report (don't fake the numbers); proceed with steps 1, 3, 4.3. **Direct-query the priority queries (ground truth).** For the top ~10 due queries, ask the engines directly — VPS Chrome for ChatGPT / Gemini / Google AI Overview; Perplexity via its API or browser. Record verbatim: cited? (y/n), position/prominence, sentiment, and which competitor is cited if we aren't. Save evidence snippets.4. **Score into the ledger.** For each query × platform write `cited?, position, sentiment, last_checked, fix_filed, wow_delta` to `life/resources/geo-ledger.csv`. Compute the GEO score (visibility + position + sentiment) and the citation-share total + WoW trend.5. **Surface the gaps.** Emit a ranked list of the highest-leverage gaps (intent × answerable × right-to-win) where competitors are cited and we're absent — this feeds the GEO loop's 2 daily fixes (prescribe → hand to EO / CTO / Affiliates / Community Lead per `GEO-PLAYBOOK.md`).## Output- Updated `life/resources/geo-ledger.csv` (scored, with WoW deltas).- A ranked gap list (query, platform, competitor-cited, suggested fix-type + owner) for the fix loop.- AI-driven traffic note from PostHog (AI/LLM referrers → sessions/signups) for the trend.## Quality bar- Every "cited" verdict backed by a captured snippet (no guessing).- AIO-presence screen done before scoring the Google-AIO column.- AI Toolkit numbers are real pulls or an explicit "gated — escalated" note, never fabricated.- Adult-reality honesty: mark hard-blocked surfaces and stop scoring them.## When to runEvery GEO measurement cycle (per HEARTBEAT.md), and on demand before a monthly GEO report.

Frequently asked questions