geo-gap-fixer

Category: GTM Intelligence · Version: 1.0.0 · Author: ajaycodesitbetter · Compatibility: All targets (claude, codex, opencode, gemini, anti-gravity, openclaw, hermes)

Audit how often LLMs recommend your brand vs. competitors — then get a concrete action plan to fix the gaps.

Install

npx CLI (Recommended)
skills.sh
Claude Code Native
Claude Desktop
Manus AI

npx "@opendirectory.dev/skills" install geo-gap-fixer --target claude

npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

Copy https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into download-directory.github.io to download the ZIP.
Open Claude Desktop -> Customize -> Skills -> + -> Upload a skill and drop the folder containing SKILL.md.

Why this skill exists

In 2026, buyers discover tools by asking ChatGPT, Claude, Gemini, and Perplexity “what’s the best X for Y?” — not by Googling. If LLMs consistently recommend a competitor instead of you, your traditional SEO rank is irrelevant. geo-gap-fixer is a free, open-source agent skill for GTM Intelligence that audits your Generative Engine Optimization (GEO) share-of-voice. It probes the LLMs, analyzes who gets recommended, and outputs a prioritized content backlog to fix the gaps.

One skill run replaces a $200/month AI-monitoring SaaS subscription.

Sample Report Output

### 1. Share of Voice (LLM Mention Rate)
| Brand | Mention Rate | Avg Rank | Win Rate | Assessment |
|-------|-------------|----------|----------|------------|
| **Linear** | **18.4%** | **4.2** | **5.3%** | 🔴 Critical: Brand is rarely recommended |
| Jira | 94.7% | 1.4 | 82.1% | 🟢 Dominant: Default recommendation |

### 5. GEO Action Plan
🔴 **Critical Priority: Fix Mention Rate (<30%)**
- Create dedicated "Best <Category> Tools in 2026" comparison content.
- Ensure your homepage explicitly answers: "Why use Linear for <Category>?"

What You Get

#	Output Section	Description
1	Share-of-Voice Table	Brand mention rate per LLM (% of prompts where you’re mentioned), ranked
2	Prompt-Level Loss Log	Which exact prompts your brand lost and to whom
3	Competitor Language Patterns	What framing/keywords LLMs use for competitors that they don’t use for you
4	Citation Gap List	Which domains get cited by LLMs instead of your site
5	GEO Action Plan	Prioritized fixes: FAQ pages, comparison pages, alternative pages, schema improvements, authority targets

Prerequisites

Python 3.10+
At least 2 of 4 API keys (missing providers are skipped gracefully)
Dependencies: pip install openai anthropic google-genai

Provider	Package	Model	Env Variable
OpenAI	`openai`	gpt-4o	`OPENAI_API_KEY`
Anthropic	`anthropic`	claude-sonnet-4-6	`ANTHROPIC_API_KEY`
Google	`google-genai`	gemini-2.5-flash	`GOOGLE_API_KEY`
Perplexity	`openai` (reused)	sonar-pro	`PERPLEXITY_API_KEY`

Note: Perplexity uses the OpenAI SDK with a different base URL, so only 3 packages are needed.

Configuration (`config.json`)

Field	Type	Required	Description
`brand_name`	string	✅	Your brand name (e.g., “Linear”)
`competitors`	list	✅	1–10 competitor brand names
`category`	string	✅	Product category (e.g., “project management tool for developers”)
`buyer_intent_prompts`	list	❌	Custom prompts. Empty = auto-generate from templates
`target_llms`	list	❌	Which LLMs to probe. Default: all 4
`website_url`	string	❌	Your website for citation gap analysis

Limitations (What this skill does NOT do)

Not a continuous monitor: This is a point-in-time audit. Run it monthly to track progress.
Not for traditional SEO: It does not track Google Blue Link rankings, domain authority, or keyword search volume.
Not deep NLP sentiment analysis: Sentiment uses keyword proximity, not complex NLP models.
Not free to run: While the tool is free, you pay the LLM API providers directly (typically ~ $0.50–$ 2.00 per audit).

Error Handling

All scripts are designed to fail clearly, not silently:

Scenario	Behavior
Invalid JSON config	Exits with parse error and line number
Missing required fields	Exits listing exactly which fields are missing
No API keys set	Exits listing all 4 env variable names
Transient API failure	Retries with exponential backoff (2 attempts, 2s → 4s)
Persistent API failure	Skips that provider, continues with others
Zero responses collected	Exits non-zero after saving empty results
Missing upstream data file	Exits with instructions to run the previous script

File Structure

geo-gap-fixer/
├── README.md              ← You are here
├── SKILL.md               ← Agent instruction flow
├── .env.example           ← API key template
├── .gitignore             ← Excludes data/, report/, config.json
├── package.json           ← OpenDirectory metadata
├── config.example.json    ← Sample configuration
├── scripts/
│   ├── probe_llms.py      ← Send prompts to LLM APIs
│   ├── analyze_results.py ← Extract mentions, rank, sentiment, citations
│   └── build_report.py    ← Assemble the 5-section report
├── references/
│   ├── prompt_templates.md  ← 20 default buyer-intent prompts
│   ├── scoring_rubric.md    ← How metrics are calculated
│   └── output_format.md    ← Sample report with realistic data
├── data/                  ← Generated at runtime (gitignored)
│   ├── raw_responses.json
│   └── analysis.json
└── report/                ← Generated at runtime (gitignored)
    ├── geo_audit_report.md
    └── geo_audit_report.json

Catalog

Visual & Media

Content

Launch

GTM Intelligence

Outreach

Research

Developer Tools

Other

Install

Why this skill exists

Sample Report Output

What You Get

Prerequisites

Configuration (`config.json`)

Limitations (What this skill does NOT do)

Error Handling

File Structure

​Install

​Why this skill exists

​Sample Report Output

​What You Get

​Prerequisites

​Configuration (config.json)

​Limitations (What this skill does NOT do)

​Error Handling

​File Structure

Install

Why this skill exists

Sample Report Output

What You Get

Prerequisites

Configuration (`config.json`)

Limitations (What this skill does NOT do)

Error Handling

File Structure