pm-claude-skills 28.2.0 β 28.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -24
- package/exports/README.md +1 -1
- package/exports/aider/README.md +2 -1
- package/exports/aider/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/aider/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/aider/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/aider/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/aider/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/chatgpt/README.md +2 -1
- package/exports/chatgpt/pm-cross/action-runner/SYSTEM_PROMPT.md +81 -0
- package/exports/chatgpt/pm-cross/professional-brain/SYSTEM_PROMPT.md +2 -0
- package/exports/chatgpt/pm-delivery/product-launch-checklist/SYSTEM_PROMPT.md +4 -0
- package/exports/chatgpt/pm-delivery/sprint-planning/SYSTEM_PROMPT.md +4 -0
- package/exports/chatgpt/pm-engineering/incident-postmortem/SYSTEM_PROMPT.md +4 -0
- package/exports/cline/README.md +2 -1
- package/exports/cline/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/cline/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/cline/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/cline/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/cline/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/continue/README.md +2 -1
- package/exports/continue/pm-cross/action-runner/action-runner.md +86 -0
- package/exports/continue/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/continue/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/continue/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/continue/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/cursor/README.md +2 -1
- package/exports/cursor/pm-cross/action-runner/action-runner.mdc +87 -0
- package/exports/cursor/pm-cross/professional-brain/professional-brain.mdc +2 -0
- package/exports/cursor/pm-delivery/product-launch-checklist/product-launch-checklist.mdc +4 -0
- package/exports/cursor/pm-delivery/sprint-planning/sprint-planning.mdc +4 -0
- package/exports/cursor/pm-engineering/incident-postmortem/incident-postmortem.mdc +4 -0
- package/exports/gemini/README.md +2 -1
- package/exports/gemini/pm-cross/action-runner/GEM_INSTRUCTIONS.md +85 -0
- package/exports/gemini/pm-cross/professional-brain/GEM_INSTRUCTIONS.md +2 -0
- package/exports/gemini/pm-delivery/product-launch-checklist/GEM_INSTRUCTIONS.md +4 -0
- package/exports/gemini/pm-delivery/sprint-planning/GEM_INSTRUCTIONS.md +4 -0
- package/exports/gemini/pm-engineering/incident-postmortem/GEM_INSTRUCTIONS.md +4 -0
- package/exports/obsidian/README.md +2 -1
- package/exports/obsidian/pm-cross/action-runner/action-runner.md +96 -0
- package/exports/obsidian/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/obsidian/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/obsidian/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/obsidian/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/roo/README.md +2 -1
- package/exports/roo/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/roo/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/roo/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/roo/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/roo/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/windsurf/README.md +2 -1
- package/exports/windsurf/pm-cross/action-runner/action-runner.md +86 -0
- package/exports/windsurf/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/windsurf/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/windsurf/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/windsurf/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/exports/zed/README.md +2 -1
- package/exports/zed/pm-cross/action-runner/action-runner.md +81 -0
- package/exports/zed/pm-cross/professional-brain/professional-brain.md +2 -0
- package/exports/zed/pm-delivery/product-launch-checklist/product-launch-checklist.md +4 -0
- package/exports/zed/pm-delivery/sprint-planning/sprint-planning.md +4 -0
- package/exports/zed/pm-engineering/incident-postmortem/incident-postmortem.md +4 -0
- package/package.json +1 -1
- package/skill-tiers.json +1 -0
- package/skills/action-runner/SKILL.md +86 -0
- package/skills/action-runner/scripts/action_preview.py +102 -0
- package/skills/incident-postmortem/SKILL.md +4 -0
- package/skills/product-launch-checklist/SKILL.md +4 -0
- package/skills/professional-brain/SKILL.md +2 -0
- package/skills/sprint-planning/SKILL.md +4 -0
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
</a>
|
|
5
5
|
</p>
|
|
6
6
|
|
|
7
|
-
# π§ PM Skills β
|
|
7
|
+
# π§ PM Skills β 207 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
|
|
8
8
|
|
|
9
9
|
[](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
|
|
10
10
|
[](https://www.npmjs.com/package/pm-claude-skills)
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
[](https://github.com/mohitagw15856/pm-claude-skills#-use-it-anywhere--the-ai-ecosystem)
|
|
15
15
|
[](mcp-remote/)
|
|
16
16
|
[](https://smithery.ai/servers/mohit15856/pm-skills)
|
|
17
|
-
[](https://github.com/mohitagw15856/pm-claude-skills)
|
|
18
18
|
[](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
|
|
19
19
|
[](agents/)
|
|
20
20
|
[](commands/)
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
|
|
31
31
|
<p align="center">
|
|
32
32
|
<a href="https://mohitagw15856.github.io/pm-claude-skills/">
|
|
33
|
-
<img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757¢er=true&vCenter=true&width=720&lines=
|
|
33
|
+
<img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757¢er=true&vCenter=true&width=720&lines=207+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
|
|
34
34
|
</a>
|
|
35
35
|
</p>
|
|
36
36
|
|
|
@@ -41,11 +41,11 @@
|
|
|
41
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.
|
|
42
42
|
|
|
43
43
|
> **PM stands for Professional, not just Product Management.**
|
|
44
|
-
>
|
|
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.
|
|
45
45
|
|
|
46
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).
|
|
47
47
|
|
|
48
|
-
**π Latest release (v28.
|
|
48
|
+
**π Latest release (v28.4.0 β run it free, no credit card):** the playground no longer needs a paid key to start. Use a **free Google AI Studio key** (no card, ~30 seconds) or pick **In-browser** to run a model with **no key at all** (WebLLM on WebGPU β fully private, nothing leaves your device), and every skill now shows a **pre-generated sample output** so you can see the value with zero setup. Plus the **[Professional Brain is now in the browser](https://mohitagw15856.github.io/pm-claude-skills/brain.html)** β a π§ Brain page that feeds your durable memory into every run and saves outcomes back. *Earlier (v28.3 β the Professional Brain):* skills gained a durable, local markdown **memory** they read before answering, **write back** to (provenance-tagged, approval-gated), and even **act on** (open tickets/post updates via `action-runner`, dry-run + approval). Set it up in 5 minutes β **[Quickstart](BRAIN_QUICKSTART.md)** Β· [architecture](BRAIN.md). *Recent integrations:* **[n8n](connectors/n8n.md)**, **[Lovable](connectors/lovable.md)**, **[Obsidian](connectors/obsidian.md)** + a read-only **REST API** (`/v1`) on the hosted Worker. *Earlier (v28.0):* 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).
|
|
49
49
|
|
|
50
50
|
### βΆ See it in action β [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
|
|
51
51
|
|
|
@@ -74,13 +74,13 @@ A community-built library of professional skills for every field β product man
|
|
|
74
74
|
| π [Competitor Teardown](skills/competitor-teardown) | "what are rivals up to?" | a positioning map, feature gaps & strategy |
|
|
75
75
|
| π [Meeting Notes](skills/meeting-notes) | a raw transcript | decisions, owners & next steps |
|
|
76
76
|
|
|
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
|
|
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.
|
|
78
78
|
|
|
79
79
|
---
|
|
80
80
|
|
|
81
81
|
## π One library, the whole professional workflow
|
|
82
82
|
|
|
83
|
-
These
|
|
83
|
+
These 207 skills aren't a random catalog β they cover the **full arc of professional work**, end to end. Wherever you are in the loop, there's a skill for it:
|
|
84
84
|
|
|
85
85
|
```mermaid
|
|
86
86
|
flowchart LR
|
|
@@ -99,7 +99,7 @@ flowchart LR
|
|
|
99
99
|
| **π Measure** | Track outcomes & analyse | `metrics-framework` Β· `cohort-analysis` Β· `ab-test-planner` Β· `churn-analysis` |
|
|
100
100
|
| **π£ Communicate** | Report up and out | `executive-update` Β· `board-deck-narrative` Β· `stakeholder-update` Β· `qbr-deck` |
|
|
101
101
|
|
|
102
|
-
> New here? Start with the [**top-tier skills**](#οΈ-skill-tiers--start-with-the-strongest), or jump straight to [**all
|
|
102
|
+
> New here? Start with the [**top-tier skills**](#οΈ-skill-tiers--start-with-the-strongest), or jump straight to [**all 207 skills**](#οΈ-all-207-skills) grouped by profession.
|
|
103
103
|
|
|
104
104
|
---
|
|
105
105
|
|
|
@@ -195,7 +195,7 @@ Most skill repos are a folder of prompts. This one is a **system** β measured,
|
|
|
195
195
|
|
|
196
196
|
| | **PM Skills** | Typical skill repo |
|
|
197
197
|
|---|:---:|:---:|
|
|
198
|
-
| Skills | **
|
|
198
|
+
| Skills | **207**, across 21 professions | a handful β dozens, usually one domain |
|
|
199
199
|
| Quality | **eval-scored** on a rubric + a public [benchmark](https://mohitagw15856.github.io/pm-claude-skills/benchmark.html) | trust the README |
|
|
200
200
|
| Improves itself | β
eval β critique β rewrite (kept only if it scores higher) | β |
|
|
201
201
|
| Grounded in frameworks | β
each cites its source (RICE, JTBD, Pyramid Principleβ¦) | rarely |
|
|
@@ -220,7 +220,7 @@ Most skill repos are a folder of prompts. This one is a **system** β measured,
|
|
|
220
220
|
- [π¦ Plugin Directory](#-plugin-directory)
|
|
221
221
|
- [π€ Building Blocks for Agent Templates](#-building-blocks-for-agent-templates)
|
|
222
222
|
- [π·οΈ Skill Tiers β start with the strongest](#οΈ-skill-tiers--start-with-the-strongest)
|
|
223
|
-
- [ποΈ All
|
|
223
|
+
- [ποΈ All 207 Skills](#οΈ-all-207-skills)
|
|
224
224
|
- [π Changelog](#-changelog)
|
|
225
225
|
- [π€ Contributing](#-contributing--add-your-skill)
|
|
226
226
|
- [π Related Projects](#-related-projects)
|
|
@@ -229,13 +229,13 @@ Most skill repos are a folder of prompts. This one is a **system** β measured,
|
|
|
229
229
|
|
|
230
230
|
## π Quick Install (2 minutes)
|
|
231
231
|
|
|
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
|
|
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:
|
|
233
233
|
|
|
234
234
|
```bash
|
|
235
235
|
npx skills add mohitagw15856/pm-claude-skills # browse & pick (auto-detects your agent)
|
|
236
236
|
npx skills add mohitagw15856/pm-claude-skills --list # just preview the catalog
|
|
237
237
|
npx skills add mohitagw15856/pm-claude-skills --skill prd-template # grab one
|
|
238
|
-
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all
|
|
238
|
+
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all 207
|
|
239
239
|
```
|
|
240
240
|
|
|
241
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:
|
|
@@ -244,7 +244,7 @@ npx skills add mohitagw15856/pm-claude-skills --skill '*' # install a
|
|
|
244
244
|
npx pm-claude-skills add --agent claude # or: codex Β· cursor Β· hermes Β· openclaw
|
|
245
245
|
```
|
|
246
246
|
|
|
247
|
-
**Or one-line MCP** β make all
|
|
247
|
+
**Or one-line MCP** β make all 207 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
|
|
248
248
|
|
|
249
249
|
```bash
|
|
250
250
|
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
|
|
@@ -301,7 +301,7 @@ ln -s ~/pm-claude-skills/skills/* ~/.claude/skills/
|
|
|
301
301
|
|
|
302
302
|
## π Use It Anywhere β the AI Ecosystem
|
|
303
303
|
|
|
304
|
-
The same
|
|
304
|
+
The same 207 skills reach you through every channel β pick whatever fits your stack:
|
|
305
305
|
|
|
306
306
|
| Channel | Get it |
|
|
307
307
|
|---|---|
|
|
@@ -315,7 +315,9 @@ The same 206 skills reach you through every channel β pick whatever fits your
|
|
|
315
315
|
| π₯οΈ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo** β [`exports/`](exports/) |
|
|
316
316
|
| π€ **Agents & answer engines** | [`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt) makes the whole library discoverable & citable |
|
|
317
317
|
|
|
318
|
-
> **196 of
|
|
318
|
+
> **196 of 207 skills are eval-scored, averaging 4.8/5** β see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
|
|
319
|
+
|
|
320
|
+
> π§ **Give your skills memory:** the [Professional Brain](BRAIN.md) is a local markdown folder skills read, write back to, and act on. It's a folder + one file to start β **[5-minute Quickstart](BRAIN_QUICKSTART.md)**.
|
|
319
321
|
|
|
320
322
|
---
|
|
321
323
|
|
|
@@ -330,7 +332,7 @@ There are two kinds of support. **Native `SKILL.md` agents** read the file as-is
|
|
|
330
332
|
auto-discover skills from the `description` frontmatter. **Other tools** take the markdown
|
|
331
333
|
body as a system prompt β for those we ship ready-made [exports](#ready-to-use-exports).
|
|
332
334
|
|
|
333
|
-
**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all
|
|
335
|
+
**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.
|
|
334
336
|
|
|
335
337
|
| Platform | How it works | Auto-trigger? |
|
|
336
338
|
|---|---|---|
|
|
@@ -475,7 +477,7 @@ ANTHROPIC_API_KEY=sk-ant-β¦ npx pm-claude-skills generate --from ./team-process
|
|
|
475
477
|
|
|
476
478
|
**π 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)**
|
|
477
479
|
|
|
478
|
-
> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all
|
|
480
|
+
> **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.
|
|
479
481
|
|
|
480
482
|
---
|
|
481
483
|
|
|
@@ -551,7 +553,7 @@ Not sure which plugin to install? Here's what each one covers:
|
|
|
551
553
|
|
|
552
554
|
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.
|
|
553
555
|
|
|
554
|
-
This library is the largest open-source collection of professional skills available β covering 20 professions beyond financial services. **The
|
|
556
|
+
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.**
|
|
555
557
|
|
|
556
558
|
### What is an agent template?
|
|
557
559
|
|
|
@@ -630,11 +632,11 @@ More templates will follow. If you want to contribute one, see the [template con
|
|
|
630
632
|
|
|
631
633
|
## π Changelog
|
|
632
634
|
|
|
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). **
|
|
635
|
+
**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**.
|
|
634
636
|
|
|
635
637
|
Full [Keep a Changelog](https://keepachangelog.com/)-format history β every release back to the start β is in **[CHANGELOG.md](CHANGELOG.md)**.
|
|
636
638
|
|
|
637
|
-
β Earlier releases (v20 and before β the road from 6 to
|
|
639
|
+
β Earlier releases (v20 and before β the road from 6 to 207 skills) are in **[CHANGELOG.md](CHANGELOG.md)**.
|
|
638
640
|
|
|
639
641
|
---
|
|
640
642
|
|
|
@@ -670,7 +672,7 @@ This repo was built alongside a published 16-part article series on Medium.
|
|
|
670
672
|
|
|
671
673
|
## π·οΈ Skill Tiers β Start With the Strongest
|
|
672
674
|
|
|
673
|
-
A
|
|
675
|
+
A 207-skill library doesn't have 207 equally-mature skills, and pretending otherwise
|
|
674
676
|
wastes your time. Skills are tiered honestly so you can start with the best work:
|
|
675
677
|
|
|
676
678
|
- π’ **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.**
|
|
@@ -683,7 +685,7 @@ If you're new, install `pm-essentials` and try a couple of Production-Ready skil
|
|
|
683
685
|
|
|
684
686
|
---
|
|
685
687
|
|
|
686
|
-
## ποΈ All
|
|
688
|
+
## ποΈ All 207 Skills
|
|
687
689
|
|
|
688
690
|
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/)**
|
|
689
691
|
|
|
@@ -706,7 +708,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog β SKI
|
|
|
706
708
|
| π€ Sales | `pm-sales` | 6 | `sales-battlecard` |
|
|
707
709
|
| βοΈ Operations | `pm-operations` | 10 | `sop-writer` |
|
|
708
710
|
| π₯ Research & Healthcare | `pm-research` | 4 | `literature-review` |
|
|
709
|
-
| π Cross-Profession | `pm-cross` |
|
|
711
|
+
| π Cross-Profession | `pm-cross` | 10 | `meeting-notes` Β· `professional-brain` Β· `action-runner` |
|
|
710
712
|
| πΌοΈ Figma | `pm-figma` | 10 | `figma-design-review` |
|
|
711
713
|
| π± Social Media | `pm-social` | 5 | `social-media-strategy` |
|
|
712
714
|
| βοΈ Writers & Content | `pm-writers` | 6 | `aeo-optimizer` |
|
|
@@ -717,7 +719,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog β SKI
|
|
|
717
719
|
|
|
718
720
|
## β€οΈ Sponsor This Work
|
|
719
721
|
|
|
720
|
-
Building and maintaining
|
|
722
|
+
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.
|
|
721
723
|
|
|
722
724
|
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)).
|
|
723
725
|
|
package/exports/README.md
CHANGED
|
@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
|
|
|
8
8
|
node scripts/build-exports.mjs
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
Currently exporting **
|
|
11
|
+
Currently exporting **207 skills** to:
|
|
12
12
|
|
|
13
13
|
- **ChatGPT β Custom GPT instructions** β `exports/chatgpt/`
|
|
14
14
|
- **Google Gemini β Gem instructions** β `exports/gemini/`
|
package/exports/aider/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** β edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
207 skills exported. Copy a `.mdc rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
| A/B Test Readout | `pm-data` | `pm-data/ab-test-readout/ab-test-readout.md` |
|
|
13
13
|
| Accessibility Audit | `pm-design` | `pm-design/accessibility-audit/accessibility-audit.md` |
|
|
14
14
|
| Account Plan | `pm-sales` | `pm-sales/account-plan/account-plan.md` |
|
|
15
|
+
| Action Runner | `pm-cross` | `pm-cross/action-runner/action-runner.md` |
|
|
15
16
|
| AEO Optimizer | `pm-writers` | `pm-writers/aeo-optimizer/aeo-optimizer.md` |
|
|
16
17
|
| AI Ethics Review | `pm-advanced` | `pm-advanced/ai-ethics-review/ai-ethics-review.md` |
|
|
17
18
|
| AI Product Canvas | `pm-advanced` | `pm-advanced/ai-product-canvas/ai-product-canvas.md` |
|
|
@@ -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
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Professional Brain Skill
|
|
2
2
|
|
|
3
|
+
> π **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** β a folder + one file, with a worked example. This file is the full reference.
|
|
4
|
+
|
|
3
5
|
Most skills start cold β you paste the same context every time, and decisions made six weeks
|
|
4
6
|
ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
|
|
5
7
|
on disk that skills read before they answer and write to after. No vector DB, no cloud β just
|
|
@@ -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:
|
|
@@ -9,6 +9,10 @@ If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, g
|
|
|
9
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
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
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
|
+
|
|
12
16
|
## What This Skill Produces
|
|
13
17
|
|
|
14
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:
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** β edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
207 skills exported. Copy a `SYSTEM_PROMPT.md` 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/SYSTEM_PROMPT.md` |
|
|
13
13
|
| Accessibility Audit | `pm-design` | `pm-design/accessibility-audit/SYSTEM_PROMPT.md` |
|
|
14
14
|
| Account Plan | `pm-sales` | `pm-sales/account-plan/SYSTEM_PROMPT.md` |
|
|
15
|
+
| Action Runner | `pm-cross` | `pm-cross/action-runner/SYSTEM_PROMPT.md` |
|
|
15
16
|
| AEO Optimizer | `pm-writers` | `pm-writers/aeo-optimizer/SYSTEM_PROMPT.md` |
|
|
16
17
|
| AI Ethics Review | `pm-advanced` | `pm-advanced/ai-ethics-review/SYSTEM_PROMPT.md` |
|
|
17
18
|
| AI Product Canvas | `pm-advanced` | `pm-advanced/ai-product-canvas/SYSTEM_PROMPT.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
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Professional Brain Skill
|
|
2
2
|
|
|
3
|
+
> π **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** β a folder + one file, with a worked example. This file is the full reference.
|
|
4
|
+
|
|
3
5
|
Most skills start cold β you paste the same context every time, and decisions made six weeks
|
|
4
6
|
ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
|
|
5
7
|
on disk that skills read before they answer and write to after. No vector DB, no cloud β just
|
|
@@ -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:
|
|
@@ -9,6 +9,10 @@ If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, g
|
|
|
9
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
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
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
|
+
|
|
12
16
|
## What This Skill Produces
|
|
13
17
|
|
|
14
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:
|
package/exports/cline/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
|
|
4
4
|
> **Do not edit these files by hand** β edit the source skill and regenerate.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
207 skills exported. Copy a `.mdc rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
| A/B Test Readout | `pm-data` | `pm-data/ab-test-readout/ab-test-readout.md` |
|
|
13
13
|
| Accessibility Audit | `pm-design` | `pm-design/accessibility-audit/accessibility-audit.md` |
|
|
14
14
|
| Account Plan | `pm-sales` | `pm-sales/account-plan/account-plan.md` |
|
|
15
|
+
| Action Runner | `pm-cross` | `pm-cross/action-runner/action-runner.md` |
|
|
15
16
|
| AEO Optimizer | `pm-writers` | `pm-writers/aeo-optimizer/aeo-optimizer.md` |
|
|
16
17
|
| AI Ethics Review | `pm-advanced` | `pm-advanced/ai-ethics-review/ai-ethics-review.md` |
|
|
17
18
|
| AI Product Canvas | `pm-advanced` | `pm-advanced/ai-product-canvas/ai-product-canvas.md` |
|
|
@@ -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
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Professional Brain Skill
|
|
2
2
|
|
|
3
|
+
> π **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** β a folder + one file, with a worked example. This file is the full reference.
|
|
4
|
+
|
|
3
5
|
Most skills start cold β you paste the same context every time, and decisions made six weeks
|
|
4
6
|
ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
|
|
5
7
|
on disk that skills read before they answer and write to after. No vector DB, no cloud β just
|