geo-difficulty

Scores keyword ranking difficulty using page-level URL Rating, Ahrefs KD, and AI Overview citation data.

674|51|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/OpenClaudia/openclaudia-skills --skill geo-difficulty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geo-difficulty
Source: https://github.com/OpenClaudia/openclaudia-skills/tree/main/skills/geo-difficulty
Command: npx skills add https://github.com/OpenClaudia/openclaudia-skills --skill geo-difficulty

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Traditional keyword difficulty scores rely on domain-level ratings, which overstate difficulty when big domains rank with generic pages. This Skill scores how hard a keyword actually is to rank for by analyzing the page-level URL Rating of the real competitors, and tells you whether your own site already ranks or is cited in Google's AI Overview.

Core Features & Use Cases

  • Page-level difficulty scoring: Combines Ahrefs keyword difficulty, median competitor page URL Rating, and targeting percentage into a 0-100 absolute difficulty score.
  • Client-relative verdicts: Pass a domain to get a WON, FOOTHOLD, or NOT RANKING verdict that accounts for your site's current position and AI Overview citations.
  • AI Overview signal: Detects whether Google shows an AI Overview for the query and whether your site is cited in it.
  • Use Case: Before writing content targeting "ai presentation maker", run the skill with your domain to learn the keyword scores 58 absolute difficulty, your site is NOT RANKING, and three competitors hold the top positions with UR 40+ pages.

Quick Start

Ask the AI to score the keyword difficulty of "ai form real estate" for the domain example.com using the geo-difficulty skill.

Frequently Asked Questions about geo-difficulty

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check keyword difficulty for a specific domain?

Run the score.sh script with your keywords and the --client flag followed by your domain. The output includes a client_verdict column showing WON, FOOTHOLD, or NOT RANKING, plus a client_difficulty score adjusted for your site's current position.

What is the difference between page-level URL Rating and domain rating for keyword difficulty?

Page-level URL Rating measures the authority of the exact page ranking for a query, while domain rating measures the whole site. A generic article on a high-DR domain like mckinsey.com inflates domain-based scores, so page-level UR gives a more realistic difficulty estimate.

Does this keyword difficulty tool require an API key?

No API key is required. The skill calls the free public enception.ai geo-difficulty endpoint, which sources its data server-side from Ahrefs and SerpAPI.

How many keywords can I score in one call?

You can pass up to 10 keywords per call, each quoted as a separate argument. Each keyword takes a few seconds server-side, so keep the curl max-time generous for batches.

Why does the AI Overview column show n/a for some keywords?

The AI Overview leg depends on Google actually showing an AIO for that query, which is intermittent. When no AIO is available, the column degrades gracefully to none or n/a without affecting the rest of the score.