pm-claude-skills 28.1.0 → 28.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -25
- package/commands/brain.md +13 -0
- package/connectors/lovable.md +1 -1
- package/connectors/n8n.md +1 -1
- package/exports/README.md +1 -1
- package/exports/aider/README.md +3 -1
- package/exports/aider/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/aider/pm-cross/professional-brain/professional-brain.md +162 -0
- package/exports/aider/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/aider/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/aider/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/aider/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/aider/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/aider/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/aider/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/aider/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/aider/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/aider/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/aider/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/aider/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/chatgpt/README.md +3 -1
- package/exports/chatgpt/pm-cross/action-runner/SYSTEM_PROMPT.md +81 -0
- package/exports/chatgpt/pm-cross/professional-brain/SYSTEM_PROMPT.md +162 -0
- package/exports/chatgpt/pm-cs/churn-analysis/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-cs/cs-health-scorecard/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-delivery/product-launch-checklist/SYSTEM_PROMPT.md +4 -0
- package/exports/chatgpt/pm-delivery/sprint-planning/SYSTEM_PROMPT.md +11 -0
- package/exports/chatgpt/pm-engineering/incident-postmortem/SYSTEM_PROMPT.md +4 -0
- package/exports/chatgpt/pm-essentials/competitive-analysis/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-essentials/meeting-notes/SYSTEM_PROMPT.md +11 -0
- package/exports/chatgpt/pm-essentials/prd-template/SYSTEM_PROMPT.md +12 -0
- package/exports/chatgpt/pm-planning/okr-builder/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-planning/rice-prioritisation/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-planning/roadmap-narrative/SYSTEM_PROMPT.md +7 -0
- package/exports/chatgpt/pm-strategy/executive-update/SYSTEM_PROMPT.md +7 -0
- package/exports/cline/README.md +3 -1
- package/exports/cline/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/cline/pm-cross/professional-brain/professional-brain.md +162 -0
- package/exports/cline/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/cline/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/cline/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/cline/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/cline/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/cline/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/cline/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/cline/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/cline/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/cline/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/cline/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/cline/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/continue/README.md +3 -1
- package/exports/continue/pm-cross/action-runner/action-runner.md +86 -0
- package/exports/continue/pm-cross/professional-brain/professional-brain.md +167 -0
- package/exports/continue/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/continue/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/continue/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/continue/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/continue/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/continue/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/continue/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/continue/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/continue/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/continue/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/continue/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/continue/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/cursor/README.md +3 -1
- package/exports/cursor/pm-cross/action-runner/action-runner.mdc +87 -0
- package/exports/cursor/pm-cross/professional-brain/professional-brain.mdc +168 -0
- package/exports/cursor/pm-cs/churn-analysis/churn-analysis.mdc +7 -0
- package/exports/cursor/pm-cs/cs-health-scorecard/cs-health-scorecard.mdc +7 -0
- package/exports/cursor/pm-delivery/product-launch-checklist/product-launch-checklist.mdc +4 -0
- package/exports/cursor/pm-delivery/sprint-planning/sprint-planning.mdc +11 -0
- package/exports/cursor/pm-engineering/incident-postmortem/incident-postmortem.mdc +4 -0
- package/exports/cursor/pm-essentials/competitive-analysis/competitive-analysis.mdc +7 -0
- package/exports/cursor/pm-essentials/meeting-notes/meeting-notes.mdc +11 -0
- package/exports/cursor/pm-essentials/prd-template/prd-template.mdc +12 -0
- package/exports/cursor/pm-planning/okr-builder/okr-builder.mdc +7 -0
- package/exports/cursor/pm-planning/rice-prioritisation/rice-prioritisation.mdc +7 -0
- package/exports/cursor/pm-planning/roadmap-narrative/roadmap-narrative.mdc +7 -0
- package/exports/cursor/pm-strategy/executive-update/executive-update.mdc +7 -0
- package/exports/gemini/README.md +3 -1
- package/exports/gemini/pm-cross/action-runner/GEM_INSTRUCTIONS.md +85 -0
- package/exports/gemini/pm-cross/professional-brain/GEM_INSTRUCTIONS.md +166 -0
- package/exports/gemini/pm-cs/churn-analysis/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-cs/cs-health-scorecard/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-delivery/product-launch-checklist/GEM_INSTRUCTIONS.md +4 -0
- package/exports/gemini/pm-delivery/sprint-planning/GEM_INSTRUCTIONS.md +11 -0
- package/exports/gemini/pm-engineering/incident-postmortem/GEM_INSTRUCTIONS.md +4 -0
- package/exports/gemini/pm-essentials/competitive-analysis/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-essentials/meeting-notes/GEM_INSTRUCTIONS.md +11 -0
- package/exports/gemini/pm-essentials/prd-template/GEM_INSTRUCTIONS.md +12 -0
- package/exports/gemini/pm-planning/okr-builder/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-planning/rice-prioritisation/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-planning/roadmap-narrative/GEM_INSTRUCTIONS.md +7 -0
- package/exports/gemini/pm-strategy/executive-update/GEM_INSTRUCTIONS.md +7 -0
- package/exports/obsidian/README.md +3 -1
- package/exports/obsidian/pm-cross/action-runner/action-runner.md +96 -0
- package/exports/obsidian/pm-cross/professional-brain/professional-brain.md +177 -0
- package/exports/obsidian/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/obsidian/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/obsidian/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/obsidian/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/obsidian/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/obsidian/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/obsidian/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/obsidian/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/obsidian/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/obsidian/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/obsidian/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/obsidian/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/roo/README.md +3 -1
- package/exports/roo/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/roo/pm-cross/professional-brain/professional-brain.md +162 -0
- package/exports/roo/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/roo/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/roo/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/roo/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/roo/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/roo/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/roo/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/roo/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/roo/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/roo/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/roo/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/roo/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/windsurf/README.md +3 -1
- package/exports/windsurf/pm-cross/action-runner/action-runner.md +86 -0
- package/exports/windsurf/pm-cross/professional-brain/professional-brain.md +167 -0
- package/exports/windsurf/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/windsurf/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/windsurf/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/windsurf/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/windsurf/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/windsurf/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/windsurf/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/windsurf/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/windsurf/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/windsurf/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/windsurf/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/windsurf/pm-strategy/executive-update/executive-update.md +7 -0
- package/exports/zed/README.md +3 -1
- package/exports/zed/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/zed/pm-cross/professional-brain/professional-brain.md +162 -0
- package/exports/zed/pm-cs/churn-analysis/churn-analysis.md +7 -0
- package/exports/zed/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
- package/exports/zed/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/zed/pm-delivery/sprint-planning/sprint-planning.md +11 -0
- package/exports/zed/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/zed/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
- package/exports/zed/pm-essentials/meeting-notes/meeting-notes.md +11 -0
- package/exports/zed/pm-essentials/prd-template/prd-template.md +12 -0
- package/exports/zed/pm-planning/okr-builder/okr-builder.md +7 -0
- package/exports/zed/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
- package/exports/zed/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
- package/exports/zed/pm-strategy/executive-update/executive-update.md +7 -0
- package/package.json +2 -2
- package/skill-tiers.json +2 -0
- package/skills/action-runner/SKILL.md +86 -0
- package/skills/action-runner/scripts/action_preview.py +102 -0
- package/skills/churn-analysis/SKILL.md +7 -0
- package/skills/competitive-analysis/SKILL.md +7 -0
- package/skills/cs-health-scorecard/SKILL.md +7 -0
- package/skills/executive-update/SKILL.md +7 -0
- package/skills/incident-postmortem/SKILL.md +4 -0
- package/skills/meeting-notes/SKILL.md +11 -0
- package/skills/okr-builder/SKILL.md +7 -0
- package/skills/prd-template/SKILL.md +12 -0
- package/skills/product-launch-checklist/SKILL.md +4 -0
- package/skills/professional-brain/SKILL.md +167 -0
- package/skills/professional-brain/scripts/brain_query.py +99 -0
- package/skills/professional-brain/scripts/brain_write.py +117 -0
- package/skills/rice-prioritisation/SKILL.md +7 -0
- package/skills/roadmap-narrative/SKILL.md +7 -0
- package/skills/sprint-planning/SKILL.md +11 -0
- package/templates/brain/README.md +36 -0
- package/templates/brain/context.md +26 -0
- package/templates/brain/decisions/0001-prioritise-mobile-over-dashboard.md +20 -0
- package/templates/brain/entities/feature-mobile-revamp.md +19 -0
- package/templates/brain/hypotheses/mobile-retention.md +19 -0
- package/templates/brain/knowledge/strategy.md +10 -0
- package/templates/brain/source/README.md +10 -0
- package/templates/brain/stakeholders/sarah-cpo.md +13 -0
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
</a>
|
|
5
5
|
</p>
|
|
6
6
|
|
|
7
|
-
# 🧠 PM Skills —
|
|
7
|
+
# 🧠 PM Skills — 207 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
|
|
8
8
|
|
|
9
9
|
[](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
|
|
10
10
|
[](https://www.npmjs.com/package/pm-claude-skills)
|
|
@@ -14,12 +14,13 @@
|
|
|
14
14
|
[](https://github.com/mohitagw15856/pm-claude-skills#-use-it-anywhere--the-ai-ecosystem)
|
|
15
15
|
[](mcp-remote/)
|
|
16
16
|
[](https://smithery.ai/servers/mohit15856/pm-skills)
|
|
17
|
-
[](https://github.com/mohitagw15856/pm-claude-skills)
|
|
18
18
|
[](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
|
|
19
19
|
[](agents/)
|
|
20
20
|
[](commands/)
|
|
21
21
|
[](output-styles/)
|
|
22
22
|
[](#-works-with--cross-tool-compatibility)
|
|
23
|
+
[](connectors/)
|
|
23
24
|
[](.github/workflows/skillcheck.yml)
|
|
24
25
|
[](.github/workflows/skill-audit.yml)
|
|
25
26
|
[](https://github.com/mohitagw15856/pm-claude-skills/releases)
|
|
@@ -29,20 +30,22 @@
|
|
|
29
30
|
|
|
30
31
|
<p align="center">
|
|
31
32
|
<a href="https://mohitagw15856.github.io/pm-claude-skills/">
|
|
32
|
-
<img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757¢er=true&vCenter=true&width=720&lines=
|
|
33
|
+
<img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757¢er=true&vCenter=true&width=720&lines=207+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
|
|
33
34
|
</a>
|
|
34
35
|
</p>
|
|
35
36
|
|
|
36
37
|
> **Generic AI gives you filler. These give you the structure a senior pro actually uses** — PRDs, exec updates, launch plans, postmortems — as open-source `SKILL.md` files. Across **21 professions**, not just product management. One source, every AI tool.
|
|
37
38
|
|
|
39
|
+
> **🆕 Now plugs into your stack** — automate skills in **[n8n](connectors/n8n.md)**, build apps on **[Lovable](connectors/lovable.md)**, and run them in your **[Obsidian](connectors/obsidian.md)** vault, all via a read-only **[REST API](mcp-remote/#rest-api-for-n8n-lovable-make-any-http-tool)** on the hosted Worker.
|
|
40
|
+
|
|
38
41
|
### ⭐ If this saves you time, [star the repo](https://github.com/mohitagw15856/pm-claude-skills) — it's the #1 way to help others find it.
|
|
39
42
|
|
|
40
43
|
> **PM stands for Professional, not just Product Management.**
|
|
41
|
-
>
|
|
44
|
+
> 207 professional skills + 4 agent templates across 28 bundles covering 21 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
|
|
42
45
|
|
|
43
46
|
A community-built library of professional skills for every field — product management, engineering, customer success, marketing, social media, writers, design, legal, finance, HR, sales, operations, research, and more. Each skill is a structured `SKILL.md` file that teaches an AI assistant how to produce professional-grade outputs for your workflows. Skills run natively in **Claude Code** and **Hermes Agent** (same open `SKILL.md` standard), and ship as ready-to-paste exports for **ChatGPT** and **Gemini** — see [Works With](#-works-with--cross-tool-compatibility).
|
|
44
47
|
|
|
45
|
-
**🆕 Latest release (v28.1.0 — Integrations):** PM Skills now plugs into **[n8n](connectors/n8n.md)**, powers **[Lovable](connectors/lovable.md)** apps, and lives in your **[Obsidian](connectors/obsidian.md)** vault — all backed by a read-only **REST API** (`/v1`) on the hosted Worker, auto-deployed via GitHub Actions. *Previously (v28.0.0 — live across the whole AI ecosystem):* every channel is now shipped & public — **[`pip install pm-skills`](https://pypi.org/project/pm-skills/)** (LangChain/CrewAI), the **hosted MCP connector** `https://pm-skills-mcp.pm-claude-skills.workers.dev/` (add to **ChatGPT/Claude.ai/Cursor** by URL), and the **[official MCP registry](https://github.com/mohitagw15856/pm-claude-skills/blob/main/server.json)** listing. See the new **[🌍 Use It Anywhere](#-use-it-anywhere--the-ai-ecosystem)** section. Also: **multi-model playground** (run any skill with your own **Claude / OpenAI / Gemini / Ollama** key — local models included), a **[remote MCP connector](mcp-remote/)** (add PM Skills to **ChatGPT, Claude.ai & Cursor** with one URL — no install), the MCP server now exposes skills as **prompts + resources**, **4 new IDE targets** (Cline, Continue, Zed, Roo — 9 platforms total), a **[Python package](python/)** (`pip install pm-skills` → LangChain/CrewAI tools), an **[`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt)** for agent discovery, a reusable **[score-skills GitHub Action](.github/actions/score-skills/)**, and **MCP-registry manifests**. Plus the full library is now **eval-scored: 196 skills, avg 4.8/5**. **
|
|
48
|
+
**🆕 Latest release (v28.1.0 — Integrations):** PM Skills now plugs into **[n8n](connectors/n8n.md)**, powers **[Lovable](connectors/lovable.md)** apps, and lives in your **[Obsidian](connectors/obsidian.md)** vault — all backed by a read-only **REST API** (`/v1`) on the hosted Worker, auto-deployed via GitHub Actions. *Previously (v28.0.0 — live across the whole AI ecosystem):* every channel is now shipped & public — **[`pip install pm-skills`](https://pypi.org/project/pm-skills/)** (LangChain/CrewAI), the **hosted MCP connector** `https://pm-skills-mcp.pm-claude-skills.workers.dev/` (add to **ChatGPT/Claude.ai/Cursor** by URL), and the **[official MCP registry](https://github.com/mohitagw15856/pm-claude-skills/blob/main/server.json)** listing. See the new **[🌍 Use It Anywhere](#-use-it-anywhere--the-ai-ecosystem)** section. Also: **multi-model playground** (run any skill with your own **Claude / OpenAI / Gemini / Ollama** key — local models included), a **[remote MCP connector](mcp-remote/)** (add PM Skills to **ChatGPT, Claude.ai & Cursor** with one URL — no install), the MCP server now exposes skills as **prompts + resources**, **4 new IDE targets** (Cline, Continue, Zed, Roo — 9 platforms total), a **[Python package](python/)** (`pip install pm-skills` → LangChain/CrewAI tools), an **[`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt)** for agent discovery, a reusable **[score-skills GitHub Action](.github/actions/score-skills/)**, and **MCP-registry manifests**. Plus the full library is now **eval-scored: 196 skills, avg 4.8/5**. **207 skills**. See the [changelog](#-changelog).
|
|
46
49
|
|
|
47
50
|
### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
|
|
48
51
|
|
|
@@ -71,13 +74,13 @@ A community-built library of professional skills for every field — product man
|
|
|
71
74
|
| 🔭 [Competitor Teardown](skills/competitor-teardown) | "what are rivals up to?" | a positioning map, feature gaps & strategy |
|
|
72
75
|
| 📝 [Meeting Notes](skills/meeting-notes) | a raw transcript | decisions, owners & next steps |
|
|
73
76
|
|
|
74
|
-
→ Want proof first? See [**real sample outputs**](https://mohitagw15856.github.io/pm-claude-skills/examples.html) from each skill. Like what you see? [**Install in 2 minutes**](#-quick-install-2-minutes) · [browse all
|
|
77
|
+
→ Want proof first? See [**real sample outputs**](https://mohitagw15856.github.io/pm-claude-skills/examples.html) from each skill. Like what you see? [**Install in 2 minutes**](#-quick-install-2-minutes) · [browse all 207 skills](#️-all-207-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
|
|
75
78
|
|
|
76
79
|
---
|
|
77
80
|
|
|
78
81
|
## 🔄 One library, the whole professional workflow
|
|
79
82
|
|
|
80
|
-
These
|
|
83
|
+
These 207 skills aren't a random catalog — they cover the **full arc of professional work**, end to end. Wherever you are in the loop, there's a skill for it:
|
|
81
84
|
|
|
82
85
|
```mermaid
|
|
83
86
|
flowchart LR
|
|
@@ -96,7 +99,7 @@ flowchart LR
|
|
|
96
99
|
| **📊 Measure** | Track outcomes & analyse | `metrics-framework` · `cohort-analysis` · `ab-test-planner` · `churn-analysis` |
|
|
97
100
|
| **📣 Communicate** | Report up and out | `executive-update` · `board-deck-narrative` · `stakeholder-update` · `qbr-deck` |
|
|
98
101
|
|
|
99
|
-
> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all
|
|
102
|
+
> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 207 skills**](#️-all-207-skills) grouped by profession.
|
|
100
103
|
|
|
101
104
|
---
|
|
102
105
|
|
|
@@ -192,7 +195,7 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
|
|
|
192
195
|
|
|
193
196
|
| | **PM Skills** | Typical skill repo |
|
|
194
197
|
|---|:---:|:---:|
|
|
195
|
-
| Skills | **
|
|
198
|
+
| Skills | **207**, across 21 professions | a handful → dozens, usually one domain |
|
|
196
199
|
| Quality | **eval-scored** on a rubric + a public [benchmark](https://mohitagw15856.github.io/pm-claude-skills/benchmark.html) | trust the README |
|
|
197
200
|
| Improves itself | ✅ eval → critique → rewrite (kept only if it scores higher) | ✗ |
|
|
198
201
|
| Grounded in frameworks | ✅ each cites its source (RICE, JTBD, Pyramid Principle…) | rarely |
|
|
@@ -217,7 +220,7 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
|
|
|
217
220
|
- [📦 Plugin Directory](#-plugin-directory)
|
|
218
221
|
- [🤖 Building Blocks for Agent Templates](#-building-blocks-for-agent-templates)
|
|
219
222
|
- [🏷️ Skill Tiers — start with the strongest](#️-skill-tiers--start-with-the-strongest)
|
|
220
|
-
- [🗂️ All
|
|
223
|
+
- [🗂️ All 207 Skills](#️-all-207-skills)
|
|
221
224
|
- [📋 Changelog](#-changelog)
|
|
222
225
|
- [🤝 Contributing](#-contributing--add-your-skill)
|
|
223
226
|
- [🔗 Related Projects](#-related-projects)
|
|
@@ -226,13 +229,13 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
|
|
|
226
229
|
|
|
227
230
|
## 🚀 Quick Install (2 minutes)
|
|
228
231
|
|
|
229
|
-
**With the [`skills`](https://github.com/vercel-labs/skills) CLI** (the open agent-skills installer that works across Claude Code, Cursor, Codex, OpenCode & 60+ agents) — pick from all
|
|
232
|
+
**With the [`skills`](https://github.com/vercel-labs/skills) CLI** (the open agent-skills installer that works across Claude Code, Cursor, Codex, OpenCode & 60+ agents) — pick from all 207 interactively:
|
|
230
233
|
|
|
231
234
|
```bash
|
|
232
235
|
npx skills add mohitagw15856/pm-claude-skills # browse & pick (auto-detects your agent)
|
|
233
236
|
npx skills add mohitagw15856/pm-claude-skills --list # just preview the catalog
|
|
234
237
|
npx skills add mohitagw15856/pm-claude-skills --skill prd-template # grab one
|
|
235
|
-
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all
|
|
238
|
+
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all 207
|
|
236
239
|
```
|
|
237
240
|
|
|
238
241
|
**Or our own installer** — via the [`pm-claude-skills`](https://www.npmjs.com/package/pm-claude-skills) npm package (Windows/macOS/Linux, needs Node), which also installs subagents, slash commands & cross-tool exports:
|
|
@@ -241,7 +244,7 @@ npx skills add mohitagw15856/pm-claude-skills --skill '*' # install a
|
|
|
241
244
|
npx pm-claude-skills add --agent claude # or: codex · cursor · hermes · openclaw
|
|
242
245
|
```
|
|
243
246
|
|
|
244
|
-
**Or one-line MCP** — make all
|
|
247
|
+
**Or one-line MCP** — make all 207 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
|
|
245
248
|
|
|
246
249
|
```bash
|
|
247
250
|
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
|
|
@@ -298,7 +301,7 @@ ln -s ~/pm-claude-skills/skills/* ~/.claude/skills/
|
|
|
298
301
|
|
|
299
302
|
## 🌍 Use It Anywhere — the AI Ecosystem
|
|
300
303
|
|
|
301
|
-
The same
|
|
304
|
+
The same 207 skills reach you through every channel — pick whatever fits your stack:
|
|
302
305
|
|
|
303
306
|
| Channel | Get it |
|
|
304
307
|
|---|---|
|
|
@@ -312,7 +315,7 @@ The same 205 skills reach you through every channel — pick whatever fits your
|
|
|
312
315
|
| 🖥️ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo** — [`exports/`](exports/) |
|
|
313
316
|
| 🤖 **Agents & answer engines** | [`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt) makes the whole library discoverable & citable |
|
|
314
317
|
|
|
315
|
-
> **196 of
|
|
318
|
+
> **196 of 207 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
|
|
316
319
|
|
|
317
320
|
---
|
|
318
321
|
|
|
@@ -327,7 +330,7 @@ There are two kinds of support. **Native `SKILL.md` agents** read the file as-is
|
|
|
327
330
|
auto-discover skills from the `description` frontmatter. **Other tools** take the markdown
|
|
328
331
|
body as a system prompt — for those we ship ready-made [exports](#ready-to-use-exports).
|
|
329
332
|
|
|
330
|
-
**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all
|
|
333
|
+
**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all 207 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
|
|
331
334
|
|
|
332
335
|
| Platform | How it works | Auto-trigger? |
|
|
333
336
|
|---|---|---|
|
|
@@ -472,7 +475,7 @@ ANTHROPIC_API_KEY=sk-ant-… npx pm-claude-skills generate --from ./team-process
|
|
|
472
475
|
|
|
473
476
|
**🏆 Skill Leaderboard — [evals](evals/).** An LLM-as-judge harness scores each skill across Claude models on structure, completeness, usefulness, and grounding. **[View the leaderboard →](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)**
|
|
474
477
|
|
|
475
|
-
> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all
|
|
478
|
+
> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all 207 skills** (curated cases kept verbatim; the rest auto-generated), then `npm run eval:all` runs the full pass on Haiku for **~$2** total. The weakest scorers can then be auto-rewritten with **`npm run improve -- <skill>`** (`/improve`), which keeps a change only if the score goes up.
|
|
476
479
|
|
|
477
480
|
---
|
|
478
481
|
|
|
@@ -508,7 +511,7 @@ Not sure which plugin to install? Here's what each one covers:
|
|
|
508
511
|
| **pm-advanced** | ai-ethics-review, ai-product-canvas, experiment-designer, design-handoff-brief, multi-source-signal-synthesiser | For PMs working on AI products or running sophisticated experiments. Covers ethical review of AI features, AI-native product canvases, and experiment design. |
|
|
509
512
|
| **pm-analytics** | data-analysis-standard, product-health-analysis, retention-analysis | Turn raw data into PM-ready narratives. Use when you need to frame an analysis, explain health metrics to leadership, or diagnose retention drop-offs. |
|
|
510
513
|
| **pm-business** | board-deck-narrative, investor-update, job-application | For PMs operating at the business layer — writing board narratives, investor updates, or crafting a standout job application. |
|
|
511
|
-
| **pm-cross** | executive-summary, grant-proposal, last-30-days-research, notebooklm-connector, press-release, sycophancy-challenger, teaching-lesson-plan | Cross-profession utility skills that work outside a single domain — writing executive summaries, press releases, running research, and challenging sycophantic AI output. |
|
|
514
|
+
| **pm-cross** | executive-summary, grant-proposal, last-30-days-research, notebooklm-connector, press-release, professional-brain, sycophancy-challenger, teaching-lesson-plan | Cross-profession utility skills that work outside a single domain — writing executive summaries, press releases, running research, and challenging sycophantic AI output, and giving the skills a durable memory with professional-brain. |
|
|
512
515
|
| **pm-cs** | churn-analysis, cs-escalation-brief, cs-health-scorecard, customer-success-plan, qbr-deck, renewal-playbook | For PMs or CSMs responsible for retention. Covers churn diagnosis, escalation briefs, QBR decks, health scorecards, and renewal plays. |
|
|
513
516
|
| **pm-data** | chart-data-extractor, cohort-analysis, dashboard-brief, data-pipeline-spec, metrics-framework, sql-query-explainer | Data-heavy work: extracting insights from charts, building metrics frameworks, explaining SQL queries, designing dashboards, and speccing data pipelines. |
|
|
514
517
|
| **pm-delivery** | ab-test-planner, go-to-market-planner, pptx-slide-auditor, product-launch-checklist, retro-analysis, sprint-brief, sprint-planning, technical-spec-template, user-story-writer | Everything you need to ship: sprint planning, user stories, launch checklists, A/B test design, retros, and PowerPoint auditing. The most-used plugin for day-to-day delivery. |
|
|
@@ -548,7 +551,7 @@ Not sure which plugin to install? Here's what each one covers:
|
|
|
548
551
|
|
|
549
552
|
On May 5, 2026, Anthropic [released their first agent templates](https://www.anthropic.com/news/finance-agents) — pre-packaged Claude agents that combine **skills, connectors, and subagents** into ready-to-run workflows for financial services.
|
|
550
553
|
|
|
551
|
-
This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The
|
|
554
|
+
This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The 207 skills here are the building blocks for agent templates outside of finance.**
|
|
552
555
|
|
|
553
556
|
### What is an agent template?
|
|
554
557
|
|
|
@@ -627,11 +630,11 @@ More templates will follow. If you want to contribute one, see the [template con
|
|
|
627
630
|
|
|
628
631
|
## 📋 Changelog
|
|
629
632
|
|
|
630
|
-
**Latest: v28.1.0 — Integrations (n8n, Lovable, Obsidian) + a `/v1` REST API.** PM Skills now runs inside [n8n](connectors/n8n.md), powers [Lovable](connectors/lovable.md) apps, and lives in your [Obsidian](connectors/obsidian.md) vault — all backed by a read-only REST API on the hosted Worker (auto-deployed via a new GitHub Action). Builds on **v28.0.0 — live across the whole AI ecosystem.** Now public on every channel: **PyPI** (`pip install pm-skills`), a **hosted MCP connector** URL for ChatGPT/Claude.ai/Cursor, and the **official MCP registry** — plus a new **🌍 Use It Anywhere** section + PyPI/MCP header badges. Builds on the v27 ecosystem work: multi-model playground (Claude / OpenAI / Gemini / **Ollama**); a **remote MCP connector** ([`mcp-remote/`](mcp-remote/)) to add PM Skills to **ChatGPT, Claude.ai & Cursor** by URL; MCP server now serves skills as **prompts + resources**; **4 new IDE export targets** (Cline, Continue, Zed, Roo → 9 platforms); a **Python package** ([`python/`](python/), `pip install pm-skills` with LangChain/CrewAI adapters); an **`llms.txt`** for agent discovery; a reusable **[score-skills Action](.github/actions/score-skills/)**; and **MCP-registry manifests** (`server.json`, `smithery.yaml`). The full library is now eval-scored — **196 skills, avg 4.8/5**. Builds on **v26.0.0** (the Creator stack). **
|
|
633
|
+
**Latest: v28.1.0 — Integrations (n8n, Lovable, Obsidian) + a `/v1` REST API.** PM Skills now runs inside [n8n](connectors/n8n.md), powers [Lovable](connectors/lovable.md) apps, and lives in your [Obsidian](connectors/obsidian.md) vault — all backed by a read-only REST API on the hosted Worker (auto-deployed via a new GitHub Action). Builds on **v28.0.0 — live across the whole AI ecosystem.** Now public on every channel: **PyPI** (`pip install pm-skills`), a **hosted MCP connector** URL for ChatGPT/Claude.ai/Cursor, and the **official MCP registry** — plus a new **🌍 Use It Anywhere** section + PyPI/MCP header badges. Builds on the v27 ecosystem work: multi-model playground (Claude / OpenAI / Gemini / **Ollama**); a **remote MCP connector** ([`mcp-remote/`](mcp-remote/)) to add PM Skills to **ChatGPT, Claude.ai & Cursor** by URL; MCP server now serves skills as **prompts + resources**; **4 new IDE export targets** (Cline, Continue, Zed, Roo → 9 platforms); a **Python package** ([`python/`](python/), `pip install pm-skills` with LangChain/CrewAI adapters); an **`llms.txt`** for agent discovery; a reusable **[score-skills Action](.github/actions/score-skills/)**; and **MCP-registry manifests** (`server.json`, `smithery.yaml`). The full library is now eval-scored — **196 skills, avg 4.8/5**. Builds on **v26.0.0** (the Creator stack). **207 skills** across **28 bundles**, **21 professions**.
|
|
631
634
|
|
|
632
635
|
Full [Keep a Changelog](https://keepachangelog.com/)-format history — every release back to the start — is in **[CHANGELOG.md](CHANGELOG.md)**.
|
|
633
636
|
|
|
634
|
-
→ Earlier releases (v20 and before — the road from 6 to
|
|
637
|
+
→ Earlier releases (v20 and before — the road from 6 to 207 skills) are in **[CHANGELOG.md](CHANGELOG.md)**.
|
|
635
638
|
|
|
636
639
|
---
|
|
637
640
|
|
|
@@ -667,7 +670,7 @@ This repo was built alongside a published 16-part article series on Medium.
|
|
|
667
670
|
|
|
668
671
|
## 🏷️ Skill Tiers — Start With the Strongest
|
|
669
672
|
|
|
670
|
-
A
|
|
673
|
+
A 207-skill library doesn't have 207 equally-mature skills, and pretending otherwise
|
|
671
674
|
wastes your time. Skills are tiered honestly so you can start with the best work:
|
|
672
675
|
|
|
673
676
|
- 🟢 **Production-Ready (50)** — battle-tested, stable output, used in real work. Includes the three skills with computed Python helpers (sprint planning, RICE, customer health). **Start here.**
|
|
@@ -680,7 +683,7 @@ If you're new, install `pm-essentials` and try a couple of Production-Ready skil
|
|
|
680
683
|
|
|
681
684
|
---
|
|
682
685
|
|
|
683
|
-
## 🗂️ All
|
|
686
|
+
## 🗂️ All 207 Skills
|
|
684
687
|
|
|
685
688
|
Every skill, grouped by profession. **[Browse the full per-skill catalog → SKILLS.md](SKILLS.md)** · **[searchable live catalog](https://mohitagw15856.github.io/pm-claude-skills/catalog.html)** · **[run any skill in the browser](https://mohitagw15856.github.io/pm-claude-skills/)**
|
|
686
689
|
|
|
@@ -703,7 +706,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
|
|
|
703
706
|
| 🤝 Sales | `pm-sales` | 6 | `sales-battlecard` |
|
|
704
707
|
| ⚙️ Operations | `pm-operations` | 10 | `sop-writer` |
|
|
705
708
|
| 🏥 Research & Healthcare | `pm-research` | 4 | `literature-review` |
|
|
706
|
-
| 🌐 Cross-Profession | `pm-cross` |
|
|
709
|
+
| 🌐 Cross-Profession | `pm-cross` | 10 | `meeting-notes` · `professional-brain` · `action-runner` |
|
|
707
710
|
| 🖼️ Figma | `pm-figma` | 10 | `figma-design-review` |
|
|
708
711
|
| 📱 Social Media | `pm-social` | 5 | `social-media-strategy` |
|
|
709
712
|
| ✍️ Writers & Content | `pm-writers` | 6 | `aeo-optimizer` |
|
|
@@ -714,7 +717,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
|
|
|
714
717
|
|
|
715
718
|
## ❤️ Sponsor This Work
|
|
716
719
|
|
|
717
|
-
Building and maintaining
|
|
720
|
+
Building and maintaining 207 skills across 28 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
|
|
718
721
|
|
|
719
722
|
If these skills save you time at work — or you're a company that wants your logo in front of the PMs, engineers, and operators who use them daily — **[become a sponsor →](https://github.com/sponsors/mohitagw15856)** (or [☕ buy me a coffee](https://www.buymeacoffee.com/mohit15856)).
|
|
720
723
|
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Set up or use your Professional Brain — init, ingest, recall, or review.
|
|
3
|
+
argument-hint: [init | ingest <thing> | recall <query> | review]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Apply the **professional-brain** skill to: $ARGUMENTS
|
|
7
|
+
|
|
8
|
+
- `init` — scaffold `brain/` (copy from `templates/brain/`) and migrate any existing `pm-context.md`.
|
|
9
|
+
- `ingest <thing>` — save the original to `source/`, synthesise facts into the durable layer, tag each with provenance.
|
|
10
|
+
- `recall <query>` — answer from memory using `scripts/brain_query.py`, citing each fact's file and tag; say so if memory is thin.
|
|
11
|
+
- `review` — weekly sweep: flag stale hypotheses, decisions due to reopen, and contradictions.
|
|
12
|
+
|
|
13
|
+
Default the brain location to `./brain/`. Never invent facts the brain doesn't hold, and never drop provenance tags.
|
package/connectors/lovable.md
CHANGED
|
@@ -73,7 +73,7 @@ just works.
|
|
|
73
73
|
|
|
74
74
|
```text
|
|
75
75
|
KNOWLEDGE: PM Skills integration
|
|
76
|
-
PM Skills is a free, read-only, CORS-open catalogue of
|
|
76
|
+
PM Skills is a free, read-only, CORS-open catalogue of 206 professional "skill"
|
|
77
77
|
prompts (PRDs, exec updates, launch plans, etc.). Use it whenever the app needs to
|
|
78
78
|
produce a structured professional document.
|
|
79
79
|
|
package/connectors/n8n.md
CHANGED
|
@@ -12,7 +12,7 @@ There are three ways in, from zero-build to native. Pick by how much you want to
|
|
|
12
12
|
## Tier 0 — MCP Client node (works today, no build)
|
|
13
13
|
|
|
14
14
|
n8n's **AI Agent** node can use any external MCP server as a tool via the **MCP Client Tool**
|
|
15
|
-
node. Point it at the hosted PM Skills connector and all
|
|
15
|
+
node. Point it at the hosted PM Skills connector and all 206 skills + 6 workflow recipes
|
|
16
16
|
become tools the agent can call on demand.
|
|
17
17
|
|
|
18
18
|
1. Add an **AI Agent** node (with your Anthropic/OpenAI credential).
|
package/exports/README.md
CHANGED
|
@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
|
|
|
8
8
|
node scripts/build-exports.mjs
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Currently exporting **
|
|
11
|
+
Currently exporting **207 skills** to:
|
|
12
12
|
|
|
13
13
|
- **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
|
|
14
14
|
- **Google Gemini — Gem instructions** → `exports/gemini/`
|
package/exports/aider/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** — edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
207 skills exported. Copy a `.mdc rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
| A/B Test Readout | `pm-data` | `pm-data/ab-test-readout/ab-test-readout.md` |
|
|
13
13
|
| Accessibility Audit | `pm-design` | `pm-design/accessibility-audit/accessibility-audit.md` |
|
|
14
14
|
| Account Plan | `pm-sales` | `pm-sales/account-plan/account-plan.md` |
|
|
15
|
+
| Action Runner | `pm-cross` | `pm-cross/action-runner/action-runner.md` |
|
|
15
16
|
| AEO Optimizer | `pm-writers` | `pm-writers/aeo-optimizer/aeo-optimizer.md` |
|
|
16
17
|
| AI Ethics Review | `pm-advanced` | `pm-advanced/ai-ethics-review/ai-ethics-review.md` |
|
|
17
18
|
| AI Product Canvas | `pm-advanced` | `pm-advanced/ai-product-canvas/ai-product-canvas.md` |
|
|
@@ -149,6 +150,7 @@
|
|
|
149
150
|
| Product Health Analysis | `pm-analytics` | `pm-analytics/product-health-analysis/product-health-analysis.md` |
|
|
150
151
|
| Product Launch Checklist | `pm-delivery` | `pm-delivery/product-launch-checklist/product-launch-checklist.md` |
|
|
151
152
|
| Product Positioning Doc | `pm-gtm` | `pm-gtm/product-positioning-doc/product-positioning-doc.md` |
|
|
153
|
+
| Professional Brain | `pm-cross` | `pm-cross/professional-brain/professional-brain.md` |
|
|
152
154
|
| Project Status Report | `pm-operations` | `pm-operations/project-status-report/project-status-report.md` |
|
|
153
155
|
| Proposal Writer | `pm-sales` | `pm-sales/proposal-writer/proposal-writer.md` |
|
|
154
156
|
| QBR Deck | `pm-cs` | `pm-cs/qbr-deck/qbr-deck.md` |
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Action Runner Skill
|
|
2
|
+
|
|
3
|
+
The library is great at *recommending* work. This skill executes it — the action layer of the
|
|
4
|
+
[Professional Brain](../professional-brain/SKILL.md) (Phase 2). A skill says "open a ticket per
|
|
5
|
+
checklist item"; this turns that into real GitHub/Linear/Slack actions, **safely**: previewed,
|
|
6
|
+
risk-rated, approved, then recorded. The cardinal rule: **nothing acts silently.**
|
|
7
|
+
|
|
8
|
+
## What This Skill Produces
|
|
9
|
+
|
|
10
|
+
1. A **dry-run actions plan** — every proposed action with its target, operation, and **risk**.
|
|
11
|
+
2. After approval, the **executed actions** (via the connected action MCP) — outbound/destructive
|
|
12
|
+
ones gated individually.
|
|
13
|
+
3. A **record back to the brain** of what was actually done, with provenance.
|
|
14
|
+
|
|
15
|
+
## Required Inputs
|
|
16
|
+
|
|
17
|
+
Ask for (if not already provided):
|
|
18
|
+
- **The recommendations to act on** (a launch checklist, PRD requirements, postmortem follow-ups…).
|
|
19
|
+
- **The connected action MCP** and **targets** — which GitHub repo / Linear project / Slack channel. Scope is limited to what the user names; never act outside it.
|
|
20
|
+
- **Approval posture** — what may run with a single OK vs. what needs per-action confirmation.
|
|
21
|
+
|
|
22
|
+
## How it works
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
recommend → build an actions plan (JSON) → preview + risk-gate → approve → execute → record
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
1. **Build the plan** — express each action as JSON: `{"target","op","args","why","risk?"}`.
|
|
29
|
+
2. **Preview + gate** — run the helper; it prints a dry-run, classifies risk (🟢 low / 🟡 medium /
|
|
30
|
+
🔴 high), and **refuses to proceed while any 🔴 outbound/destructive action is unapproved**:
|
|
31
|
+
```bash
|
|
32
|
+
echo '<plan json>' | python3 scripts/action_preview.py -
|
|
33
|
+
# after the user approves the risky ones:
|
|
34
|
+
echo '<plan json>' | python3 scripts/action_preview.py - --allow-high
|
|
35
|
+
```
|
|
36
|
+
3. **Approve** — low/medium can run on a single confirmation; every 🔴 (post, send, delete, deploy,
|
|
37
|
+
merge, charge…) needs explicit per-action approval. Default is **do nothing** until told.
|
|
38
|
+
4. **Execute** — only approved actions, only via the connected action MCP (e.g. Composio/GitHub
|
|
39
|
+
`create_issue`). One target at a time; stop and report on the first failure.
|
|
40
|
+
5. **Record** — append what was actually done to the brain so the loop closes:
|
|
41
|
+
```bash
|
|
42
|
+
python3 ../professional-brain/scripts/brain_write.py ./brain decisions "Filed launch tickets" \
|
|
43
|
+
--tag external --body "Opened 7 issues in acme/app from the launch checklist" --commit
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Safety rules (non-negotiable)
|
|
47
|
+
|
|
48
|
+
- **Dry-run by default.** The plan is shown before anything runs.
|
|
49
|
+
- **Approval-gated.** No execution without a yes; 🔴 actions are confirmed one by one.
|
|
50
|
+
- **Scope-limited.** Only the repos/channels/projects the user named.
|
|
51
|
+
- **Logged.** Every executed action is recorded to the brain with an `[external]` tag and a link.
|
|
52
|
+
- **No silent retries, no bulk outbound.** If a step fails, stop and surface it.
|
|
53
|
+
|
|
54
|
+
## The contract for other skills
|
|
55
|
+
|
|
56
|
+
An action-aware skill adds a short **"Proposes Actions"** section: after producing its artifact,
|
|
57
|
+
it lists the actions it *could* take (target · op · why), then hands off to `action-runner` —
|
|
58
|
+
which previews, gates, executes, and records. The skill never executes directly.
|
|
59
|
+
|
|
60
|
+
## Output Format
|
|
61
|
+
|
|
62
|
+
1. **Proposed actions** — a table: # · target · operation · why · risk.
|
|
63
|
+
2. **Gate result** — the preview output; the 🔴 actions needing approval called out explicitly.
|
|
64
|
+
3. **Executed** (after approval) — what ran, with links/IDs returned by the MCP.
|
|
65
|
+
4. **Recorded to the brain** — the line(s) appended, with provenance.
|
|
66
|
+
|
|
67
|
+
## Quality Checks
|
|
68
|
+
|
|
69
|
+
- [ ] A dry-run plan is shown before anything executes
|
|
70
|
+
- [ ] Every action has a risk level; 🔴 actions are individually approved
|
|
71
|
+
- [ ] Execution stays within the named scope and uses only the connected MCP
|
|
72
|
+
- [ ] Each executed action is recorded back to the brain with an `[external]` tag
|
|
73
|
+
- [ ] On failure, it stops and reports rather than retrying blindly
|
|
74
|
+
|
|
75
|
+
## Anti-Patterns
|
|
76
|
+
|
|
77
|
+
- Executing anything without showing the dry-run plan first
|
|
78
|
+
- Treating an outbound/destructive action (post, email, delete, deploy) as low-risk
|
|
79
|
+
- Acting outside the scope the user named, or fanning out to many targets
|
|
80
|
+
- "Helpfully" doing more than was approved
|
|
81
|
+
- Forgetting to record what was done — the brain must reflect reality
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
# Professional Brain Skill
|
|
2
|
+
|
|
3
|
+
Most skills start cold — you paste the same context every time, and decisions made six weeks
|
|
4
|
+
ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
|
|
5
|
+
on disk that skills read before they answer and write to after. No vector DB, no cloud — just
|
|
6
|
+
grep-able files you (and Claude) can audit and edit.
|
|
7
|
+
|
|
8
|
+
This is the **state layer** of an AI teammate. Pair it with the action layer (skills that file
|
|
9
|
+
tickets / open PRs) and you get a loop: *recall → do the work → record the decision → review.*
|
|
10
|
+
|
|
11
|
+
## What This Skill Produces
|
|
12
|
+
|
|
13
|
+
- A scaffolded **`brain/` folder** with a fixed schema (see below).
|
|
14
|
+
- **Provenance-tagged** knowledge — every claim says where it came from and how strong it is.
|
|
15
|
+
- Four operations you can invoke: **init**, **ingest**, **recall**, **review**.
|
|
16
|
+
- A standing contract other skills follow: *read the relevant brain files first; write durable
|
|
17
|
+
outcomes (decisions, new facts, stakeholder asks) back.*
|
|
18
|
+
|
|
19
|
+
## Required Inputs
|
|
20
|
+
|
|
21
|
+
Ask for these only if they aren't already on disk or in the request:
|
|
22
|
+
|
|
23
|
+
- **Which operation** — `init`, `ingest`, `recall`, or `review` (default: infer from the ask).
|
|
24
|
+
- For **ingest**: the artifact (a pasted note, a file path, a transcript) and what it's about.
|
|
25
|
+
- For **recall**: the topic or question to answer from memory.
|
|
26
|
+
- The **brain location** — default `./brain/` at the project root.
|
|
27
|
+
|
|
28
|
+
## The Brain Schema
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
brain/
|
|
32
|
+
context.md # who/what: product, ICP, metrics definitions, voice (supersedes pm-context.md)
|
|
33
|
+
knowledge/ # durable facts — strategy.md, market.md, users.md, org.md
|
|
34
|
+
decisions/ # one file per decision: what, why, alternatives rejected, reopen-when
|
|
35
|
+
hypotheses/ # assumptions: statement, evidence, status (open/validated/invalidated)
|
|
36
|
+
stakeholders/ # one file per person: asks, concerns, comms history
|
|
37
|
+
entities/ # typed objects: features, accounts, experiments — the artifact graph
|
|
38
|
+
source/ # immutable originals (audit trail) — never edited after capture
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
It is Obsidian-vault compatible: open `brain/` as a vault and the links become a graph.
|
|
42
|
+
|
|
43
|
+
## Provenance Tags (the trust mechanism)
|
|
44
|
+
|
|
45
|
+
Every fact carries a tag in square brackets so its strength is explicit. Skills must keep the
|
|
46
|
+
tag when they reuse a fact, and **downgrade confidence for weak tags**.
|
|
47
|
+
|
|
48
|
+
| Tag | Means | Strength |
|
|
49
|
+
|---|---|---|
|
|
50
|
+
| `[data]` | from analytics / a metric / a measured result | strong |
|
|
51
|
+
| `[interview]` | from a documented user or customer interview | strong |
|
|
52
|
+
| `[external]` | from third-party / market research | medium |
|
|
53
|
+
| `[verbal]` | said in a meeting, not independently documented | weak |
|
|
54
|
+
| `[hunch]` | informed intuition, no evidence yet | weakest |
|
|
55
|
+
|
|
56
|
+
Example: `Mobile drives 65% of DAU [data]. Enterprise wants SSO before renewing [verbal].`
|
|
57
|
+
|
|
58
|
+
## Operations
|
|
59
|
+
|
|
60
|
+
**init** — Create the folder schema. Migrate an existing `pm-context.md` into `context.md`.
|
|
61
|
+
Offer to ingest any artifacts the user already has (Notion export, Jira CSV, notes).
|
|
62
|
+
|
|
63
|
+
**ingest `<thing>`** — Store the original verbatim in `source/`, then synthesise it into the
|
|
64
|
+
right durable file(s) (`knowledge/`, `decisions/`, `hypotheses/`, `stakeholders/`), tagging each
|
|
65
|
+
extracted claim with its provenance. Never discard the source.
|
|
66
|
+
|
|
67
|
+
**recall `<query>`** — Answer from memory. Use the helper script to find matching facts across
|
|
68
|
+
the brain, then synthesise an answer that **cites each fact's file and tag**. If memory is thin,
|
|
69
|
+
say so rather than inventing.
|
|
70
|
+
|
|
71
|
+
**record** — The write-back half of the loop (Phase 1). After a skill produces an artifact (or on
|
|
72
|
+
demand), extract the **durable outcomes** worth remembering — decisions made, new facts learned,
|
|
73
|
+
assumptions surfaced, stakeholder asks — and propose them as a numbered list, each with its
|
|
74
|
+
**target section** and **provenance tag**. This is the action surface, so it is **approval-gated
|
|
75
|
+
and dry-run by default**:
|
|
76
|
+
|
|
77
|
+
1. **Propose** — show the records you'd write (section · tag · text). Preview with
|
|
78
|
+
`brain_write.py …` (no `--commit`), which prints exactly what would be appended.
|
|
79
|
+
2. **Approve** — the user confirms, edits, or drops items. Never write without a yes.
|
|
80
|
+
3. **Append** — write the approved records with `--commit`. Append-only: decisions become a new
|
|
81
|
+
numbered file; everything else appends to its named file. Nothing is overwritten.
|
|
82
|
+
|
|
83
|
+
Downgrade weak evidence honestly — a conclusion from one call is `[interview]`, a gut call is
|
|
84
|
+
`[hunch]`; don't launder it into `[data]`.
|
|
85
|
+
|
|
86
|
+
**review** — Weekly sweep. Flag: stale hypotheses (open too long with no new evidence),
|
|
87
|
+
decisions whose `reopen-when` condition now holds, contradictions between files, and facts that
|
|
88
|
+
are only `[hunch]`/`[verbal]` but are being treated as settled. Draft the updates; don't apply
|
|
89
|
+
silently.
|
|
90
|
+
|
|
91
|
+
## Programmatic Helper
|
|
92
|
+
|
|
93
|
+
`scripts/brain_query.py` (stdlib only) does deterministic recall — it greps the brain for a
|
|
94
|
+
query and returns matches with their file and detected provenance tag, so retrieval is
|
|
95
|
+
transparent (no embeddings, no guessing).
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
# Find what the brain knows about "activation", newest-first, as text
|
|
99
|
+
python3 scripts/brain_query.py ./brain "activation"
|
|
100
|
+
|
|
101
|
+
# JSON for chaining into another step
|
|
102
|
+
python3 scripts/brain_query.py ./brain "enterprise SSO" --json
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Use its output as the grounded evidence set, then synthesise the answer on top — never answer a
|
|
106
|
+
recall from outside the brain without saying so.
|
|
107
|
+
|
|
108
|
+
`scripts/brain_write.py` is the write-back counterpart — it **appends** a provenance-tagged record
|
|
109
|
+
(append-only, never overwrites) and is **dry-run by default** so you can preview before committing:
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
# Preview what would be written (changes nothing):
|
|
113
|
+
python3 scripts/brain_write.py ./brain decisions "Prioritise mobile" --tag data --body "68% of churn is mobile" --source "Q3 analytics"
|
|
114
|
+
|
|
115
|
+
# Write it after approval:
|
|
116
|
+
python3 scripts/brain_write.py ./brain decisions "Prioritise mobile" --tag data --body "…" --source "Q3 analytics" --commit
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## The contract for other skills
|
|
120
|
+
|
|
121
|
+
A brain-aware skill adds a short **"Reads from / Writes to the Brain"** section:
|
|
122
|
+
|
|
123
|
+
- **Reads:** before producing, pull the relevant files (e.g. `prd-template` reads `context.md`,
|
|
124
|
+
`knowledge/strategy.md`, and any related `hypotheses/` + `entities/`).
|
|
125
|
+
- **Writes:** after producing, append durable outcomes (e.g. `meeting-notes` writes each
|
|
126
|
+
decision to `decisions/`, new asks to the relevant `stakeholders/` file), each provenance-tagged.
|
|
127
|
+
|
|
128
|
+
## Output Format
|
|
129
|
+
|
|
130
|
+
For **ingest**, confirm what was captured:
|
|
131
|
+
|
|
132
|
+
### Ingested: [artifact]
|
|
133
|
+
- **Source saved:** `source/[file]`
|
|
134
|
+
- **Knowledge updated:** `knowledge/[file]` — [facts added, each tagged]
|
|
135
|
+
- **Decisions logged:** `decisions/[id]` — [if any]
|
|
136
|
+
- **Hypotheses touched:** [statement → status]
|
|
137
|
+
- **Open follow-ups:** [anything needing a human]
|
|
138
|
+
|
|
139
|
+
For **recall**, answer then show your grounding:
|
|
140
|
+
|
|
141
|
+
### Recall: [query]
|
|
142
|
+
[Synthesised answer.]
|
|
143
|
+
|
|
144
|
+
**Grounded in:**
|
|
145
|
+
- `decisions/0003-...md` — "..." `[data]`
|
|
146
|
+
- `stakeholders/sarah.md` — "..." `[verbal]`
|
|
147
|
+
|
|
148
|
+
## Quality Checks
|
|
149
|
+
|
|
150
|
+
- [ ] Every extracted claim carries a provenance tag
|
|
151
|
+
- [ ] The verbatim original is saved in `source/` before synthesis
|
|
152
|
+
- [ ] Recall answers cite the file + tag for each fact, and flag thin memory instead of inventing
|
|
153
|
+
- [ ] Decisions record the rejected alternatives and a `reopen-when` condition
|
|
154
|
+
- [ ] `[hunch]`/`[verbal]` facts are never presented with the confidence of `[data]`/`[interview]`
|
|
155
|
+
|
|
156
|
+
## Anti-Patterns
|
|
157
|
+
|
|
158
|
+
- [ ] Do not paraphrase a source into the durable layer without keeping the original in `source/` — the audit trail is the point
|
|
159
|
+
- [ ] Do not drop provenance tags when reusing a fact — an untagged claim is an unfalsifiable one
|
|
160
|
+
- [ ] Do not answer a recall from general knowledge and present it as something the brain "knows" — say when memory is empty
|
|
161
|
+
- [ ] Do not overwrite a decision when it changes — append a new dated entry so the history survives
|
|
162
|
+
- [ ] Do not build a vector database or hide memory behind embeddings — the brain stays plain, grep-able markdown a human can read and correct
|
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
Produce a structured churn analysis that goes beyond the headline rate — identifying why customers leave, which segments are most at risk, and what interventions will have the highest impact on retention.
|
|
4
4
|
|
|
5
|
+
## Reads from / Writes to the Brain
|
|
6
|
+
|
|
7
|
+
If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, ground in it instead of re-asking for what you already know:
|
|
8
|
+
|
|
9
|
+
- **Read first:** `context.md` (metric definitions — what "churn" means here), `knowledge/`, and related segment `entities/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "churn"` and carry each fact's provenance tag through.
|
|
10
|
+
- **📥 Propose to the Brain:** after producing, propose recording the headline retention finding to `knowledge/` (`[data]`), any retention decision to `decisions/`, and at-risk drivers as `hypotheses/`. Show them, get a yes, then write with `../professional-brain/scripts/brain_write.py … --commit` (append-only, dry-run by default).
|
|
11
|
+
|
|
5
12
|
## Required Inputs
|
|
6
13
|
|
|
7
14
|
Ask for these if not already provided:
|
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
Produce a structured, data-driven health scorecard for a customer account — giving the CSM and leadership a clear view of renewal risk, expansion potential, and the actions needed to move the account in the right direction.
|
|
4
4
|
|
|
5
|
+
## Reads from / Writes to the Brain
|
|
6
|
+
|
|
7
|
+
If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, ground in it instead of re-asking for what you already know:
|
|
8
|
+
|
|
9
|
+
- **Read first:** the account's `entities/` file, its `stakeholders/` (champion, economic buyer, detractors), and `knowledge/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<account name>"` and carry each fact's provenance tag through.
|
|
10
|
+
- **📥 Propose to the Brain:** after producing, propose recording the health verdict + key risks to the account `entities/` file, and a renewal-risk entry to `decisions/` if a call is made, each provenance-tagged. Show them, get a yes, then write with `../professional-brain/scripts/brain_write.py … --commit` (append-only, dry-run by default).
|
|
11
|
+
|
|
5
12
|
## Required Inputs
|
|
6
13
|
|
|
7
14
|
Ask for these if not already provided:
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Never launch without checking everything. Generate a complete, role-assigned checklist covering pre-launch readiness, launch day execution, and post-launch monitoring.
|
|
4
4
|
|
|
5
|
+
## Proposes Actions
|
|
6
|
+
|
|
7
|
+
Once the checklist is approved, it can be *executed*: hand the items to [`action-runner`](../action-runner/SKILL.md), which previews them (dry-run, risk-rated), runs only what you approve via the connected action MCP (GitHub/Linear/Slack), and records what was done back to the brain. Typical: **open an issue per checklist item** in the named repo/project (🟡), and **post the launch summary to Slack** (🔴 — approved individually). This skill proposes; action-runner gates and runs — never silently.
|
|
8
|
+
|
|
5
9
|
## Required Inputs
|
|
6
10
|
|
|
7
11
|
Ask the user for these if not provided:
|
|
@@ -2,6 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
Transform raw backlog items into a structured, achievable sprint with clear goals, velocity-calibrated scope, and team-ready output.
|
|
4
4
|
|
|
5
|
+
## Reads from / Writes to the Brain
|
|
6
|
+
|
|
7
|
+
If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, ground in it instead of re-asking for what you already know:
|
|
8
|
+
|
|
9
|
+
- **Read first:** priority `decisions/` (what the team agreed matters), feature `entities/`, and open `hypotheses/` the sprint might test. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<sprint goal>"` and carry each fact's provenance tag through.
|
|
10
|
+
- **📥 Propose to the Brain:** after producing, propose logging the sprint commitment (goal + committed scope) as a `decisions/` record, provenance-tagged. Show it, get a yes, then write with `../professional-brain/scripts/brain_write.py … --commit` (append-only, dry-run by default).
|
|
11
|
+
|
|
12
|
+
## Proposes Actions
|
|
13
|
+
|
|
14
|
+
Once the sprint is agreed, hand it to [`action-runner`](../action-runner/SKILL.md): it previews (dry-run, risk-rated), runs only what you approve via the connected action MCP, and records what was done back to the brain. Typical: **create a ticket per committed backlog item** and **set the sprint milestone** (🟡). This skill proposes; action-runner gates and runs — never silently.
|
|
15
|
+
|
|
5
16
|
## What This Skill Produces
|
|
6
17
|
|
|
7
18
|
- **Sprint Goal** — single, outcome-focused sentence the whole team can rally around
|
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
This skill produces a complete, blameless incident postmortem document following industry-standard format. Output enforces blameless framing throughout — system gaps over individual failures — and drives toward specific, closeable action items rather than vague process commitments.
|
|
4
4
|
|
|
5
|
+
## Proposes Actions
|
|
6
|
+
|
|
7
|
+
The action items don't have to stay on the page: hand them to [`action-runner`](../action-runner/SKILL.md), which previews them (dry-run, risk-rated), runs only what you approve via the connected action MCP, and records what was done back to the brain. Typical: **file a follow-up issue per action item** (🟡), assigned to its owner with a due date. This skill proposes; action-runner gates and runs — never silently.
|
|
8
|
+
|
|
5
9
|
## Required Inputs
|
|
6
10
|
|
|
7
11
|
Ask the user for these if not provided:
|