Agent skill

Geo Difficulty

by OpenClaudia in OpenClaudia/openclaudia-skills

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…

MITAuto-check passedMarketing & SEO

Install Geo Difficulty

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills geo-difficulty --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/geo-difficulty .claude/skills/geo-difficulty && rm -rf skills-src

Use ~/.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/

Facts

Skill name
geo-difficulty
GitHub stars
711
Token cost
~694 tokens
SKILL.md length
291 words
Files
2 (incl. scripts)
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

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…

  • The user asks how hard is <keyword to rank
  • SKILL.md covers Usage, Output columns and Notes
  • Runs Shell scripts from its folder; calls bash and curl; reaches enception.ai
  • Geo difficulty for <keyword

What it does

Geo Difficulty is an agent skill from OpenClaudia/openclaudia-skills. 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'.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/score.sh`).

It sits in Marketing & SEO, covering AI search optimization and Keyword research. It works with Ahrefs. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user asks how hard is <keyword to rank
  • Geo difficulty for <keyword
  • Keyword difficulty for <domain

Example prompts

  • “s AI Overview. Use when the user asks”
  • “geo difficulty for <keyword”
  • “keyword difficulty for <domain”
  • “/geo-difficulty”

Requirements

  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. 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 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • enception.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Geo Difficulty loads about 694 tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 291 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~694

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 passed

The automated check found no risky patterns in SKILL.md.

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 OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 291 words, ~694 tokens.

Download SKILL.mdSave it as .claude/skills/geo-difficulty/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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.
  • Numbers shift day to day as SERPs and UR change — treat as a current snapshot, not a fixed grade.
  • Each keyword takes a few seconds server-side; keep --max-time generous for batches.

© OpenClaudia, 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 1 other file (scripts) in skills/geo-difficulty of OpenClaudia/openclaudia-skills.

  • SKILL.md
  • scripts/score.sh

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Geo Difficulty 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.

Geo Difficulty compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Geo Difficulty this skillOpenClaudia/openclaudia-skills711—~694Automated safety check: PassMIT
SEO DataforseoAgriciDaniel/codex-seo7912 repos~4.6kAutomated safety check: PassMIT
Keyword Researchnowork-studio/notfair-plugin3.9k1 repos~2.6kAutomated safety check: PassMIT
Competitor GapRyze-AI-Adgent/open-seo-mcp-skills4.5k—~560Automated safety check: PassMIT
Research Keywordsonvoyage-ai/gtm-engineer-skills1.3k—~4kAutomated safety check: PassMIT
Keyword ResearchRyze-AI-Adgent/open-seo-mcp-skills4.5k—~581Automated safety check: PassMIT

Similar skills

  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    791 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • Keyword Research

    nowork-studio/notfair-plugin

    Finds, scores and groups keywords from a seed term or niche for SEO and AI search content strategies, with intent labels, difficulty estimates and topic clusters.

    3.9k GitHub starsUsed in 1 repo~2.6k tokens
    Marketing & SEOAuto-check passed
  • Competitor Gap

    Ryze-AI-Adgent/open-seo-mcp-skills

    Find keywords a competitor ranks for that the user's site doesn't — the content gap, prioritized by volume and winnability.

    4.5k GitHub stars~560 tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Research Keywords

    onvoyage-ai/gtm-engineer-skills

    Finds high-value SEO and GEO keywords using web search, AI analysis, and optionally paid tools like Ahrefs or Semrush.

    1.3k GitHub stars~4k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Keyword Research

    Ryze-AI-Adgent/open-seo-mcp-skills

    Keyword research from a seed topic — ideas, real Google volume/CPC, intent, difficulty, clustered into a plan.

    4.5k GitHub stars~581 tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • DataForSEO Live SEO Data

    AgriciDaniel/claude-seo

    Pulls live SERP results, keyword metrics, backlink profiles and AI visibility data through the DataForSEO MCP server, with a cost check before each call.

    18k GitHub stars~4.4k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    711 GitHub stars~1.2k tokensUpdated 20 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    711 GitHub stars~1k tokensUpdated 20 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    711 GitHub stars~882 tokensUpdated 20 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    711 GitHub stars~1.9k tokensUpdated 20 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    711 GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed
  • Affiliate Marketing

    OpenClaudia/openclaudia-skills

    Build and manage an affiliate marketing program. An agent skill from OpenClaudia/openclaudia-skills.

    711 GitHub stars~2.2k tokensUpdated 20 days ago
    Auto-check passed

Works with

Categories

Questions about Geo Difficulty

What does Geo Difficulty do?

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…. Geo Difficulty is an agent skill from OpenClaudia/openclaudia-skills. 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.

When should I use Geo Difficulty?

Geo Difficulty fits situations like: the user asks how hard is <keyword to rank; geo difficulty for <keyword; keyword difficulty for <domain.

How do I install Geo Difficulty in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a claude-code`. Or copy the skill folder (skills/geo-difficulty in OpenClaudia/openclaudia-skills) into .claude/skills/geo-difficulty in your project. Claude Code loads it when a task matches its description.

How do I install Geo Difficulty in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill geo-difficulty -a codex`. Or copy the skill folder (skills/geo-difficulty in OpenClaudia/openclaudia-skills) into .agents/skills/geo-difficulty in your project. Codex loads it when a task matches its description.

Can I use Geo Difficulty 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 OpenClaudia/openclaudia-skills --skill geo-difficulty -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-difficulty, .gemini/skills/geo-difficulty, .github/skills/geo-difficulty and .opencode/skills/geo-difficulty in your project.

What does Geo Difficulty need to run?

Going by SKILL.md and its folder, Geo Difficulty needs a shell for the scripts in its folder and the command-line tools its instructions call (bash and curl). Our summary lists: A Bash shell.

Does Geo Difficulty access the network?

SKILL.md names 1 domain. In commands or code: enception.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Geo Difficulty safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Difficulty use?

Geo Difficulty 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 Difficulty use?

About 694 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Geo Difficulty?

Skills that share tags, products or a category with Geo Difficulty: SEO Dataforseo (AgriciDaniel/codex-seo, 791 stars), Keyword Research (nowork-studio/notfair-plugin, 3.9k stars), Competitor Gap (Ryze-AI-Adgent/open-seo-mcp-skills, 4.5k stars) and Research Keywords (onvoyage-ai/gtm-engineer-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Geo Difficulty?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 711 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.