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.
Files changed (182) 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 +3 -1
  7. package/exports/aider/pm-cross/action-runner/action-runner.md +81 -0
  8. package/exports/aider/pm-cross/professional-brain/professional-brain.md +162 -0
  9. package/exports/aider/pm-cs/churn-analysis/churn-analysis.md +7 -0
  10. package/exports/aider/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  11. package/exports/aider/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  12. package/exports/aider/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  13. package/exports/aider/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  14. package/exports/aider/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  15. package/exports/aider/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  16. package/exports/aider/pm-essentials/prd-template/prd-template.md +12 -0
  17. package/exports/aider/pm-planning/okr-builder/okr-builder.md +7 -0
  18. package/exports/aider/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  19. package/exports/aider/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  20. package/exports/aider/pm-strategy/executive-update/executive-update.md +7 -0
  21. package/exports/chatgpt/README.md +3 -1
  22. package/exports/chatgpt/pm-cross/action-runner/SYSTEM_PROMPT.md +81 -0
  23. package/exports/chatgpt/pm-cross/professional-brain/SYSTEM_PROMPT.md +162 -0
  24. package/exports/chatgpt/pm-cs/churn-analysis/SYSTEM_PROMPT.md +7 -0
  25. package/exports/chatgpt/pm-cs/cs-health-scorecard/SYSTEM_PROMPT.md +7 -0
  26. package/exports/chatgpt/pm-delivery/product-launch-checklist/SYSTEM_PROMPT.md +4 -0
  27. package/exports/chatgpt/pm-delivery/sprint-planning/SYSTEM_PROMPT.md +11 -0
  28. package/exports/chatgpt/pm-engineering/incident-postmortem/SYSTEM_PROMPT.md +4 -0
  29. package/exports/chatgpt/pm-essentials/competitive-analysis/SYSTEM_PROMPT.md +7 -0
  30. package/exports/chatgpt/pm-essentials/meeting-notes/SYSTEM_PROMPT.md +11 -0
  31. package/exports/chatgpt/pm-essentials/prd-template/SYSTEM_PROMPT.md +12 -0
  32. package/exports/chatgpt/pm-planning/okr-builder/SYSTEM_PROMPT.md +7 -0
  33. package/exports/chatgpt/pm-planning/rice-prioritisation/SYSTEM_PROMPT.md +7 -0
  34. package/exports/chatgpt/pm-planning/roadmap-narrative/SYSTEM_PROMPT.md +7 -0
  35. package/exports/chatgpt/pm-strategy/executive-update/SYSTEM_PROMPT.md +7 -0
  36. package/exports/cline/README.md +3 -1
  37. package/exports/cline/pm-cross/action-runner/action-runner.md +81 -0
  38. package/exports/cline/pm-cross/professional-brain/professional-brain.md +162 -0
  39. package/exports/cline/pm-cs/churn-analysis/churn-analysis.md +7 -0
  40. package/exports/cline/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  41. package/exports/cline/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  42. package/exports/cline/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  43. package/exports/cline/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  44. package/exports/cline/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  45. package/exports/cline/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  46. package/exports/cline/pm-essentials/prd-template/prd-template.md +12 -0
  47. package/exports/cline/pm-planning/okr-builder/okr-builder.md +7 -0
  48. package/exports/cline/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  49. package/exports/cline/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  50. package/exports/cline/pm-strategy/executive-update/executive-update.md +7 -0
  51. package/exports/continue/README.md +3 -1
  52. package/exports/continue/pm-cross/action-runner/action-runner.md +86 -0
  53. package/exports/continue/pm-cross/professional-brain/professional-brain.md +167 -0
  54. package/exports/continue/pm-cs/churn-analysis/churn-analysis.md +7 -0
  55. package/exports/continue/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  56. package/exports/continue/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  57. package/exports/continue/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  58. package/exports/continue/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  59. package/exports/continue/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  60. package/exports/continue/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  61. package/exports/continue/pm-essentials/prd-template/prd-template.md +12 -0
  62. package/exports/continue/pm-planning/okr-builder/okr-builder.md +7 -0
  63. package/exports/continue/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  64. package/exports/continue/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  65. package/exports/continue/pm-strategy/executive-update/executive-update.md +7 -0
  66. package/exports/cursor/README.md +3 -1
  67. package/exports/cursor/pm-cross/action-runner/action-runner.mdc +87 -0
  68. package/exports/cursor/pm-cross/professional-brain/professional-brain.mdc +168 -0
  69. package/exports/cursor/pm-cs/churn-analysis/churn-analysis.mdc +7 -0
  70. package/exports/cursor/pm-cs/cs-health-scorecard/cs-health-scorecard.mdc +7 -0
  71. package/exports/cursor/pm-delivery/product-launch-checklist/product-launch-checklist.mdc +4 -0
  72. package/exports/cursor/pm-delivery/sprint-planning/sprint-planning.mdc +11 -0
  73. package/exports/cursor/pm-engineering/incident-postmortem/incident-postmortem.mdc +4 -0
  74. package/exports/cursor/pm-essentials/competitive-analysis/competitive-analysis.mdc +7 -0
  75. package/exports/cursor/pm-essentials/meeting-notes/meeting-notes.mdc +11 -0
  76. package/exports/cursor/pm-essentials/prd-template/prd-template.mdc +12 -0
  77. package/exports/cursor/pm-planning/okr-builder/okr-builder.mdc +7 -0
  78. package/exports/cursor/pm-planning/rice-prioritisation/rice-prioritisation.mdc +7 -0
  79. package/exports/cursor/pm-planning/roadmap-narrative/roadmap-narrative.mdc +7 -0
  80. package/exports/cursor/pm-strategy/executive-update/executive-update.mdc +7 -0
  81. package/exports/gemini/README.md +3 -1
  82. package/exports/gemini/pm-cross/action-runner/GEM_INSTRUCTIONS.md +85 -0
  83. package/exports/gemini/pm-cross/professional-brain/GEM_INSTRUCTIONS.md +166 -0
  84. package/exports/gemini/pm-cs/churn-analysis/GEM_INSTRUCTIONS.md +7 -0
  85. package/exports/gemini/pm-cs/cs-health-scorecard/GEM_INSTRUCTIONS.md +7 -0
  86. package/exports/gemini/pm-delivery/product-launch-checklist/GEM_INSTRUCTIONS.md +4 -0
  87. package/exports/gemini/pm-delivery/sprint-planning/GEM_INSTRUCTIONS.md +11 -0
  88. package/exports/gemini/pm-engineering/incident-postmortem/GEM_INSTRUCTIONS.md +4 -0
  89. package/exports/gemini/pm-essentials/competitive-analysis/GEM_INSTRUCTIONS.md +7 -0
  90. package/exports/gemini/pm-essentials/meeting-notes/GEM_INSTRUCTIONS.md +11 -0
  91. package/exports/gemini/pm-essentials/prd-template/GEM_INSTRUCTIONS.md +12 -0
  92. package/exports/gemini/pm-planning/okr-builder/GEM_INSTRUCTIONS.md +7 -0
  93. package/exports/gemini/pm-planning/rice-prioritisation/GEM_INSTRUCTIONS.md +7 -0
  94. package/exports/gemini/pm-planning/roadmap-narrative/GEM_INSTRUCTIONS.md +7 -0
  95. package/exports/gemini/pm-strategy/executive-update/GEM_INSTRUCTIONS.md +7 -0
  96. package/exports/obsidian/README.md +3 -1
  97. package/exports/obsidian/pm-cross/action-runner/action-runner.md +96 -0
  98. package/exports/obsidian/pm-cross/professional-brain/professional-brain.md +177 -0
  99. package/exports/obsidian/pm-cs/churn-analysis/churn-analysis.md +7 -0
  100. package/exports/obsidian/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  101. package/exports/obsidian/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  102. package/exports/obsidian/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  103. package/exports/obsidian/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  104. package/exports/obsidian/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  105. package/exports/obsidian/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  106. package/exports/obsidian/pm-essentials/prd-template/prd-template.md +12 -0
  107. package/exports/obsidian/pm-planning/okr-builder/okr-builder.md +7 -0
  108. package/exports/obsidian/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  109. package/exports/obsidian/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  110. package/exports/obsidian/pm-strategy/executive-update/executive-update.md +7 -0
  111. package/exports/roo/README.md +3 -1
  112. package/exports/roo/pm-cross/action-runner/action-runner.md +81 -0
  113. package/exports/roo/pm-cross/professional-brain/professional-brain.md +162 -0
  114. package/exports/roo/pm-cs/churn-analysis/churn-analysis.md +7 -0
  115. package/exports/roo/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  116. package/exports/roo/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  117. package/exports/roo/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  118. package/exports/roo/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  119. package/exports/roo/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  120. package/exports/roo/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  121. package/exports/roo/pm-essentials/prd-template/prd-template.md +12 -0
  122. package/exports/roo/pm-planning/okr-builder/okr-builder.md +7 -0
  123. package/exports/roo/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  124. package/exports/roo/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  125. package/exports/roo/pm-strategy/executive-update/executive-update.md +7 -0
  126. package/exports/windsurf/README.md +3 -1
  127. package/exports/windsurf/pm-cross/action-runner/action-runner.md +86 -0
  128. package/exports/windsurf/pm-cross/professional-brain/professional-brain.md +167 -0
  129. package/exports/windsurf/pm-cs/churn-analysis/churn-analysis.md +7 -0
  130. package/exports/windsurf/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  131. package/exports/windsurf/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  132. package/exports/windsurf/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  133. package/exports/windsurf/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  134. package/exports/windsurf/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  135. package/exports/windsurf/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  136. package/exports/windsurf/pm-essentials/prd-template/prd-template.md +12 -0
  137. package/exports/windsurf/pm-planning/okr-builder/okr-builder.md +7 -0
  138. package/exports/windsurf/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  139. package/exports/windsurf/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  140. package/exports/windsurf/pm-strategy/executive-update/executive-update.md +7 -0
  141. package/exports/zed/README.md +3 -1
  142. package/exports/zed/pm-cross/action-runner/action-runner.md +81 -0
  143. package/exports/zed/pm-cross/professional-brain/professional-brain.md +162 -0
  144. package/exports/zed/pm-cs/churn-analysis/churn-analysis.md +7 -0
  145. package/exports/zed/pm-cs/cs-health-scorecard/cs-health-scorecard.md +7 -0
  146. package/exports/zed/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
  147. package/exports/zed/pm-delivery/sprint-planning/sprint-planning.md +11 -0
  148. package/exports/zed/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
  149. package/exports/zed/pm-essentials/competitive-analysis/competitive-analysis.md +7 -0
  150. package/exports/zed/pm-essentials/meeting-notes/meeting-notes.md +11 -0
  151. package/exports/zed/pm-essentials/prd-template/prd-template.md +12 -0
  152. package/exports/zed/pm-planning/okr-builder/okr-builder.md +7 -0
  153. package/exports/zed/pm-planning/rice-prioritisation/rice-prioritisation.md +7 -0
  154. package/exports/zed/pm-planning/roadmap-narrative/roadmap-narrative.md +7 -0
  155. package/exports/zed/pm-strategy/executive-update/executive-update.md +7 -0
  156. package/package.json +2 -2
  157. package/skill-tiers.json +2 -0
  158. package/skills/action-runner/SKILL.md +86 -0
  159. package/skills/action-runner/scripts/action_preview.py +102 -0
  160. package/skills/churn-analysis/SKILL.md +7 -0
  161. package/skills/competitive-analysis/SKILL.md +7 -0
  162. package/skills/cs-health-scorecard/SKILL.md +7 -0
  163. package/skills/executive-update/SKILL.md +7 -0
  164. package/skills/incident-postmortem/SKILL.md +4 -0
  165. package/skills/meeting-notes/SKILL.md +11 -0
  166. package/skills/okr-builder/SKILL.md +7 -0
  167. package/skills/prd-template/SKILL.md +12 -0
  168. package/skills/product-launch-checklist/SKILL.md +4 -0
  169. package/skills/professional-brain/SKILL.md +167 -0
  170. package/skills/professional-brain/scripts/brain_query.py +99 -0
  171. package/skills/professional-brain/scripts/brain_write.py +117 -0
  172. package/skills/rice-prioritisation/SKILL.md +7 -0
  173. package/skills/roadmap-narrative/SKILL.md +7 -0
  174. package/skills/sprint-planning/SKILL.md +11 -0
  175. package/templates/brain/README.md +36 -0
  176. package/templates/brain/context.md +26 -0
  177. package/templates/brain/decisions/0001-prioritise-mobile-over-dashboard.md +20 -0
  178. package/templates/brain/entities/feature-mobile-revamp.md +19 -0
  179. package/templates/brain/hypotheses/mobile-retention.md +19 -0
  180. package/templates/brain/knowledge/strategy.md +10 -0
  181. package/templates/brain/source/README.md +10 -0
  182. 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 — 207 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-207-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=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
- > 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
+ > 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**. **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**. **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 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 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 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 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 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 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 | **205**, across 21 professions | a handful → dozens, usually one domain |
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 205 Skills](#️-all-205-skills)
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 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 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 205
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 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 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 205 skills reach you through every channel — pick whatever fits your stack:
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 205 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
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 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 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 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 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 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 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). **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). **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 205 skills) are in **[CHANGELOG.md](CHANGELOG.md)**.
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 205-skill library doesn't have 205 equally-mature skills, and pretending otherwise
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 205 Skills
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` | 8 | `meeting-notes` · `red-team-review` |
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 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 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.
@@ -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 **207 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
+ 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: