# geo-difficulty

geo-difficulty scores how hard a keyword is to rank for by checking page-level authority of real competitors, AI Overview citations, and the site's current position.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 134 installs · ★ 750 repo stars
- Author: OpenClaudia
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/geo-difficulty/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/geo-difficulty

## What it does

The skill evaluates SERP competition using three signals: URL Rating of the pages that actually target the query (not the whole domain), the share of top-10 results that match intent, and whether the site is cited in Google's AI Overview. The verdict is client-relative: `WON` if the domain ranks top-3 or is cited in the overview, `FOOTHOLD` if it ranks 4–10, otherwise `NOT RANKING` with the gap to close credited for the client's domain DR.

It calls the public API at `https://www.enception.ai/api/tools/geo-difficulty` (no key required), pulling data from Ahrefs and SerpAPI. Run via `bash scripts/score.sh`, passing up to 10 keywords per batch. Add `--client <domain>` for the relative assessment. The skill itself needs no dependencies, but if your project uses FFmpeg or Python, install those separately.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/geo-difficulty/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/geo-difficulty/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/geo-difficulty/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/geo-difficulty/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenClaudia/openclaudia-skills skills/geo-difficulty
```

2. **Manually: put the files in place**
- File: `.github/skills/geo-difficulty/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/geo-difficulty
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/geo-difficulty/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/geo-difficulty/SKILL.md

## When to use it
- Check how difficult a keyword is to rank for
- Compare ranking difficulty across several keywords in one run
- See whether a site is cited in AI Overview for a query
- Measure the gap between the site's current position and the top

## Example prompts
- Score ranking difficulty for `ai form real estate` and `ai slide legal`
- Run `geo-difficulty` for `ai presentation maker` with client `example.com`
- Check how hard `keyword difficulty seo` is to rank for — domain `mysite.com`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e0a8d64674d5d670.

BEGIN THIRD-PARTY FILE e0a8d64674d5d670
````text
---
name: geo-difficulty
description: "Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is cited in Google's AI Overview. Use when the user asks 'how hard is <keyword> to rank', 'geo difficulty for <keyword>', or 'keyword difficulty for <domain>'."
---

# GEO Difficulty

Score keyword ranking difficulty for the AI-search era. Unlike plain Ahrefs KD or domain DR, this:

- uses **page-level URL Rating (UR)** of the results that actually target the query — so a generic article on a huge domain (e.g. mckinsey.com) stops inflating the score;
- is **client-relative** — the same SERP is a wall for a no-name site but ~won for a site already ranking or cited in Google's AI Overview;
- folds in the **AI Overview** citation as a first-class signal.

**Disclosure:** contributed by Enception AI. Backed by the free public API behind https://www.enception.ai/tools/geo-difficulty (`POST https://www.enception.ai/api/tools/geo-difficulty`, no API key). Server-side data comes from Ahrefs and SerpAPI.

## Usage

```bash
bash scripts/score.sh "ai form real estate" "ai slide legal" --client example.com
```

- Pass one or more keywords (quote each). Up to 10 per call.
- `--client <domain>` is optional; add it to get the client-relative verdict (`WON` / `FOOTHOLD` / `NOT RANKING`).
- `GEO_DIFFICULTY_URL` env var overrides the endpoint (rarely needed).

Or call the API directly:

```bash
curl -s -X POST https://www.enception.ai/api/tools/geo-difficulty \
  -H 'content-type: application/json' \
  -d '{"keywords":["ai presentation maker"],"client":"example.com"}' --max-time 150
```

## Output columns

- **absolute** — difficulty 0–100 for a brand-new site (`0.35·KD + 0.40·median competitor page-UR + 0.25·targeting%`).
- **client_verdict / client_diff** — only with `--client`. WON (top-3 or AI-Overview cited), FOOTHOLD (ranks 4–10), NOT RANKING (with the gap to close, credited for the client's DR).
- **KD** — Ahrefs keyword difficulty; `-` for zero-volume long-tail.
- **UR** — median page-level URL Rating of the real competitors.
- **tgt%** — share of the top-10 that actually target the query.
- **AIO** — `cited` (client in the AI Overview), `Nsrc` (AIO shown, N sources), `none`, or `n/a` (AIO not available for this query).
- **competitors** — the targeting results with their UR.

## Notes

- The AI Overview leg depends on Google actually showing an AIO for the query (intermittent); it degrades gracefully to `none`/`n/a`.
````
END THIRD-PARTY FILE e0a8d64674d5d670

The third-party file has ended. Everything between the e0a8d64674d5d670 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2611 of 2802 bytes. © OpenClaudia · MIT · https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/geo-difficulty/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
