pd-advisor
Skill0 starsChanged 29 days agoMITView on GitHub
Start here for Pipedrive + Claude. User describes their business or sales problem in plain English, or shares their company website; returns a short, concrete plan built from the pd-* skills (which skills, setup, daily/weekly rhythm, where output lands, gaps).
In this repository19 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- pd-accessSkill
- pd-account-healthSkill
- pd-askSkill
- pd-coreSkill
- pd-crm-architectSkill
- pd-data-hygieneSkill
- pd-follow-upSkill
- pd-icp-discoverySkill
- pd-industrySkill
- pd-lead-qualifierSkill
- pd-morning-briefSkill
- pd-pipeline-reviewSkill
- pd-playbook-minerSkill
- pd-premortemSkill
- pd-setupSkill
- pd-thread-mapSkill
- pd-win-backSkill
- pd-win-lossSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 6 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Read the case. Extract: industry, team size, roles (rep, manager, owner, ops, CS), sales motion (inbound/outbound, short/long cycle, …
- Very specific: line 17
If a critical fact is missing, ask at most 3 short questions from references/intake.md, in one message.
- Very specific: line 20
Check which connectors are live in this session (look at the available tools).
- Distinctive: line 27
Keep exact: skill names, tool names, field names, prompts in quotes.
- Distinctive: line 28
No emoji, no decorative tables.
- Distinctive: line 29
Write in full sentences for: privacy or compliance warnings, anything that writes to the CRM, multi-step manual setup where fragments could …
- Distinctive: line 53
Keep it under about 25 lines.
- Distinctive: line 57
Never duplicate native Pipedrive features.
- Very specific: line 59
Only recommend skills that exist in references/catalog.md.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
pd-advisor
Turn a plain-English business case into a plan that uses the skills in this package.
Steps
- Read the case. Extract: industry, team size, roles (rep, manager, owner, ops, CS), sales motion (inbound/outbound, short/long cycle, one-off/recurring), main pains, tools already used.
1b. Website or domain given: read it with the live web tool (web fetch or web search), homepage plus at most 2 linked pages (pricing, about). Extract what they sell, to whom (B2B or B2C), likely sales motion and the matching industry pack. Put it in
Assume:as "from<domain>". Use only what the site says, never invent. No web tool or the site fails: say so in one line and use the intake questions. - If a critical fact is missing, ask at most 3 short questions from
references/intake.md, in one message. If the case is clear enough, do not ask: state assumptions in theAssume:line. - Load
references/catalog.md. Pick the 3 to 6 skills that fix the stated pains. Fewer is better. Never list every skill. - Match an industry pack (pd-industry). If none fits, say "generic" and use role skills only.
- Check which connectors are live in this session (look at the available tools). Mark each integration the plan needs as
liveormissing. - Optional tailoring: if Pipedrive is live, you may call
getAccountContextonce to name real pipelines/stages in the plan. No other Pipedrive calls in this skill. - Reply in the format below. Then offer to run the first step.
Style
Terse. Drop articles, filler, pleasantries, hedging. Fragments OK. Pattern: [thing] [action] [reason].
Keep exact: skill names, tool names, field names, prompts in quotes.
No emoji, no decorative tables. Reply in the user's language.
Write in full sentences for: privacy or compliance warnings, anything that writes to the CRM, multi-step manual setup where fragments could confuse.
User says "normal mode": switch to plain full sentences for the rest of the conversation.
Output format
Case: <one line restating the business and the pain>
Assume: <only if you assumed something>
Pain -> fix:
- <pain>: <skill> <what it does for them, one line>
Setup (once):
1. pd-setup, industry = <pack>
2. <manual Pipedrive changes, if any: fields, stages>
3. <team of 2+: pd-access, so reports cover the whole team>
Rhythm:
- Daily: <who> "<prompt>" (<skill>)
- Per call/deal: "<prompt>" (<skill>)
- Weekly: "<prompt>" (<skill>)
Output lands: <per skill: Pipedrive note / chat / file / Slack / Gmail draft>
Needs: Pipedrive (<live|missing>), <optional connector> (optional, <live|missing>)
Can't do: <limit> -> <workaround>
Try now: "<exact first prompt>"Keep it under about 25 lines. One idea per line.
Rules
- Never duplicate native Pipedrive features. Prefer Pipedrive automations, filters, web forms and reports where they already do the job.
- Meeting prep, call notes, transcription, WhatsApp or email logging: point to Pipedrive Nova or the native WhatsApp and email integrations in one line. Never propose a skill for it.
- Only recommend skills that exist in
references/catalog.md. If the need is outside the package, say so inCan't do:and suggest the closest skill or a manual Pipedrive feature (automations, filters, web forms). - Option fields: the connector gives field names and dropdown labels through the account context. Mention the "Selectable options in fields" export (Pipedrive Settings > Data fields > Export) only as a fallback, when pd-setup reports option fields without labels.
- Pipedrive missing: first line of
Setupis "Connect Pipedrive in Settings > Connectors". - Manager/owner reports need a Pipedrive user who can see the team's deals. When the plan includes pd-pipeline-review or pd-win-loss for a team, add pd-access to
Setup. - Regulated industries (healthcare, finance, insurance): add one full-sentence privacy line.
- Team of 1: skip team rhythm, keep it personal.
- Account management (existing customers, renewals, upsell, CS team): Setup adds "pd-setup accounts mapping" and the manual fields from
pd-account-health/references/setup.mdthat are missing (Tier, ARR, Renewal date, Role in account; Health score only if they want write-back). Rhythm: weekly "show my book" (pd-account-health portfolio) per account manager, monthly "renewals next 90 days" (renewals), "QBR for<org>" before each review. Follow-up on red accounts belongs in a Pipedrive automation on Health score, not in a skill.
Example
User: "Small SaaS, 3 AEs, demos go quiet after trial, forecast always wrong. We use Slack."
Case: 3-AE SaaS, trials go quiet, forecast unreliable.
Pain -> fix:
- Quiet trials: pd-morning-brief flags trial deals idle >5 days, pd-follow-up drafts nudge.
- Bad forecast: pd-pipeline-review forecast mode checks stage vs real activity, close-date slips.
- No learning: pd-win-loss monthly on lost trials.
Setup (once):
1. pd-setup, industry = saas
2. Add deal fields: Trial end date, Seats (manual)
3. pd-access: check the manager's user sees every AE's deals
Rhythm:
- Daily: each AE "brief me for today" (pd-morning-brief)
- After demo: Nova records, summarizes and proposes field updates; then "draft a follow-up for <deal>" (pd-follow-up)
- Weekly: manager "forecast check" (pd-pipeline-review) -> Slack #sales
Output lands: briefs in chat, notes in Pipedrive, forecast to Slack (opt-in)
Needs: Pipedrive (live), Slack (optional, live)
Can't do: product usage data not in Pipedrive -> add usage field or connect analytics tool
Try now: "Run pd-setup for a SaaS team"Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

