Beyondseo
beyondtahir/beyondseo
Audit websites, apply authorised SEO improvements and plan content, competitors and backlinks with evidence, design checks and optional project monitoring.
Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.
Install Geo Gap Fixer
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/geo-gap-fixer .claude/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.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/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .claude/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/geo-gap-fixer .agents/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .agents/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/geo-gap-fixer .cursor/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .cursor/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Varnan-Tech/opendirectory.git --path skills/geo-gap-fixer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/geo-gap-fixer .gemini/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .gemini/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/geo-gap-fixer .github/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .github/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Varnan-Tech/opendirectory geo-gap-fixer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/geo-gap-fixer .opencode/skills/geo-gap-fixer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "geo-gap-fixer" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/geo-gap-fixer into .opencode/skills/geo-gap-fixer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-gap-fixer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
geo-gap-fixer- GitHub stars
- 674
- Token cost
- ~1k tokens
- SKILL.md length
- 545 words
- Files
- 12 (incl. scripts, references)
- Skills in repo
- 61
- Repo updated
- First seen
- Licence
- MIT
At a glance
Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.
- Works in 4 steps: Inputs → Execution Pipeline → Outputs & Interpretation → …
- Tasks that involve AI search optimization
- SKILL.md covers When to Use, Step 1: Inputs, Step 2: Execution Pipeline and Step 3: Outputs & Interpretation, plus 1 more section
- Runs Python scripts from its folder; calls python and pip; needs OPENAI_API_KEY and ANTHROPIC_API_KEY
What it does
Geo Gap Fixer is an agent skill from Varnan-Tech/opendirectory. Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts and reference files (for example `README.md`, `config.example.json` and `package.json`).
It sits in Marketing & SEO, covering AI search optimization. It works with Python. The repository describes itself as: AI Agent Skills built for Founders who hate Marketing. The licence is MIT.
When your agent uses it
- Tasks that involve AI search optimization
Example prompts
- “/geo-gap-fixer”
Requirements
- Python 3
- A credential in OPENAI_API_KEY
- A credential in ANTHROPIC_API_KEY
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 62e437a. 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
Ships 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonpip
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 these keys or tokens, usually read from environment variables:
OPENAI_API_KEYANTHROPIC_API_KEYGOOGLE_API_KEYPERPLEXITY_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Geo Gap Fixer loads about 1k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 545 words of instructions outside code blocks.
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
keys must be set in the environment or `.env` file (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, `PERPLEXIT
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); the scripts in this folder are not scanned.
SKILL.md
The full file from Varnan-Tech/opendirectory at commit 62e437a, republished under its MIT licence (© Varnan-Tech). 545 words, ~1,044 tokens.
Download SKILL.mdSave it as
.claude/skills/geo-gap-fixer/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.- name
- geo-gap-fixer
- description
- Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.
- category
- GTM Intelligence
- version
- 1.0.0
GEO Gap Fixer
Agent skill that audits LLM brand visibility and converts gaps into a concrete GEO content action plan.
When to Use
Use this skill when a user wants to audit their Generative Engine Optimization (GEO) share-of-voice to know which LLM prompts their brand is losing, understand why competitors are recommended instead, and get a specific content fix plan.
Do NOT use this skill for: general SEO audits, paid ad optimization, or continuous social media monitoring. This is a point-in-time LLM visibility audit.
Step 1: Inputs
To run the audit, the user must provide API keys and a configuration file. Ensure the following are set up:
- API Keys: At least 2 of 4 keys must be set in the environment or
.envfile (OPENAI_API_KEY,ANTHROPIC_API_KEY,GOOGLE_API_KEY,PERPLEXITY_API_KEY). - Dependencies:
pip install openai anthropic google-genai - Config File:
config.json(copied fromconfig.example.json) must contain:brand_name(string, required)competitors(list of strings, required, 1-10 entries)category(string, required)buyer_intent_prompts(list of strings, optional. If empty, 20 prompts are auto-generated)target_llms(list of strings, optional)website_url(string, optional)
Step 2: Execution Pipeline
Run the following scripts in order. Stop and ask for clarification if any script fails.
python scripts/probe_llms.py(Optional: append--dry-runto test config without API calls)- Sends buyer-intent prompts to the configured LLM APIs.
- Saves responses to
data/raw_responses.json.
python scripts/analyze_results.py- Analyzes raw responses for brand mentions, ranking, sentiment, and cited domains.
- Saves structured analysis to
data/analysis.json.
python scripts/build_report.py- Assembles the final 5-section GEO audit report.
- Saves to
report/geo_audit_report.mdandreport/geo_audit_report.json.
Step 3: Outputs & Interpretation
The primary output is report/geo_audit_report.md. Present its findings to the user.
Key Sections to Interpret:
- Share-of-Voice Table: A mention rate below 30% is critical. Mention rate is the % of prompts where the brand is recommended.
- Prompt-Level Loss Log: Which exact prompts the brand lost and to whom.
- Competitor Language Patterns: The specific adjectives LLMs use for competitors.
- Citation Gap List: Domains LLMs cite that the brand is missing from.
- GEO Action Plan: Prioritized fixes (🔴 Critical, 🟡 High Priority, 🟢 Growth Plays).
Direct the user to the GEO Action Plan first, as it contains the concrete steps to fix the gaps identified in the audit.
Show full SKILL.md (180 more words)Show less
Step 4: Error Handling
If you encounter issues while executing the pipeline, follow these rules:
| Condition | Agent Action |
|---|---|
Missing config.json | Tell the user to copy config.example.json and fill it out. |
| Invalid JSON in config | Notify the user of the parse error location and ask them to fix it. |
| Missing required fields | List the exact missing fields (brand_name, competitors, category). |
| No API keys set | Ask the user to export at least 2 of the 4 supported API keys. |
| 1 API key only | Warn the user that results are less reliable, but proceed with the run. |
| Transient API failure | The script auto-retries. If it fails completely, it skips the provider. |
| Persistent API failure | The script skips the provider gracefully. Continue the pipeline. |
| Zero responses | The script exits non-zero. Notify the user to check API keys or config. |
| Missing upstream data file | Re-run the preceding script in the pipeline (e.g., probe before analyze). |
Limitations to keep in mind:
- This is a point-in-time audit, not a background monitor.
- Sentiment analysis uses keyword proximity, not deep NLP.
- API costs apply for each run (typically ~$0.50–$2.00).
© Varnan-Tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 11 other files (scripts, references) in skills/geo-gap-fixer of Varnan-Tech/opendirectory.
- SKILL.md
- .env.example
- .gitignore
- README.md
- config.example.json
- package.json
- references/output_format.md
- references/prompt_templates.md
- references/scoring_rubric.md
- scripts/analyze_results.py
- scripts/build_report.py
- scripts/probe_llms.py
Open the folder on GitHubat commit 62e437a
Compare with similar skills
Geo Gap Fixer 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Geo Gap Fixer this skillVarnan-Tech/opendirectory | 674 | — | ~1k | Automated safety check: Notes | MIT | |
| Beyondseobeyondtahir/beyondseo | 161 | — | ~4.3k | Automated safety check: Pass | MIT | |
| Geo Site Diagnoseyaojingang/GEOHub | 165 | — | ~515 | Automated safety check: Pass | AGPL-3.0 | |
| Universal SEO AnalysisAgriciDaniel/claude-seo | 19k | — | ~4.9k | Automated safety check: Pass | MIT | |
| GEO Schema Auditorzubair-trabzada/geo-seo-claude | 11k | 2 repos | ~3.7k | Automated safety check: Notes | MIT | |
| Geoyaojingang/GEOHub | 165 | — | ~364 | Automated safety check: Pass | AGPL-3.0 |
Similar skills
Geo Site Diagnose
yaojingang/GEOHub
Crawl one public website from a supplied URL, select up to ten representative page types, score evidence-lined GEO readiness, and generate a standalone visual HTML report.
Universal SEO Analysis
AgriciDaniel/claude-seo
Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.
GEO Schema Auditor
zubair-trabzada/geo-seo-claude
Audits a page's Schema.org structured data for AI discoverability, validates it, generates JSON-LD to fill gaps and writes a GEO-SCHEMA-REPORT.md.
Geo
yaojingang/GEOHub
Route GEO and generative engine optimization requests to an available GEOHub capability.
Geo Content
yaojingang/GEOHub
Create evidence-lined GEO titles, explainers, neutral comparisons, method-backed rankings, page blueprints, refinements, and article-friendly Markdown.
More from Varnan-Tech/opendirectory
All 61 skills in this repoGraphic Ebook
Varnan-Tech/opendirectory
Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.
Docs From Code
Varnan-Tech/opendirectory
Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture.
Graphic Chart
Varnan-Tech/opendirectory
Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6.
Graphic Gif
Varnan-Tech/opendirectory
Creates animated looping GIFs from CSS animations (default) or AI image-to-video.
Map Your Market
Varnan-Tech/opendirectory
Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences…
Newsletter Digest
Varnan-Tech/opendirectory
Aggregates RSS feeds from the past week, synthesizes the top stories using Gemini, and publishes a newsletter digest to Ghost CMS.
Related
Works with
Categories
Questions about Geo Gap Fixer
What does Geo Gap Fixer do?
Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan. Geo Gap Fixer is an agent skill from Varnan-Tech/opendirectory. Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.
When should I use Geo Gap Fixer?
Geo Gap Fixer fits situations like: tasks that involve AI search optimization.
How do I install Geo Gap Fixer in Claude Code?
Run `npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a claude-code`. Or copy the skill folder (skills/geo-gap-fixer in Varnan-Tech/opendirectory) into .claude/skills/geo-gap-fixer in your project. Claude Code loads it when a task matches its description.
How do I install Geo Gap Fixer in Codex?
Run `npx skills add Varnan-Tech/opendirectory --skill geo-gap-fixer -a codex`. Or copy the skill folder (skills/geo-gap-fixer in Varnan-Tech/opendirectory) into .agents/skills/geo-gap-fixer in your project. Codex loads it when a task matches its description.
Can I use Geo Gap Fixer 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 Varnan-Tech/opendirectory --skill geo-gap-fixer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/geo-gap-fixer, .gemini/skills/geo-gap-fixer, .github/skills/geo-gap-fixer and .opencode/skills/geo-gap-fixer in your project.
What does Geo Gap Fixer need to run?
Going by SKILL.md and its folder, Geo Gap Fixer needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY and PERPLEXITY_API_KEY. Our summary lists: Python 3; A credential in OPENAI_API_KEY; A credential in ANTHROPIC_API_KEY.
Does Geo Gap Fixer 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 Geo Gap Fixer 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Geo Gap Fixer use?
Geo Gap Fixer 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 Geo Gap Fixer use?
About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.
What are the alternatives to Geo Gap Fixer?
Skills that share tags, products or a category with Geo Gap Fixer: Beyondseo (beyondtahir/beyondseo, 161 stars), Geo Site Diagnose (yaojingang/GEOHub, 165 stars), Universal SEO Analysis (AgriciDaniel/claude-seo, 19k stars) and GEO Schema Auditor (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 Geo Gap Fixer?
Varnan-Tech (a GitHub organization) maintains it in Varnan-Tech/opendirectory, which has 674 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on August 16, 2026.
Source: Varnan-Tech/opendirectory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.