Agent skill

Geo Analysis

by OpenClaudia in OpenClaudia/openclaudia-skills

Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and…

MITAuto-check passedMarketing & SEO

Install Geo Analysis

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

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

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills geo-analysis --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-analysis .claude/skills/geo-analysis && 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-analysis
GitHub stars
713
Token cost
~1.1k tokens
SKILL.md length
373 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and…

  • Works in 4 steps: Start → Status → Report → …
  • The user says run a client analysis
  • SKILL.md covers Requirements, 1. Start, 2. Status and 3. Report, plus 1 more section
  • Calls curl; reaches enception.ai; needs ENCEPTION_ANALYSIS_API_KEY

What it does

Geo Analysis is an agent skill from OpenClaudia/openclaudia-skills. Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and competitors. Use when the user says 'run a client analysis', 'analyze <domain for GEO', 'GEO analysis for <domain', or 'check analysis status'.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering AI search optimization, Market research and PDF. 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 says run a client analysis
  • Analyze <domain for GEO
  • GEO analysis for <domain
  • Check analysis status

Example prompts

  • “run a client analysis”
  • “analyze <domain for GEO”
  • “GEO analysis for <domain”
  • “/geo-analysis”

Requirements

  • A credential in ENCEPTION_ANALYSIS_API_KEY

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Start
  2. Status
  3. Report
  4. Fix "zero visibility" (brand-name correction)

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

    Shell commands in SKILL.md call:

    • 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 these keys or tokens, usually read from environment variables:

    • ENCEPTION_ANALYSIS_API_KEY

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

Context cost

Geo Analysis loads about 1.1k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 373 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 373 words, ~1,053 tokens.

Download SKILL.mdSave it as .claude/skills/geo-analysis/SKILL.md (or your agent's skills folder).
name
geo-analysis
description
Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and competitors. Use when the user says 'run a client analysis', 'analyze <domain> for GEO', 'GEO analysis for <domain>', or 'check analysis status'.

GEO Analysis

Run a full GEO/SEO analysis for a domain and get a client-ready PDF report: AI visibility (is the brand recommended by ChatGPT / Google AI), deep market research, and competitor landscape.

Thin wrapper over the Enception client-analysis API. Three operations: start, status, report (plus an optional brand-name correction).

Disclosure: contributed by Enception AI and calls Enception's paid external API. Docs: https://www.enception.ai/doc/api-client-analysis

Requirements

  • ENCEPTION_ANALYSIS_API_KEY — sent as the x-api-key header. Self-serve: sign up at https://www.enception.ai, then generate a free-tier key under Account → API Key (2 analyses/month free; contact the team for higher limits). Rate limit: 10 requests/minute.

1. Start

POST https://www.enception.ai/api/external/client-analysis/start

Required: website_url, primary_region, core_goals. Sensible defaults: primary_region=us, core_goals=traffic, output_language=en, competitors=[]. The API normalizes URLs to a bare domain and rejects IPs. Returns { id, message } — save the id.

Pick output_language from an explicit request first, then the user's conversation language, then the domain TLD (.cn → zh; otherwise en).

bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'

Only override primary_region / core_goals / competitors if the user specifies. core_goals is free text (e.g. traffic, ranking). Competitors: [{"name":"X","domain":"x.com"}, ...] (max 5). For multiple domains, fire one POST each and collect the ids.

2. Status

POST https://www.enception.ai/api/external/client-analysis/status with body { "id": "<id>" } and the same x-api-key header. Returns { status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? }.

A full run takes ~20–45 minutes — the bottleneck is the deep market-research step. Poll on a long interval (minutes, not seconds). succeeded ⇒ ready to fetch the report. If a run fails or stalls indefinitely, report that to the user rather than inventing results.

Show full SKILL.md (132 more words)Show less

3. Report

GET https://www.enception.ai/api/external/client-analysis/report/<id> — public, no auth; shareable by id. Works once status is succeeded (also serves partial runs).

bash
curl -s -o geo-analysis-example.pdf \
  "https://www.enception.ai/api/external/client-analysis/report/<id>"

Confirm it's a real PDF (file geo-analysis-example.pdf), then give the user the file and/or the public URL.

4. Fix "zero visibility" (brand-name correction)

POST https://www.enception.ai/api/external/client-analysis/update-brand with body { "id", "brand_name"?, "alternative_names": [...] } and the x-api-key header.

When a report shows zero/low AI visibility but the brand IS recommended by ChatGPT/Google, it's almost always because the brand is only known by its fused domain label (e.g. pudurobotics) while AI engines say "Pudu Robotics". Supply the real name + aliases and the route recomputes visibility from the already-stored answers (no re-query — fast), then re-fetch the report.

bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'

Returns { success, mention_rate, overall_score, average_position, analysis_regenerated }. New analyses resolve the brand name automatically; this is the manual correction path for existing reports.

© 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

Just SKILL.md in skills/geo-analysis of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Geo Analysis 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 Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Geo Analysis this skillOpenClaudia/openclaudia-skills713—~1.1kAutomated safety check: PassMIT
Data And Original Researchsocial-media-skills/skills128—~2kAutomated safety check: PassMIT
Listicle And Roundupsocial-media-skills/skills128—~1.9kAutomated safety check: PassMIT
Client Deliverablesgarrettjsmith/localseoskills120—~5.8kAutomated safety check: PassMIT
Market Analysisqusong0627/QuantMind1.7k—~1kAutomated safety check: PassAGPL-3.0
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT

Similar skills

  • Data And Original Research

    social-media-skills/skills

    The original-research / data-study content type — turn proprietary data, a survey, a public-dataset analysis, or an experiment into the most linkable and AI-citable asset you can publish.

    128 GitHub stars~2k tokensUpdated 8 days ago
    Marketing & SEOAuto-check passed
  • Listicle And Roundup

    social-media-skills/skills

    The list/roundup content type — design honestly-curated, scannable, AI-citable listicles ("7 ways to X", "best tools for Y") and expert / product / link roundups.

    128 GitHub stars~1.9k tokensUpdated 8 days ago
    Marketing & SEOAuto-check passed
  • Client Deliverables

    garrettjsmith/localseoskills

    When the user needs to create a client-facing document such as an SEO audit, proposal, scope of work, competitive analysis report, onboarding document, or market intelligence report.

    120 GitHub stars~5.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Market Analysis

    qusong0627/QuantMind

    市场分析报告(大盘快照版)— 复用市场分析页面全部数据能力:核心指数、市场广度与情绪温度、行业板块/热门概念热力图、行业多日涨跌幅对比(1/3/5日)、板块资金流(1日/5日/10日)、个股主力资金 Top20、标签体系统计。用户说「市场分析」「大盘分析」「行情分析」「今天市场怎么样」「市场报告」时使用:跑取数脚本(marketanalysis.py)→ AI 基于 facts 撰写解读 →…

    1.7k GitHub stars~1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    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…

    713 GitHub stars~1.2k tokensUpdated 21 days ago
    Auto-check passed
  • Geo Difficulty

    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…

    713 GitHub stars~694 tokensUpdated 21 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…

    713 GitHub stars~1k tokensUpdated 21 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.

    713 GitHub stars~882 tokensUpdated 21 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

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

    713 GitHub stars~1.9k tokensUpdated 21 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.

    713 GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed

Categories

Questions about Geo Analysis

What does Geo Analysis do?

Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and…. Geo Analysis is an agent skill from OpenClaudia/openclaudia-skills. Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and competitors.

When should I use Geo Analysis?

Geo Analysis fits situations like: the user says run a client analysis; analyze <domain for GEO; GEO analysis for <domain; check analysis status.

How do I install Geo Analysis in Claude Code?

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

How do I install Geo Analysis in Codex?

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

Can I use Geo Analysis 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-analysis -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-analysis, .gemini/skills/geo-analysis, .github/skills/geo-analysis and .opencode/skills/geo-analysis in your project.

What does Geo Analysis need to run?

Going by SKILL.md and its folder, Geo Analysis needs the command-line tools its instructions call (curl) and credentials named ENCEPTION_ANALYSIS_API_KEY. Our summary lists: A credential in ENCEPTION_ANALYSIS_API_KEY.

Does Geo Analysis 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 Analysis 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. Review the folder before installing.

What licence does Geo Analysis use?

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

About 1.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.

What are the alternatives to Geo Analysis?

Skills that share tags, products or a category with Geo Analysis: Data And Original Research (social-media-skills/skills, 128 stars), Listicle And Roundup (social-media-skills/skills, 128 stars), Client Deliverables (garrettjsmith/localseoskills, 120 stars) and Market Analysis (qusong0627/QuantMind, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Geo Analysis?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 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.