pd-ask
Skill0 starsChanged 29 days agoMITView on GitHub
Answer any plain-English question about the user's Pipedrive data (deals, contacts, organizations, activities, notes, leads, products) with the cheapest possible queries. Use for ad-hoc questions not covered by a more specific pd-* skill.
In this repository19 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- pd-accessSkill
- pd-account-healthSkill
- pd-advisorSkill
- 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
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
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 11
Follow pd-core rules (load pd-core if not loaded).
- Distinctive: line 20
Check for a better skill: daily to-do -> pd-morning-brief.
- Distinctive: line 22
If the plan needs more than about 15 calls or would pull 500+ records, say so and offer a narrower version first.
- Very specific: line 23
Run. Aggregate with pd-core/scripts/pd_digest.py when counting or summing over more than about 20 records.
- Very specific: line 34
If the data is ambiguous (two "Acme" orgs, missing field), say so in one line and ask.
- Very specific: line 35
Never guess custom field meanings: map names via .pipedrive/field-map.json or .pipedrive/account_context.json.
≈ “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-ask
Follow pd-core rules (load pd-core if not loaded).
Requires: Pipedrive Fallback: question needs data Pipedrive does not hold -> say which data is missing.
Steps
- Restate the question as a query in one line: object, filters, time window, fields, aggregation. Example: "Clients in Porto not contacted in 60 days" -> orgs with city=Porto (custom/address field), deals or activities with no update since today-60d.
- Check for a better skill: daily to-do -> pd-morning-brief; team or forecast -> pd-pipeline-review; deals at risk -> pd-premortem; why we win or lose -> pd-win-loss; best customer segments -> pd-icp-discovery. If one fits, use it.
- Plan calls with
pd-core/references/query-playbook.md. Prefer: known ID > saved filter (filter_id) > filtered list > search. - If the plan needs more than about 15 calls or would pull 500+ records, say so and offer a narrower version first.
- Run. Aggregate with
pd-core/scripts/pd_digest.pywhen counting or summing over more than about 20 records. - Answer.
Output
<Direct answer in 1-2 lines>
<up to 20 compact rows: id | name | key fields>
Query: <one line: what was fetched and filters used>If the data is ambiguous (two "Acme" orgs, missing field), say so in one line and ask.
Never guess custom field meanings: map names via .pipedrive/field-map.json or .pipedrive/account_context.json.
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.

