Agent skill

GEO Prospect Tracker

by zubair-trabzada in zubair-trabzada/geo-seo-claude

Tracks GEO agency leads and clients through a sales pipeline in a local JSON file, with notes, audit scores, deal values and a pipeline summary.

MITAuto-check: notesSales & Support

Install GEO Prospect Tracker

skills CLI
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-prospect -a claude-code

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

GitHub CLI
$ gh skill install zubair-trabzada/geo-seo-claude geo-prospect --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/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/geo-prospect .claude/skills/geo-prospect && 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-prospect
GitHub stars
11k
Token cost
~1.7k tokens
SKILL.md length
442 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Tracks GEO agency leads and clients through a sales pipeline in a local JSON file, with notes, audit scores, deal values and a pipeline summary.

  • Works in 7 steps: Check if ~/.geo-prospects/prospects.json… → Auto-detect company name from domain… → Assign next sequential ID: PRO-001,… → …
  • Adding a new agency lead and tracking it through qualified, proposal, won or lost
  • SKILL.md covers Purpose, Commands, Data Structure and Orchestration Instructions, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This is a small CRM for a GEO agency, driven by /geo prospect commands. Prospects are saved in ~/.geo-prospects/prospects.json, so they persist between sessions. New records get sequential ids such as PRO-001, start with the status lead and carry a company name guessed from the domain, a contact and an optional monthly value estimate.

Commands list prospects by status, show full detail with history, add timestamped notes, move a prospect through qualified, proposal, won and lost, and print a pipeline summary with a revenue forecast. The audit command runs a quick GEO audit, stores the score and date on the record, saves the report under ~/.geo-prospects/audits and suggests a proposal when the score is low.

When your agent uses it

  • Adding a new agency lead and tracking it through qualified, proposal, won or lost
  • Attaching a quick GEO audit score to a prospect's record
  • Viewing the pipeline and forecasting revenue from won deals

Example prompts

  • “Add electron-srl.com as a new prospect with a monthly estimate.”
  • “Mark prospect PRO-001 as lost because the budget was cut.”
  • “Show me the pipeline summary for all qualified prospects.”

Requirements

  • Write access to ~/.geo-prospects
  • The related /geo quick command for audits
  • Pre-approved tools (allowed-tools): Read, Write, Bash, Glob

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Check if ~/.geo-prospects/prospects.json exists, create if not (empty array)
  2. Auto-detect company name from domain (e.g., electron-srl.com → Electron Srl)
  3. Assign next sequential ID: PRO-001, PRO-002, etc.
  4. Ask user for
  5. Set status to lead
  6. Save to JSON file
  7. Suggest next step: "Run /geo prospect audit electron-srl.com to score this prospect"

What it can do on your machine

Read from SKILL.md and the folder at commit 989cae0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

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

  • Network

    No URLs in SKILL.md.

    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 Prospect Tracker loads about 1.7k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 442 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Glob

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 zubair-trabzada/geo-seo-claude at commit 989cae0, republished under its MIT licence (© zubair-trabzada). 442 words, ~1,653 tokens.

Download SKILL.mdSave it as .claude/skills/geo-prospect/SKILL.md (or your agent's skills folder).
name
geo-prospect
description
CRM-lite for managing GEO agency prospects and clients. Track leads through the full sales pipeline: Lead → Qualified → Proposal Sent → Won → Lost. Store audit history, notes, deal values, and generate pipeline summaries. Use when user says "prospect", "lead", "client", "pipeline", "crm", "nuovo prospect", "aggiungi cliente", or when managing the business side of GEO services.
allowed-tools
Read, Write, Bash, Glob
version
1.0.0
tags
geo, business, crm, prospect, pipeline, sales

GEO Prospect Manager

Purpose

Manage GEO agency prospects and clients through the full sales lifecycle. All data is stored in ~/.geo-prospects/prospects.json (persistent across sessions).


Commands

CommandWhat It Does
/geo prospect new <domain>Create new prospect (interactive prompts)
/geo prospect listShow all prospects with pipeline status
/geo prospect list <status>Filter: lead, qualified, proposal, won, lost
/geo prospect show <id-or-domain>Full prospect detail with history
/geo prospect audit <id-or-domain>Run quick GEO audit and save to prospect record
/geo prospect note <id-or-domain> "<text>"Add interaction note with timestamp
/geo prospect status <id-or-domain> <new-status>Move through pipeline
/geo prospect won <id-or-domain> <monthly-value>Mark as won, set contract value
/geo prospect lost <id-or-domain> "<reason>"Mark as lost with reason
/geo prospect pipelineVisual pipeline summary with revenue forecast

Data Structure

Each prospect is stored as a JSON record:

json
{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}

Orchestration Instructions

/geo prospect new <domain>
  1. Check if ~/.geo-prospects/prospects.json exists, create if not (empty array)
  2. Auto-detect company name from domain (e.g., electron-srl.com → Electron Srl)
  3. Assign next sequential ID: PRO-001, PRO-002, etc.
  4. Ask user for:
    • Contact name (optional)
    • Contact email
    • Monthly contract value estimate (optional)
  5. Set status to lead
  6. Save to JSON file
  7. Suggest next step: "Run /geo prospect audit electron-srl.com to score this prospect"
/geo prospect list

Read ~/.geo-prospects/prospects.json and render a summary table:

GEO Prospect Pipeline — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ID       Domain                  Company           Status      Score  Value
───────  ──────────────────────  ────────────────  ──────────  ─────  ──────
PRO-001  electron-srl.com        Electron Srl      Qualified   32/100  €4.5K
PRO-002  acme.com                ACME Corp         Lead        —       —
PRO-003  bigshop.it              BigShop           Won         41/100  €6.0K

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pipeline: 1 lead | 1 qualified | 0 proposals | 1 won | 0 lost
Committed MRR: €6,000 | Pipeline Value: €4,500
/geo prospect audit <id-or-domain>
  1. Run /geo quick <domain> to get GEO snapshot score
  2. Save score to prospect record: geo_score, audit_date
  3. Save audit output to ~/.geo-prospects/audits/<domain>-<date>.md
  4. Update audit_file path in prospect record
  5. Add auto-note: "Quick audit run. GEO Score: XX/100."
  6. If score < 55: suggest "Score indicates strong sales opportunity. Run /geo proposal <domain> to generate proposal."
Show full SKILL.md (163 more words)Show less
/geo prospect note <id-or-domain> "<text>"
  1. Find prospect by ID or domain
  2. Append note with current ISO date
  3. Save back to JSON
  4. Confirm: "Note added to Electron Srl (PRO-001)"
/geo prospect status <id-or-domain> <status>

Valid statuses: lead, qualified, proposal, won, lost

  1. Update status field
  2. Add auto-note: "Status changed to <status>"
  3. Save and confirm
/geo prospect pipeline

Visual revenue-focused pipeline summary:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEO AGENCY PIPELINE SUMMARY — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

STAGE          COUNT   POTENTIAL VALUE   NOTES
─────────────  ─────   ───────────────   ─────────────────────
Lead             2      €8,000/mo        New discoveries
Qualified        1      €4,500/mo        Ready for proposal
Proposal Sent    1      €6,000/mo        Awaiting signature
Won              3      €18,500/mo       Active clients (MRR)
Lost             1      —                Budget freeze

COMMITTED MRR:        €18,500
PIPELINE (qualified+): €10,500
TOTAL POTENTIAL:      €29,000/mo → €348,000/yr

Next actions:
→ PRO-003 (acme.com): Send proposal — score 38/100 (strong case)
→ PRO-007 (shop.it): Follow up — proposal sent 8 days ago
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Storage Location

All data stored in ~/.geo-prospects/:

~/.geo-prospects/
├── prospects.json          # Main CRM database
├── audits/                 # Quick audit snapshots
│   └── electron-srl.com-2026-03-12.md
└── proposals/              # Generated proposals
    └── electron-srl.com-proposal.md

Create directory if it does not exist: mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals


Pipeline Stage Definitions

StatusMeaningTypical Next Action
leadDiscovered, not yet contactedRun quick audit, assess opportunity
qualifiedAudit done, confirmed pain pointsGenerate proposal
proposalProposal sent, awaiting decisionFollow up, answer questions
wonContract signed, active clientRun full audit, start onboarding
lostDeal closed lostLog reason for future reference

Output

  • All commands print confirmation + current prospect status to terminal
  • No external files unless explicitly saving audits/proposals
  • JSON database is the single source of truth

© zubair-trabzada, 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-prospect of zubair-trabzada/geo-seo-claude.

Open the folder on GitHubat commit 989cae0

Compare with similar skills

GEO Prospect Tracker 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 Prospect Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
GEO Prospect Tracker this skillzubair-trabzada/geo-seo-claude11k—~1.7kAutomated safety check: NotesMIT
B2B Lead Generationminhnv0807/ai-business-skills609—~1.2kAutomated safety check: PassMIT
Lead Gen Tool Builderexplorium-ai/gtm-skills185—~1.8kAutomated safety check: NotesMIT
Lead ScoringLeoYeAI/openclaw-master-skills2.2k—~4.6kAutomated safety check: PassMIT
Cold Outreachericrisco/rsc-harness180—~4.1kAutomated safety check: PassMIT
Lead Genericrisco/rsc-harness180—~2.6kAutomated safety check: PassMIT

Similar skills

  • B2B Lead Generation

    minhnv0807/ai-business-skills

    Plans B2B pipeline work from ICP definition and prospecting through lead scoring, outbound sequences, sales assets and MQL to SQL handoff, aiming at qualified pipeline.

    609 GitHub stars~1.2k tokensUpdated 29 days ago
    Sales & SupportAuto-check passed
  • Lead Gen Tool Builder

    explorium-ai/gtm-skills

    Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and…

    185 GitHub stars~1.8k tokensUpdated 3 days ago
    Sales & SupportAuto-check: notes
  • Lead Scoring

    LeoYeAI/openclaw-master-skills

    Set up and automate lead scoring for HubSpot and other CRMs.

    2.2k GitHub stars~4.6k tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Cold Outreach

    ericrisco/rsc-harness

    A skill your agent uses when writing a cold email or LinkedIn DM to a stranger and its cadence: first-touch copy under a word ceiling, 4-7 step bump sequences, per-inbox volume and warm-up limits…

    180 GitHub stars~4.1k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Lead Gen

    ericrisco/rsc-harness

    A skill your agent uses when building and qualifying a prospect list before anyone reaches out — a falsifiable ICP, named accounts/contacts from Apollo/ZoomInfo/Clay, deduped against the CRM, tiered…

    180 GitHub stars~2.6k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Sales Pipeline

    ericrisco/rsc-harness

    A skill your agent uses when an operator runs deals out of a spreadsheet or Notion and wants real stages, win probabilities, deal hygiene, a weekly follow-up sweep, and a defensible roll-up forecast…

    180 GitHub stars~3.3k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from zubair-trabzada/geo-seo-claude

All 16 skills in this repo
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Auto-check: notes
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes
  • AI Citability Scorer

    zubair-trabzada/geo-seo-claude

    Scores how likely AI assistants are to quote passages from a web page and suggests rewrites that make those passages easier to extract.

    11k GitHub starsUsed in 2 repos~3.7k tokens
    Auto-check: notes
  • GEO Service Proposal Generator

    zubair-trabzada/geo-seo-claude

    Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.

    11k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • GEO Content E-E-A-T Scorer

    zubair-trabzada/geo-seo-claude

    Scores a page's content against Google's E-E-A-T framework and AI-citability structure, then writes a scored gap-analysis report.

    11k GitHub starsUsed in 2 repos~4k tokens
    Auto-check: notes
  • llms.txt Analyzer and Generator

    zubair-trabzada/geo-seo-claude

    Validates an existing llms.txt file or crawls a site to generate a new one, following the format rules for a root-level Markdown file aimed at AI systems.

    11k GitHub starsUsed in 2 repos~3.9k tokens
    Auto-check: notes

Questions about GEO Prospect Tracker

What does GEO Prospect Tracker do?

Tracks GEO agency leads and clients through a sales pipeline in a local JSON file, with notes, audit scores, deal values and a pipeline summary. This is a small CRM for a GEO agency, driven by /geo prospect commands.json, so they persist between sessions.

When should I use GEO Prospect Tracker?

GEO Prospect Tracker fits situations like: adding a new agency lead and tracking it through qualified, proposal, won or lost; attaching a quick GEO audit score to a prospect's record; viewing the pipeline and forecasting revenue from won deals.

How do I install GEO Prospect Tracker in Claude Code?

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

How do I install GEO Prospect Tracker in Codex?

Run `npx skills add zubair-trabzada/geo-seo-claude --skill geo-prospect -a codex`. Or copy the skill folder (skills/geo-prospect in zubair-trabzada/geo-seo-claude) into .agents/skills/geo-prospect in your project. Codex loads it when a task matches its description.

Can I use GEO Prospect Tracker 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 zubair-trabzada/geo-seo-claude --skill geo-prospect -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-prospect, .gemini/skills/geo-prospect, .github/skills/geo-prospect and .opencode/skills/geo-prospect in your project.

What does GEO Prospect Tracker need to run?

SKILL.md names no scripts, command-line tools or credentials: GEO Prospect Tracker is instructions for the agent only. Our summary lists: Write access to ~/.geo-prospects; The related /geo quick command for audits. Its frontmatter pre-approves these tools: Read, Write, Bash, Glob.

Does GEO Prospect Tracker access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is GEO Prospect Tracker safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does GEO Prospect Tracker use?

GEO Prospect Tracker 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 Prospect Tracker use?

About 1.7k tokens (SKILL.md is roughly 6.6k 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 Prospect Tracker?

Skills that share tags, products or a category with GEO Prospect Tracker: B2B Lead Generation (minhnv0807/ai-business-skills, 609 stars), Lead Gen Tool Builder (explorium-ai/gtm-skills, 185 stars), Lead Scoring (LeoYeAI/openclaw-master-skills, 2.2k stars) and Cold Outreach (ericrisco/rsc-harness, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GEO Prospect Tracker?

zubair-trabzada (a GitHub user) maintains it in zubair-trabzada/geo-seo-claude, which has 10,982 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 2026.

Source: zubair-trabzada/geo-seo-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.