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
| Command |
What It Does |
/geo prospect new <domain> |
Create new prospect (interactive prompts) |
/geo prospect list |
Show 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 pipeline |
Visual pipeline summary with revenue forecast |
Data Structure
Each prospect is stored as a JSON record:
{
"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>
- Check if
~/.geo-prospects/prospects.json exists, create if not (empty array)
- Auto-detect company name from domain (e.g.,
electron-srl.com → Electron Srl)
- Assign next sequential ID:
PRO-001, PRO-002, etc.
- Ask user for:
- Contact name (optional)
- Contact email
- Monthly contract value estimate (optional)
- Set status to
lead
- Save to JSON file
- 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>
- Run
/geo quick <domain> to get GEO snapshot score
- Save score to prospect record:
geo_score, audit_date
- Save audit output to
~/.geo-prospects/audits/<domain>-<date>.md
- Update
audit_file path in prospect record
- Add auto-note: "Quick audit run. GEO Score: XX/100."
- If score < 55: suggest "Score indicates strong sales opportunity. Run
/geo proposal <domain> to generate proposal."
/geo prospect note <id-or-domain> "<text>"
- Find prospect by ID or domain
- Append note with current ISO date
- Save back to JSON
- Confirm: "Note added to Electron Srl (PRO-001)"
/geo prospect status <id-or-domain> <status>
Valid statuses: lead, qualified, proposal, won, lost
- Update status field
- Add auto-note: "Status changed to "
- 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
| Status |
Meaning |
Typical Next Action |
lead |
Discovered, not yet contacted |
Run quick audit, assess opportunity |
qualified |
Audit done, confirmed pain points |
Generate proposal |
proposal |
Proposal sent, awaiting decision |
Follow up, answer questions |
won |
Contract signed, active client |
Run full audit, start onboarding |
lost |
Deal closed lost |
Log 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
1---
2name: geo-prospect
3description: >
4 CRM-lite for managing GEO agency prospects and clients. Track leads through
5 the full sales pipeline: Lead → Qualified → Proposal Sent → Won → Lost.
6 Store audit history, notes, deal values, and generate pipeline summaries.
7 Use when user says "prospect", "lead", "client", "pipeline", "crm", "nuovo prospect",
8 "aggiungi cliente", or when managing the business side of GEO services.
9version: 1.0.0
10tags: [geo, business, crm, prospect, pipeline, sales]
11allowed-tools: Read, Write, Bash, Glob
12metadata:
13 source: https://skillmd.com/skills/zubair-trabzada/geo-prospect
14---
15
16# GEO Prospect Manager
17
18## Purpose
19
20Manage GEO agency prospects and clients through the full sales lifecycle.
21All data is stored in `~/.geo-prospects/prospects.json` (persistent across sessions).
22
23---
24
25## Commands
26
27| Command | What It Does |
28|---------|-------------|
29| `/geo prospect new <domain>` | Create new prospect (interactive prompts) |
30| `/geo prospect list` | Show all prospects with pipeline status |
31| `/geo prospect list <status>` | Filter: lead, qualified, proposal, won, lost |
32| `/geo prospect show <id-or-domain>` | Full prospect detail with history |
33| `/geo prospect audit <id-or-domain>` | Run quick GEO audit and save to prospect record |
34| `/geo prospect note <id-or-domain> "<text>"` | Add interaction note with timestamp |
35| `/geo prospect status <id-or-domain> <new-status>` | Move through pipeline |
36| `/geo prospect won <id-or-domain> <monthly-value>` | Mark as won, set contract value |
37| `/geo prospect lost <id-or-domain> "<reason>"` | Mark as lost with reason |
38| `/geo prospect pipeline` | Visual pipeline summary with revenue forecast |
39
40---
41
42## Data Structure
43
44Each prospect is stored as a JSON record:
45
46```json
47{
48 "id": "PRO-001",
49 "company": "Electron Srl",
50 "domain": "electron-srl.com",
51 "contact_email": "info@electron-srl.com",
52 "contact_name": "",
53 "industry": "Educational Equipment Manufacturing",
54 "country": "Italy",
55 "status": "qualified",
56 "geo_score": 32,
57 "audit_date": "2026-03-12",
58 "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
59 "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
60 "monthly_value": 0,
61 "contract_start": null,
62 "contract_months": 0,
63 "notes": [
64 {
65 "date": "2026-03-12",
66 "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
67 }
68 ],
69 "created_at": "2026-03-12",
70 "updated_at": "2026-03-12"
71}
72```
73
74---
75
76## Orchestration Instructions
77
78### `/geo prospect new <domain>`
79
801. Check if `~/.geo-prospects/prospects.json` exists, create if not (empty array)
812. Auto-detect company name from domain (e.g., `electron-srl.com` → `Electron Srl`)
823. Assign next sequential ID: `PRO-001`, `PRO-002`, etc.
834. Ask user for:
84 - Contact name (optional)
85 - Contact email
86 - Monthly contract value estimate (optional)
875. Set status to `lead`
886. Save to JSON file
897. Suggest next step: "Run `/geo prospect audit electron-srl.com` to score this prospect"
90
91### `/geo prospect list`
92
93Read `~/.geo-prospects/prospects.json` and render a summary table:
94
95```
96GEO Prospect Pipeline — March 2026
97━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
98
99ID Domain Company Status Score Value
100─────── ────────────────────── ──────────────── ────────── ───── ──────
101PRO-001 electron-srl.com Electron Srl Qualified 32/100 €4.5K
102PRO-002 acme.com ACME Corp Lead — —
103PRO-003 bigshop.it BigShop Won 41/100 €6.0K
104
105━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
106Pipeline: 1 lead | 1 qualified | 0 proposals | 1 won | 0 lost
107Committed MRR: €6,000 | Pipeline Value: €4,500
108```
109
110### `/geo prospect audit <id-or-domain>`
111
1121. Run `/geo quick <domain>` to get GEO snapshot score
1132. Save score to prospect record: `geo_score`, `audit_date`
1143. Save audit output to `~/.geo-prospects/audits/<domain>-<date>.md`
1154. Update `audit_file` path in prospect record
1165. Add auto-note: "Quick audit run. GEO Score: XX/100."
1176. If score < 55: suggest "Score indicates strong sales opportunity. Run `/geo proposal <domain>` to generate proposal."
118
119### `/geo prospect note <id-or-domain> "<text>"`
120
1211. Find prospect by ID or domain
1222. Append note with current ISO date
1233. Save back to JSON
1244. Confirm: "Note added to Electron Srl (PRO-001)"
125
126### `/geo prospect status <id-or-domain> <status>`
127
128Valid statuses: `lead`, `qualified`, `proposal`, `won`, `lost`
129
1301. Update status field
1312. Add auto-note: "Status changed to <status>"
1323. Save and confirm
133
134### `/geo prospect pipeline`
135
136Visual revenue-focused pipeline summary:
137
138```
139━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
140GEO AGENCY PIPELINE SUMMARY — March 2026
141━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
142
143STAGE COUNT POTENTIAL VALUE NOTES
144───────────── ───── ─────────────── ─────────────────────
145Lead 2 €8,000/mo New discoveries
146Qualified 1 €4,500/mo Ready for proposal
147Proposal Sent 1 €6,000/mo Awaiting signature
148Won 3 €18,500/mo Active clients (MRR)
149Lost 1 — Budget freeze
150
151COMMITTED MRR: €18,500
152PIPELINE (qualified+): €10,500
153TOTAL POTENTIAL: €29,000/mo → €348,000/yr
154
155Next actions:
156→ PRO-003 (acme.com): Send proposal — score 38/100 (strong case)
157→ PRO-007 (shop.it): Follow up — proposal sent 8 days ago
158━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
159```
160
161---
162
163## Storage Location
164
165All data stored in `~/.geo-prospects/`:
166```
167~/.geo-prospects/
168├── prospects.json # Main CRM database
169├── audits/ # Quick audit snapshots
170│ └── electron-srl.com-2026-03-12.md
171└── proposals/ # Generated proposals
172 └── electron-srl.com-proposal.md
173```
174
175Create directory if it does not exist: `mkdir -p ~/.geo-prospects/audits ~/.geo-prospects/proposals`
176
177---
178
179## Pipeline Stage Definitions
180
181| Status | Meaning | Typical Next Action |
182|--------|---------|---------------------|
183| `lead` | Discovered, not yet contacted | Run quick audit, assess opportunity |
184| `qualified` | Audit done, confirmed pain points | Generate proposal |
185| `proposal` | Proposal sent, awaiting decision | Follow up, answer questions |
186| `won` | Contract signed, active client | Run full audit, start onboarding |
187| `lost` | Deal closed lost | Log reason for future reference |
188
189---
190
191## Output
192
193- All commands print confirmation + current prospect status to terminal
194- No external files unless explicitly saving audits/proposals
195- JSON database is the single source of truth