pm-claude-skills 28.1.0 → 28.2.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.
Files changed (148) hide show
  1. package/README.md +28 -25
  2. package/commands/brain.md +13 -0
  3. package/connectors/lovable.md +1 -1
  4. package/connectors/n8n.md +1 -1
  5. package/exports/README.md +1 -1
  6. package/exports/aider/README.md +2 -1
  7. package/exports/aider/pm-cross/professional-brain/professional-brain.md +162 -0
  8. package/exports/aider/pm-cs/churn-analysis/churn-analysis.md +7 -0
  9. package/exports/aider/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  10. package/exports/aider/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  11. package/exports/aider/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  12. package/exports/aider/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  13. package/exports/aider/pm-essentials/prd-template/prd-template.md +12 -0
  14. package/exports/aider/pm-planning/okr-builder/okr-builder.md +7 -0
  15. package/exports/aider/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  16. package/exports/aider/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  17. package/exports/aider/pm-strategy/executive-update/executive-update.md +7 -0
  18. package/exports/chatgpt/README.md +2 -1
  19. package/exports/chatgpt/pm-cross/professional-brain/SYSTEM_PROMPT.md +162 -0
  20. package/exports/chatgpt/pm-cs/churn-analysis/SYSTEM_PROMPT.md +7 -0
  21. package/exports/chatgpt/pm-cs/cs-health-scorecard/SYSTEM_PROMPT.md +7 -0
  22. package/exports/chatgpt/pm-delivery/sprint-planning/SYSTEM_PROMPT.md +7 -0
  23. package/exports/chatgpt/pm-essentials/competitive-analysis/SYSTEM_PROMPT.md +7 -0
  24. package/exports/chatgpt/pm-essentials/meeting-notes/SYSTEM_PROMPT.md +11 -0
  25. package/exports/chatgpt/pm-essentials/prd-template/SYSTEM_PROMPT.md +12 -0
  26. package/exports/chatgpt/pm-planning/okr-builder/SYSTEM_PROMPT.md +7 -0
  27. package/exports/chatgpt/pm-planning/rice-prioritisation/SYSTEM_PROMPT.md +7 -0
  28. package/exports/chatgpt/pm-planning/roadmap-narrative/SYSTEM_PROMPT.md +7 -0
  29. package/exports/chatgpt/pm-strategy/executive-update/SYSTEM_PROMPT.md +7 -0
  30. package/exports/cline/README.md +2 -1
  31. package/exports/cline/pm-cross/professional-brain/professional-brain.md +162 -0
  32. package/exports/cline/pm-cs/churn-analysis/churn-analysis.md +7 -0
  33. package/exports/cline/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  34. package/exports/cline/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  35. package/exports/cline/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  36. package/exports/cline/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  37. package/exports/cline/pm-essentials/prd-template/prd-template.md +12 -0
  38. package/exports/cline/pm-planning/okr-builder/okr-builder.md +7 -0
  39. package/exports/cline/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  40. package/exports/cline/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  41. package/exports/cline/pm-strategy/executive-update/executive-update.md +7 -0
  42. package/exports/continue/README.md +2 -1
  43. package/exports/continue/pm-cross/professional-brain/professional-brain.md +167 -0
  44. package/exports/continue/pm-cs/churn-analysis/churn-analysis.md +7 -0
  45. package/exports/continue/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  46. package/exports/continue/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  47. package/exports/continue/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  48. package/exports/continue/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  49. package/exports/continue/pm-essentials/prd-template/prd-template.md +12 -0
  50. package/exports/continue/pm-planning/okr-builder/okr-builder.md +7 -0
  51. package/exports/continue/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  52. package/exports/continue/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  53. package/exports/continue/pm-strategy/executive-update/executive-update.md +7 -0
  54. package/exports/cursor/README.md +2 -1
  55. package/exports/cursor/pm-cross/professional-brain/professional-brain.mdc +168 -0
  56. package/exports/cursor/pm-cs/churn-analysis/churn-analysis.mdc +7 -0
  57. package/exports/cursor/pm-cs/cs-health-scorecard/cs-health-scorecard.mdc +7 -0
  58. package/exports/cursor/pm-delivery/sprint-planning/sprint-planning.mdc +7 -0
  59. package/exports/cursor/pm-essentials/competitive-analysis/competitive-analysis.mdc +7 -0
  60. package/exports/cursor/pm-essentials/meeting-notes/meeting-notes.mdc +11 -0
  61. package/exports/cursor/pm-essentials/prd-template/prd-template.mdc +12 -0
  62. package/exports/cursor/pm-planning/okr-builder/okr-builder.mdc +7 -0
  63. package/exports/cursor/pm-planning/rice-prioritisation/rice-prioritisation.mdc +7 -0
  64. package/exports/cursor/pm-planning/roadmap-narrative/roadmap-narrative.mdc +7 -0
  65. package/exports/cursor/pm-strategy/executive-update/executive-update.mdc +7 -0
  66. package/exports/gemini/README.md +2 -1
  67. package/exports/gemini/pm-cross/professional-brain/GEM_INSTRUCTIONS.md +166 -0
  68. package/exports/gemini/pm-cs/churn-analysis/GEM_INSTRUCTIONS.md +7 -0
  69. package/exports/gemini/pm-cs/cs-health-scorecard/GEM_INSTRUCTIONS.md +7 -0
  70. package/exports/gemini/pm-delivery/sprint-planning/GEM_INSTRUCTIONS.md +7 -0
  71. package/exports/gemini/pm-essentials/competitive-analysis/GEM_INSTRUCTIONS.md +7 -0
  72. package/exports/gemini/pm-essentials/meeting-notes/GEM_INSTRUCTIONS.md +11 -0
  73. package/exports/gemini/pm-essentials/prd-template/GEM_INSTRUCTIONS.md +12 -0
  74. package/exports/gemini/pm-planning/okr-builder/GEM_INSTRUCTIONS.md +7 -0
  75. package/exports/gemini/pm-planning/rice-prioritisation/GEM_INSTRUCTIONS.md +7 -0
  76. package/exports/gemini/pm-planning/roadmap-narrative/GEM_INSTRUCTIONS.md +7 -0
  77. package/exports/gemini/pm-strategy/executive-update/GEM_INSTRUCTIONS.md +7 -0
  78. package/exports/obsidian/README.md +2 -1
  79. package/exports/obsidian/pm-cross/professional-brain/professional-brain.md +177 -0
  80. package/exports/obsidian/pm-cs/churn-analysis/churn-analysis.md +7 -0
  81. package/exports/obsidian/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  82. package/exports/obsidian/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  83. package/exports/obsidian/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  84. package/exports/obsidian/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  85. package/exports/obsidian/pm-essentials/prd-template/prd-template.md +12 -0
  86. package/exports/obsidian/pm-planning/okr-builder/okr-builder.md +7 -0
  87. package/exports/obsidian/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  88. package/exports/obsidian/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  89. package/exports/obsidian/pm-strategy/executive-update/executive-update.md +7 -0
  90. package/exports/roo/README.md +2 -1
  91. package/exports/roo/pm-cross/professional-brain/professional-brain.md +162 -0
  92. package/exports/roo/pm-cs/churn-analysis/churn-analysis.md +7 -0
  93. package/exports/roo/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  94. package/exports/roo/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  95. package/exports/roo/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  96. package/exports/roo/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  97. package/exports/roo/pm-essentials/prd-template/prd-template.md +12 -0
  98. package/exports/roo/pm-planning/okr-builder/okr-builder.md +7 -0
  99. package/exports/roo/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  100. package/exports/roo/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  101. package/exports/roo/pm-strategy/executive-update/executive-update.md +7 -0
  102. package/exports/windsurf/README.md +2 -1
  103. package/exports/windsurf/pm-cross/professional-brain/professional-brain.md +167 -0
  104. package/exports/windsurf/pm-cs/churn-analysis/churn-analysis.md +7 -0
  105. package/exports/windsurf/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  106. package/exports/windsurf/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  107. package/exports/windsurf/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  108. package/exports/windsurf/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  109. package/exports/windsurf/pm-essentials/prd-template/prd-template.md +12 -0
  110. package/exports/windsurf/pm-planning/okr-builder/okr-builder.md +7 -0
  111. package/exports/windsurf/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  112. package/exports/windsurf/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  113. package/exports/windsurf/pm-strategy/executive-update/executive-update.md +7 -0
  114. package/exports/zed/README.md +2 -1
  115. package/exports/zed/pm-cross/professional-brain/professional-brain.md +162 -0
  116. package/exports/zed/pm-cs/churn-analysis/churn-analysis.md +7 -0
  117. package/exports/zed/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  118. package/exports/zed/pm-delivery/sprint-planning/sprint-planning.md +7 -0
  119. package/exports/zed/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  120. package/exports/zed/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  121. package/exports/zed/pm-essentials/prd-template/prd-template.md +12 -0
  122. package/exports/zed/pm-planning/okr-builder/okr-builder.md +7 -0
  123. package/exports/zed/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  124. package/exports/zed/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  125. package/exports/zed/pm-strategy/executive-update/executive-update.md +7 -0
  126. package/package.json +2 -2
  127. package/skill-tiers.json +1 -0
  128. package/skills/churn-analysis/SKILL.md +7 -0
  129. package/skills/competitive-analysis/SKILL.md +7 -0
  130. package/skills/cs-health-scorecard/SKILL.md +7 -0
  131. package/skills/executive-update/SKILL.md +7 -0
  132. package/skills/meeting-notes/SKILL.md +11 -0
  133. package/skills/okr-builder/SKILL.md +7 -0
  134. package/skills/prd-template/SKILL.md +12 -0
  135. package/skills/professional-brain/SKILL.md +167 -0
  136. package/skills/professional-brain/scripts/brain_query.py +99 -0
  137. package/skills/professional-brain/scripts/brain_write.py +117 -0
  138. package/skills/rice-prioritisation/SKILL.md +7 -0
  139. package/skills/roadmap-narrative/SKILL.md +7 -0
  140. package/skills/sprint-planning/SKILL.md +7 -0
  141. package/templates/brain/README.md +36 -0
  142. package/templates/brain/context.md +26 -0
  143. package/templates/brain/decisions/0001-prioritise-mobile-over-dashboard.md +20 -0
  144. package/templates/brain/entities/feature-mobile-revamp.md +19 -0
  145. package/templates/brain/hypotheses/mobile-retention.md +19 -0
  146. package/templates/brain/knowledge/strategy.md +10 -0
  147. package/templates/brain/source/README.md +10 -0
  148. 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 — 205 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
7
+ # 🧠 PM Skills — 206 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
8
8
 
9
9
  [![Stars](https://img.shields.io/github/stars/mohitagw15856/pm-claude-skills?style=social)](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
10
10
  [![npm](https://img.shields.io/npm/v/pm-claude-skills?logo=npm&color=cb3837)](https://www.npmjs.com/package/pm-claude-skills)
@@ -14,12 +14,13 @@
14
14
  [![MCP](https://img.shields.io/badge/MCP-registry-0098FF?logo=modelcontextprotocol&logoColor=white)](https://github.com/mohitagw15856/pm-claude-skills#-use-it-anywhere--the-ai-ecosystem)
15
15
  [![Remote MCP](https://img.shields.io/badge/ChatGPT%20%C2%B7%20Claude.ai-connector-10A37F)](mcp-remote/)
16
16
  [![Smithery](https://smithery.ai/badge/mohit15856/pm-skills)](https://smithery.ai/servers/mohit15856/pm-skills)
17
- [![Skills](https://img.shields.io/badge/skills-205-blue)](https://github.com/mohitagw15856/pm-claude-skills)
17
+ [![Skills](https://img.shields.io/badge/skills-206-blue)](https://github.com/mohitagw15856/pm-claude-skills)
18
18
  [![eval](https://img.shields.io/badge/eval--scored-196%20%C2%B7%20avg%204.8%2F5-brightgreen)](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
19
19
  [![Subagents](https://img.shields.io/badge/subagents-4-blueviolet)](agents/)
20
20
  [![Commands](https://img.shields.io/badge/slash%20commands-6-blueviolet)](commands/)
21
21
  [![Personas](https://img.shields.io/badge/personas-4-blueviolet)](output-styles/)
22
22
  [![Platforms](https://img.shields.io/badge/works%20with-Claude%20%7C%20ChatGPT%20%7C%20Gemini%20%7C%20Cursor%20%7C%20Codex%20%7C%20Hermes-8A2BE2)](#-works-with--cross-tool-compatibility)
23
+ [![Integrations](https://img.shields.io/badge/integrates%20with-n8n%20%C2%B7%20Lovable%20%C2%B7%20Obsidian-0E9F6E)](connectors/)
23
24
  [![SkillCheck](https://img.shields.io/github/actions/workflow/status/mohitagw15856/pm-claude-skills/skillcheck.yml?branch=main&label=SkillCheck)](.github/workflows/skillcheck.yml)
24
25
  [![Security Audit](https://img.shields.io/github/actions/workflow/status/mohitagw15856/pm-claude-skills/skill-audit.yml?branch=main&label=security%20audit)](.github/workflows/skill-audit.yml)
25
26
  [![Version](https://img.shields.io/github/v/release/mohitagw15856/pm-claude-skills?label=version&color=brightgreen)](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&center=true&vCenter=true&width=720&lines=205+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
33
+ <img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757&center=true&vCenter=true&width=720&lines=206+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
- > 205 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.
44
+ > 206 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**. **205 skills**. See the [changelog](#-changelog).
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**. **206 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 205 skills](#️-all-205-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
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 206 skills](#️-all-206-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 205 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:
83
+ These 206 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 205 skills**](#️-all-205-skills) grouped by profession.
102
+ > New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 206 skills**](#️-all-206-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 | **205**, across 21 professions | a handful → dozens, usually one domain |
198
+ | Skills | **206**, 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 205 Skills](#️-all-205-skills)
223
+ - [🗂️ All 206 Skills](#️-all-206-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 205 interactively:
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 206 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 205
238
+ npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all 206
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 205 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
247
+ **Or one-line MCP** — make all 206 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 205 skills reach you through every channel — pick whatever fits your stack:
304
+ The same 206 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 205 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
318
+ > **196 of 206 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 205 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
333
+ **In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all 206 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 205 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.
478
+ > **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all 206 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 205 skills here are the building blocks for agent templates outside of finance.**
554
+ This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The 206 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). **205 skills** across **28 bundles**, **21 professions**.
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). **206 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 205 skills) are in **[CHANGELOG.md](CHANGELOG.md)**.
637
+ → Earlier releases (v20 and before — the road from 6 to 206 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 205-skill library doesn't have 205 equally-mature skills, and pretending otherwise
673
+ A 206-skill library doesn't have 206 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 205 Skills
686
+ ## 🗂️ All 206 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` | 8 | `meeting-notes` · `red-team-review` |
709
+ | 🌐 Cross-Profession | `pm-cross` | 9 | `meeting-notes` · `red-team-review` |
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 205 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.
720
+ Building and maintaining 206 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.
@@ -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 205 professional "skill"
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 205 skills + 6 workflow recipes
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 **205 skills** to:
11
+ Currently exporting **206 skills** to:
12
12
 
13
13
  - **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
14
14
  - **Google Gemini — Gem instructions** → `exports/gemini/`
@@ -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
- 205 skills exported. Copy a `.mdc rule` into the tool to use it.
6
+ 206 skills exported. Copy a `.mdc rule` into the tool to use it.
7
7
 
8
8
  | Skill | Bundle | Path |
9
9
  |---|---|---|
@@ -149,6 +149,7 @@
149
149
  | Product Health Analysis | `pm-analytics` | `pm-analytics/product-health-analysis/product-health-analysis.md` |
150
150
  | Product Launch Checklist | `pm-delivery` | `pm-delivery/product-launch-checklist/product-launch-checklist.md` |
151
151
  | Product Positioning Doc | `pm-gtm` | `pm-gtm/product-positioning-doc/product-positioning-doc.md` |
152
+ | Professional Brain | `pm-cross` | `pm-cross/professional-brain/professional-brain.md` |
152
153
  | Project Status Report | `pm-operations` | `pm-operations/project-status-report/project-status-report.md` |
153
154
  | Proposal Writer | `pm-sales` | `pm-sales/proposal-writer/proposal-writer.md` |
154
155
  | QBR Deck | `pm-cs` | `pm-cs/qbr-deck/qbr-deck.md` |
@@ -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,13 @@
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
+
5
12
  ## What This Skill Produces
6
13
 
7
14
  - **Sprint Goal** — single, outcome-focused sentence the whole team can rally around
@@ -2,6 +2,13 @@
2
2
 
3
3
  Create structured competitive analyses for product decision-making.
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:** `knowledge/` (market + positioning) and competitor `entities/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<competitor or market>"` and carry each fact's provenance tag through — a competitor claim from a press release is `[external]`, not `[data]`.
10
+ - **📥 Propose to the Brain:** after producing, propose recording new competitor facts to `knowledge/` (`[external]`) and creating/updating competitor `entities/`. 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 the user for these if not provided:
@@ -10,6 +10,17 @@ Ask the user for these if not provided:
10
10
  - **Raw notes or transcript** (paste discussion notes, a transcript, or describe what was discussed)
11
11
  - **Meeting type** (1:1 / sprint planning / product review / stakeholder sync / other) — determines which template to use
12
12
 
13
+ ## Reads from / Writes to the Brain
14
+
15
+ If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, this is where notes become durable memory:
16
+
17
+ - **Read first:** the relevant `stakeholders/` files (so you arrive knowing each attendee's
18
+ open asks and concerns) and any `decisions/` the meeting revisits.
19
+ - **Write after:** append each **decision** (with its rationale and a `reopen-when`) to
20
+ `decisions/`, add new **asks/concerns** to the right `stakeholders/` file, and flag any new
21
+ **assumption** into `hypotheses/`. Tag every captured fact with its provenance — most meeting
22
+ statements are `[verbal]` until independently confirmed. Save the raw notes to `source/`.
23
+
13
24
  ## Standard Meeting Notes Template
14
25
 
15
26
  ### Meeting Header
@@ -12,6 +12,18 @@ Ask the user for these if not provided:
12
12
  - **Scope** (MVP vs full vision — what's in and out of scope)
13
13
  - **Key stakeholders** (who needs to review and approve)
14
14
 
15
+ ## Reads from / Writes to the Brain
16
+
17
+ If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, use it instead of asking for context you already have:
18
+
19
+ - **Read first:** `context.md` (product, metrics definitions, voice), `knowledge/strategy.md`
20
+ (where the product is going), any related `hypotheses/` and the matching `entities/` feature
21
+ file. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<feature>"` to pull
22
+ grounded facts, and carry their provenance tags into the PRD (don't present a `[hunch]` as a
23
+ settled requirement).
24
+ - **Write after:** save the feature as/into `entities/<feature>.md`, log any scoping decision to
25
+ `decisions/`, and add new assumptions to `hypotheses/`. Tag each with its provenance.
26
+
15
27
  ## Template Structure
16
28
 
17
29
  Every PRD should include these sections in order:
@@ -2,6 +2,13 @@
2
2
 
3
3
  Write ambitious, measurable OKRs that connect product work to company strategy. Avoid vanity metrics, output-focused key results, and objectives that sound like task lists.
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), `knowledge/strategy.md` (where the product is going), and any open `hypotheses/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<objective theme>"` and carry each fact's provenance tag through — don't set a key result off a `[hunch]` as if it were `[data]`.
10
+ - **📥 Propose to the Brain:** after producing, propose logging the chosen objectives + KR targets as a `decisions/` record (the period's bet) and any new metric definitions to `knowledge/`, 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
  ## Working from a brief
6
13
 
7
14
  You will often get a short brief without every detail (no baselines, no exact numbers). **Always deliver a complete, specific OKR set anyway** — do not stop to ask questions and do not leave bracketed placeholders like `[target]`. Where a baseline or number is missing, infer a realistic value from the brief and the domain, and mark it *(assumed — confirm)*. A clearly-labelled assumed baseline (e.g. "activation 40% *(assumed)* → 60%") is always better than a blank or an invented-as-fact figure.
@@ -2,6 +2,13 @@
2
2
 
3
3
  Apply consistent, criteria-based RICE scoring to a list of features or initiatives to produce an objective prioritisation ranking.
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:** `knowledge/strategy.md` (so the ranking serves the direction), the items as `entities/`, and impact `hypotheses/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<initiative theme>"` and carry each fact's provenance tag through — an impact estimate is usually a `[hunch]`, not `[data]`.
10
+ - **📥 Propose to the Brain:** after producing, propose recording the ranking decision to `decisions/` and the reach/impact estimates as `hypotheses/` tagged by evidence strength. 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 the user for these if not provided:
@@ -2,6 +2,13 @@
2
2
 
3
3
  Convert a ranked list of product initiatives into a clear, strategic narrative that connects individual items to company goals and communicates a coherent product 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:** `knowledge/strategy.md` (the direction the narrative must ladder to), priority `decisions/`, and feature `entities/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<roadmap theme>"` and carry each fact's provenance tag through.
10
+ - **📥 Propose to the Brain:** after producing, propose logging the sequencing/priority decisions to `decisions/` and updating the relevant feature `entities/`, 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
  ## Working from a brief
6
13
 
7
14
  You will often get a short brief (a few themes, an audience) without a full initiative list or OKRs. **Always deliver the complete narrative anyway** — do not stop to ask questions and do not leave bracketed placeholders like `[Theme Name]`. Where detail is missing, infer specific, realistic themes, initiatives, and metrics from the brief and the domain, and mark any inferred fact or number as *(assumed — confirm)*. Fill every section with concrete content, not template brackets.
@@ -2,6 +2,13 @@
2
2
 
3
3
  Produce a stakeholder update that busy executives will actually read — structured around what they care about: decisions, risks, and numbers.
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:** recent `decisions/`, `knowledge/` (the headline numbers + their definitions), and `context.md` (voice). Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<period or initiative>"` and carry provenance through — flag a metric that's only `[verbal]`.
10
+ - **📥 Propose to the Brain:** the update mostly *reads* — but propose recording any **new** decision or commitment it surfaces to `decisions/`, provenance-tagged. Show it, 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 the user for these if not provided: