pm-claude-skills 30.2.0 → 31.0.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 -25
- package/exports/README.md +1 -1
- package/exports/aider/README.md +11 -1
- package/exports/aider/pm-visuals/announcement-card/announcement-card.md +57 -0
- package/exports/aider/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
- package/exports/aider/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
- package/exports/aider/pm-visuals/flowchart/flowchart.md +67 -0
- package/exports/aider/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
- package/exports/aider/pm-visuals/mind-map/mind-map.md +62 -0
- package/exports/aider/pm-visuals/org-chart/org-chart.md +69 -0
- package/exports/aider/pm-visuals/quote-card/quote-card.md +51 -0
- package/exports/aider/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
- package/exports/aider/pm-visuals/user-journey-map/user-journey-map.md +70 -0
- package/exports/chatgpt/README.md +11 -1
- package/exports/chatgpt/pm-visuals/announcement-card/SYSTEM_PROMPT.md +57 -0
- package/exports/chatgpt/pm-visuals/architecture-diagram/SYSTEM_PROMPT.md +74 -0
- package/exports/chatgpt/pm-visuals/entity-relationship-diagram/SYSTEM_PROMPT.md +80 -0
- package/exports/chatgpt/pm-visuals/flowchart/SYSTEM_PROMPT.md +67 -0
- package/exports/chatgpt/pm-visuals/gantt-roadmap/SYSTEM_PROMPT.md +72 -0
- package/exports/chatgpt/pm-visuals/mind-map/SYSTEM_PROMPT.md +62 -0
- package/exports/chatgpt/pm-visuals/org-chart/SYSTEM_PROMPT.md +69 -0
- package/exports/chatgpt/pm-visuals/quote-card/SYSTEM_PROMPT.md +51 -0
- package/exports/chatgpt/pm-visuals/sequence-diagram/SYSTEM_PROMPT.md +65 -0
- package/exports/chatgpt/pm-visuals/user-journey-map/SYSTEM_PROMPT.md +70 -0
- package/exports/cline/README.md +11 -1
- package/exports/cline/pm-visuals/announcement-card/announcement-card.md +57 -0
- package/exports/cline/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
- package/exports/cline/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
- package/exports/cline/pm-visuals/flowchart/flowchart.md +67 -0
- package/exports/cline/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
- package/exports/cline/pm-visuals/mind-map/mind-map.md +62 -0
- package/exports/cline/pm-visuals/org-chart/org-chart.md +69 -0
- package/exports/cline/pm-visuals/quote-card/quote-card.md +51 -0
- package/exports/cline/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
- package/exports/cline/pm-visuals/user-journey-map/user-journey-map.md +70 -0
- package/exports/continue/README.md +11 -1
- package/exports/continue/pm-visuals/announcement-card/announcement-card.md +62 -0
- package/exports/continue/pm-visuals/architecture-diagram/architecture-diagram.md +79 -0
- package/exports/continue/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +85 -0
- package/exports/continue/pm-visuals/flowchart/flowchart.md +72 -0
- package/exports/continue/pm-visuals/gantt-roadmap/gantt-roadmap.md +77 -0
- package/exports/continue/pm-visuals/mind-map/mind-map.md +67 -0
- package/exports/continue/pm-visuals/org-chart/org-chart.md +74 -0
- package/exports/continue/pm-visuals/quote-card/quote-card.md +56 -0
- package/exports/continue/pm-visuals/sequence-diagram/sequence-diagram.md +70 -0
- package/exports/continue/pm-visuals/user-journey-map/user-journey-map.md +75 -0
- package/exports/cursor/README.md +11 -1
- package/exports/cursor/pm-visuals/announcement-card/announcement-card.mdc +63 -0
- package/exports/cursor/pm-visuals/architecture-diagram/architecture-diagram.mdc +80 -0
- package/exports/cursor/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.mdc +86 -0
- package/exports/cursor/pm-visuals/flowchart/flowchart.mdc +73 -0
- package/exports/cursor/pm-visuals/gantt-roadmap/gantt-roadmap.mdc +78 -0
- package/exports/cursor/pm-visuals/mind-map/mind-map.mdc +68 -0
- package/exports/cursor/pm-visuals/org-chart/org-chart.mdc +75 -0
- package/exports/cursor/pm-visuals/quote-card/quote-card.mdc +57 -0
- package/exports/cursor/pm-visuals/sequence-diagram/sequence-diagram.mdc +71 -0
- package/exports/cursor/pm-visuals/user-journey-map/user-journey-map.mdc +76 -0
- package/exports/gemini/README.md +11 -1
- package/exports/gemini/pm-visuals/announcement-card/GEM_INSTRUCTIONS.md +61 -0
- package/exports/gemini/pm-visuals/architecture-diagram/GEM_INSTRUCTIONS.md +78 -0
- package/exports/gemini/pm-visuals/entity-relationship-diagram/GEM_INSTRUCTIONS.md +84 -0
- package/exports/gemini/pm-visuals/flowchart/GEM_INSTRUCTIONS.md +71 -0
- package/exports/gemini/pm-visuals/gantt-roadmap/GEM_INSTRUCTIONS.md +76 -0
- package/exports/gemini/pm-visuals/mind-map/GEM_INSTRUCTIONS.md +66 -0
- package/exports/gemini/pm-visuals/org-chart/GEM_INSTRUCTIONS.md +73 -0
- package/exports/gemini/pm-visuals/quote-card/GEM_INSTRUCTIONS.md +55 -0
- package/exports/gemini/pm-visuals/sequence-diagram/GEM_INSTRUCTIONS.md +69 -0
- package/exports/gemini/pm-visuals/user-journey-map/GEM_INSTRUCTIONS.md +74 -0
- package/exports/kilocode/README.md +11 -1
- package/exports/kilocode/pm-visuals/announcement-card/announcement-card.md +57 -0
- package/exports/kilocode/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
- package/exports/kilocode/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
- package/exports/kilocode/pm-visuals/flowchart/flowchart.md +67 -0
- package/exports/kilocode/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
- package/exports/kilocode/pm-visuals/mind-map/mind-map.md +62 -0
- package/exports/kilocode/pm-visuals/org-chart/org-chart.md +69 -0
- package/exports/kilocode/pm-visuals/quote-card/quote-card.md +51 -0
- package/exports/kilocode/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
- package/exports/kilocode/pm-visuals/user-journey-map/user-journey-map.md +70 -0
- package/exports/obsidian/README.md +11 -1
- package/exports/obsidian/pm-visuals/announcement-card/announcement-card.md +72 -0
- package/exports/obsidian/pm-visuals/architecture-diagram/architecture-diagram.md +89 -0
- package/exports/obsidian/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +95 -0
- package/exports/obsidian/pm-visuals/flowchart/flowchart.md +82 -0
- package/exports/obsidian/pm-visuals/gantt-roadmap/gantt-roadmap.md +87 -0
- package/exports/obsidian/pm-visuals/mind-map/mind-map.md +77 -0
- package/exports/obsidian/pm-visuals/org-chart/org-chart.md +84 -0
- package/exports/obsidian/pm-visuals/quote-card/quote-card.md +66 -0
- package/exports/obsidian/pm-visuals/sequence-diagram/sequence-diagram.md +80 -0
- package/exports/obsidian/pm-visuals/user-journey-map/user-journey-map.md +85 -0
- package/exports/roo/README.md +11 -1
- package/exports/roo/pm-visuals/announcement-card/announcement-card.md +57 -0
- package/exports/roo/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
- package/exports/roo/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
- package/exports/roo/pm-visuals/flowchart/flowchart.md +67 -0
- package/exports/roo/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
- package/exports/roo/pm-visuals/mind-map/mind-map.md +62 -0
- package/exports/roo/pm-visuals/org-chart/org-chart.md +69 -0
- package/exports/roo/pm-visuals/quote-card/quote-card.md +51 -0
- package/exports/roo/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
- package/exports/roo/pm-visuals/user-journey-map/user-journey-map.md +70 -0
- package/exports/windsurf/README.md +11 -1
- package/exports/windsurf/pm-visuals/announcement-card/announcement-card.md +62 -0
- package/exports/windsurf/pm-visuals/architecture-diagram/architecture-diagram.md +79 -0
- package/exports/windsurf/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +85 -0
- package/exports/windsurf/pm-visuals/flowchart/flowchart.md +72 -0
- package/exports/windsurf/pm-visuals/gantt-roadmap/gantt-roadmap.md +77 -0
- package/exports/windsurf/pm-visuals/mind-map/mind-map.md +67 -0
- package/exports/windsurf/pm-visuals/org-chart/org-chart.md +74 -0
- package/exports/windsurf/pm-visuals/quote-card/quote-card.md +56 -0
- package/exports/windsurf/pm-visuals/sequence-diagram/sequence-diagram.md +70 -0
- package/exports/windsurf/pm-visuals/user-journey-map/user-journey-map.md +75 -0
- package/exports/zed/README.md +11 -1
- package/exports/zed/pm-visuals/announcement-card/announcement-card.md +57 -0
- package/exports/zed/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
- package/exports/zed/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
- package/exports/zed/pm-visuals/flowchart/flowchart.md +67 -0
- package/exports/zed/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
- package/exports/zed/pm-visuals/mind-map/mind-map.md +62 -0
- package/exports/zed/pm-visuals/org-chart/org-chart.md +69 -0
- package/exports/zed/pm-visuals/quote-card/quote-card.md +51 -0
- package/exports/zed/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
- package/exports/zed/pm-visuals/user-journey-map/user-journey-map.md +70 -0
- package/package.json +2 -2
- package/skills/announcement-card/SKILL.md +62 -0
- package/skills/architecture-diagram/SKILL.md +79 -0
- package/skills/entity-relationship-diagram/SKILL.md +85 -0
- package/skills/flowchart/SKILL.md +72 -0
- package/skills/gantt-roadmap/SKILL.md +77 -0
- package/skills/mind-map/SKILL.md +67 -0
- package/skills/org-chart/SKILL.md +74 -0
- package/skills/quote-card/SKILL.md +56 -0
- package/skills/sequence-diagram/SKILL.md +70 -0
- package/skills/user-journey-map/SKILL.md +75 -0
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🧠 PM Skills —
|
|
1
|
+
# 🧠 PM Skills — 329 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
|
|
2
2
|
|
|
3
3
|
[](#-quick-install-2-minutes)
|
|
4
4
|
[](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
[](https://github.com/mohitagw15856/pm-claude-skills#-use-it-anywhere--the-ai-ecosystem)
|
|
10
10
|
[](mcp-remote/)
|
|
11
11
|
[](https://smithery.ai/servers/mohit15856/pm-skills)
|
|
12
|
-
[](https://github.com/mohitagw15856/pm-claude-skills)
|
|
13
13
|
[](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
|
|
14
14
|
[](agents/)
|
|
15
15
|
[](commands/)
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
|
|
26
26
|
<p align="center">
|
|
27
27
|
<a href="https://mohitagw15856.github.io/pm-claude-skills/">
|
|
28
|
-
<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=
|
|
28
|
+
<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=329+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
|
|
29
29
|
</a>
|
|
30
30
|
</p>
|
|
31
31
|
|
|
@@ -56,11 +56,11 @@
|
|
|
56
56
|
*Not sure? Start with the Playground.* This is a **CLI, not a library** — you don't need `npm install`; `npx pm-claude-skills …` always runs the latest. Browse everything first with `npx pm-claude-skills list`.
|
|
57
57
|
|
|
58
58
|
> **PM stands for Professional, not just Product Management.**
|
|
59
|
-
>
|
|
59
|
+
> 329 professional skills + 4 agent templates across 47 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
|
|
60
60
|
|
|
61
61
|
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).
|
|
62
62
|
|
|
63
|
-
**🆕 Latest —
|
|
63
|
+
**🆕 Latest — v31.0.0 (Artifacts & Visuals — your output isn't just text):** a new **🎨 `pm-visuals` bundle** whose diagram skills emit **Mermaid that renders live in the playground** and exports to **PNG/SVG** — `flowchart`, `architecture-diagram`, `user-journey-map`, `org-chart`, `sequence-diagram`, `mind-map`, `gantt-roadmap`, `entity-relationship-diagram` — plus `announcement-card` & `quote-card` built to export as shareable images. Diagrams render in **any** skill's output now, not just these. Also new: **📅 Calendar (.ics) export** — a roadmap or launch plan with dates drops straight into Google/Apple/Outlook calendar. This joins the existing PDF / Word / PowerPoint / Excel / image exports. *Earlier (v30.2):* a bilingual **English / 中文** playground UI. **329 skills across 47 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
|
|
64
64
|
|
|
65
65
|
### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
|
|
66
66
|
|
|
@@ -89,7 +89,7 @@ A community-built library of professional skills for every field — product man
|
|
|
89
89
|
| 🔭 [Competitor Teardown](skills/competitor-teardown) | "what are rivals up to?" | a positioning map, feature gaps & strategy |
|
|
90
90
|
| 📝 [Meeting Notes](skills/meeting-notes) | a raw transcript | decisions, owners & next steps |
|
|
91
91
|
|
|
92
|
-
→ 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
|
|
92
|
+
→ 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 329 skills](#️-all-329-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
|
|
93
93
|
|
|
94
94
|
---
|
|
95
95
|
|
|
@@ -112,7 +112,7 @@ It's not just text — the playground exports every result as a **professionally
|
|
|
112
112
|
</tr>
|
|
113
113
|
</table>
|
|
114
114
|
|
|
115
|
-
> Generate yours: run a skill in the [Playground](https://mohitagw15856.github.io/pm-claude-skills/), then **Download → PDF · Paper / Modern / Technical**. Add a `Brand color: #hex` line to your context and it tints to match (last tile). Personal documents live in the [`pm-personal`](#️-all-
|
|
115
|
+
> Generate yours: run a skill in the [Playground](https://mohitagw15856.github.io/pm-claude-skills/), then **Download → PDF · Paper / Modern / Technical**. Add a `Brand color: #hex` line to your context and it tints to match (last tile). Personal documents live in the [`pm-personal`](#️-all-329-skills) bundle (résumé, cover letter, bio, LinkedIn, portfolio, one-pager).
|
|
116
116
|
|
|
117
117
|
---
|
|
118
118
|
|
|
@@ -121,11 +121,11 @@ It's not just text — the playground exports every result as a **professionally
|
|
|
121
121
|
<details>
|
|
122
122
|
<summary>Read more ↓</summary>
|
|
123
123
|
|
|
124
|
-
The whole library on one page — install, all
|
|
124
|
+
The whole library on one page — install, all 329 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
|
|
125
125
|
|
|
126
126
|
<p align="center">
|
|
127
127
|
<a href="CHEATSHEET.md">
|
|
128
|
-
<img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills one-page cheatsheet —
|
|
128
|
+
<img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills one-page cheatsheet — 329 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
|
|
129
129
|
</a>
|
|
130
130
|
</p>
|
|
131
131
|
|
|
@@ -156,7 +156,7 @@ Generic AI forgets everything between sessions, so you re-paste context forever
|
|
|
156
156
|
<details>
|
|
157
157
|
<summary>Read more ↓</summary>
|
|
158
158
|
|
|
159
|
-
These
|
|
159
|
+
These 329 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:
|
|
160
160
|
|
|
161
161
|
```mermaid
|
|
162
162
|
flowchart LR
|
|
@@ -175,7 +175,7 @@ flowchart LR
|
|
|
175
175
|
| **📊 Measure** | Track outcomes & analyse | `metrics-framework` · `cohort-analysis` · `ab-test-planner` · `churn-analysis` |
|
|
176
176
|
| **📣 Communicate** | Report up and out | `executive-update` · `board-deck-narrative` · `stakeholder-update` · `qbr-deck` |
|
|
177
177
|
|
|
178
|
-
> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all
|
|
178
|
+
> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 329 skills**](#️-all-329-skills) grouped by profession.
|
|
179
179
|
|
|
180
180
|
</details>
|
|
181
181
|
|
|
@@ -298,7 +298,7 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
|
|
|
298
298
|
|
|
299
299
|
| | **PM Skills** | Typical skill repo |
|
|
300
300
|
|---|:---:|:---:|
|
|
301
|
-
| Skills | **
|
|
301
|
+
| Skills | **329**, across 23 professions | a handful → dozens, usually one domain |
|
|
302
302
|
| Quality | **eval-scored** on a rubric + a public [benchmark](https://mohitagw15856.github.io/pm-claude-skills/benchmark.html) | trust the README |
|
|
303
303
|
| Improves itself | ✅ eval → critique → rewrite (kept only if it scores higher) | ✗ |
|
|
304
304
|
| Grounded in frameworks | ✅ each cites its source (RICE, JTBD, Pyramid Principle…) | rarely |
|
|
@@ -323,13 +323,13 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
|
|
|
323
323
|
>
|
|
324
324
|
> ⚠️ **You don't need `npm install pm-claude-skills`** — it's a CLI, not a library, so there's nothing to import. Use `npx pm-claude-skills …` (it always runs the latest). `npm install` just downloads it and does nothing on its own.
|
|
325
325
|
|
|
326
|
-
**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
|
|
326
|
+
**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 329 interactively:
|
|
327
327
|
|
|
328
328
|
```bash
|
|
329
329
|
npx skills add mohitagw15856/pm-claude-skills # browse & pick (auto-detects your agent)
|
|
330
330
|
npx skills add mohitagw15856/pm-claude-skills --list # just preview the catalog
|
|
331
331
|
npx skills add mohitagw15856/pm-claude-skills --skill prd-template # grab one
|
|
332
|
-
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all
|
|
332
|
+
npx skills add mohitagw15856/pm-claude-skills --skill '*' # install all 329
|
|
333
333
|
```
|
|
334
334
|
|
|
335
335
|
**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:
|
|
@@ -338,7 +338,7 @@ npx skills add mohitagw15856/pm-claude-skills --skill '*' # install a
|
|
|
338
338
|
npx pm-claude-skills add --agent claude # or: codex · cursor · hermes · openclaw
|
|
339
339
|
```
|
|
340
340
|
|
|
341
|
-
**Or one-line MCP** — make all
|
|
341
|
+
**Or one-line MCP** — make all 329 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
|
|
342
342
|
|
|
343
343
|
```bash
|
|
344
344
|
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
|
|
@@ -399,7 +399,7 @@ ln -s ~/pm-claude-skills/skills/* ~/.claude/skills/
|
|
|
399
399
|
<details>
|
|
400
400
|
<summary>Read more ↓</summary>
|
|
401
401
|
|
|
402
|
-
The same
|
|
402
|
+
The same 329 skills reach you through every channel — pick whatever fits your stack:
|
|
403
403
|
|
|
404
404
|
| Channel | Get it |
|
|
405
405
|
|---|---|
|
|
@@ -413,7 +413,7 @@ The same 319 skills reach you through every channel — pick whatever fits your
|
|
|
413
413
|
| 🖥️ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo, Kilo Code** — [`exports/`](exports/) |
|
|
414
414
|
| 🤖 **Agents & answer engines** | [`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt) makes the whole library discoverable & citable |
|
|
415
415
|
|
|
416
|
-
> **208 of
|
|
416
|
+
> **208 of 329 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
|
|
417
417
|
|
|
418
418
|
> 🧠 **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)**.
|
|
419
419
|
|
|
@@ -435,7 +435,7 @@ There are two kinds of support. **Native `SKILL.md` agents** read the file as-is
|
|
|
435
435
|
auto-discover skills from the `description` frontmatter. **Other tools** take the markdown
|
|
436
436
|
body as a system prompt — for those we ship ready-made [exports](#ready-to-use-exports).
|
|
437
437
|
|
|
438
|
-
**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all
|
|
438
|
+
**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all 329 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
|
|
439
439
|
|
|
440
440
|
| Platform | How it works | Auto-trigger? |
|
|
441
441
|
|---|---|---|
|
|
@@ -595,7 +595,7 @@ ANTHROPIC_API_KEY=sk-ant-… npx pm-claude-skills generate --from ./team-process
|
|
|
595
595
|
|
|
596
596
|
**🏆 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)**
|
|
597
597
|
|
|
598
|
-
> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all
|
|
598
|
+
> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all 329 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.
|
|
599
599
|
|
|
600
600
|
</details>
|
|
601
601
|
|
|
@@ -691,7 +691,7 @@ Not sure which plugin to install? Here's what each one covers:
|
|
|
691
691
|
|
|
692
692
|
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.
|
|
693
693
|
|
|
694
|
-
This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The
|
|
694
|
+
This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The 329 skills here are the building blocks for agent templates outside of finance.**
|
|
695
695
|
|
|
696
696
|
### What is an agent template?
|
|
697
697
|
|
|
@@ -771,7 +771,7 @@ More templates will follow. If you want to contribute one, see the [template con
|
|
|
771
771
|
<details>
|
|
772
772
|
<summary>Read more ↓</summary>
|
|
773
773
|
|
|
774
|
-
**Latest: v30.0.0 — 25 new skills, 4 new bundles (AI-builder, crisis comms, healthcare, life-admin, nonprofit) & an eval-coverage page.**
|
|
774
|
+
**Latest: v30.0.0 — 25 new skills, 4 new bundles (AI-builder, crisis comms, healthcare, life-admin, nonprofit) & an eval-coverage page.** 329 skills across 47 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
|
|
775
775
|
|
|
776
776
|
Full [Keep a Changelog](https://keepachangelog.com/)-format history — every release back to the start — is in **[CHANGELOG.md](CHANGELOG.md)**.
|
|
777
777
|
|
|
@@ -819,7 +819,7 @@ This repo was built alongside a published 16-part article series on Medium.
|
|
|
819
819
|
<details>
|
|
820
820
|
<summary>Read more ↓</summary>
|
|
821
821
|
|
|
822
|
-
A
|
|
822
|
+
A 329-skill library doesn't have 329 equally-mature skills, and pretending otherwise
|
|
823
823
|
wastes your time. Skills are tiered honestly so you can start with the best work:
|
|
824
824
|
|
|
825
825
|
- 🟢 **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.**
|
|
@@ -834,7 +834,7 @@ If you're new, install `pm-essentials` and try a couple of Production-Ready skil
|
|
|
834
834
|
|
|
835
835
|
---
|
|
836
836
|
|
|
837
|
-
## 🗂️ All
|
|
837
|
+
## 🗂️ All 329 Skills
|
|
838
838
|
|
|
839
839
|
<details>
|
|
840
840
|
<summary>Read more ↓</summary>
|
|
@@ -864,6 +864,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
|
|
|
864
864
|
| 🖼️ Figma | `pm-figma` | 10 | `figma-design-review` |
|
|
865
865
|
| 📱 Social Media | `pm-social` | 5 | `social-media-strategy` |
|
|
866
866
|
| ✍️ Writers & Content | `pm-writers` | 6 | `aeo-optimizer` |
|
|
867
|
+
| 🎨 Visuals & Diagrams | `pm-visuals` 🆕 | 10 | `flowchart` · `architecture-diagram` · `gantt-roadmap` |
|
|
867
868
|
|
|
868
869
|
> Full per-skill detail (folder paths, descriptions, "🆕" markers) lives in **[SKILLS.md](SKILLS.md)**.
|
|
869
870
|
|
|
@@ -876,7 +877,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
|
|
|
876
877
|
<details>
|
|
877
878
|
<summary>Read more ↓</summary>
|
|
878
879
|
|
|
879
|
-
Building and maintaining
|
|
880
|
+
Building and maintaining 329 skills across 47 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
|
|
880
881
|
|
|
881
882
|
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)).
|
|
882
883
|
|
|
@@ -908,7 +909,7 @@ pull request**, and once it's merged you earn a badge to show off in your own re
|
|
|
908
909
|
```
|
|
909
910
|
|
|
910
911
|
Community listings live in their authors' own repos and are **community-maintained — not
|
|
911
|
-
eval-scored or security-audited** (that's the [curated library](#️-all-
|
|
912
|
+
eval-scored or security-audited** (that's the [curated library](#️-all-329-skills) above). Want
|
|
912
913
|
your skill *in* the curated library instead? See **Contributing** below.
|
|
913
914
|
|
|
914
915
|
---
|
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 **329 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
|
+
329 skills exported. Copy a `.mdc rule` into the tool to use it.
|
|
7
7
|
|
|
8
8
|
| Skill | Bundle | Path |
|
|
9
9
|
|---|---|---|
|
|
@@ -22,10 +22,12 @@
|
|
|
22
22
|
| AI Feature PRD | `pm-ai` | `pm-ai/ai-feature-prd/ai-feature-prd.md` |
|
|
23
23
|
| AI Product Canvas | `pm-advanced` | `pm-advanced/ai-product-canvas/ai-product-canvas.md` |
|
|
24
24
|
| Ambiguity Resolver | `pm-strategy` | `pm-strategy/ambiguity-resolver/ambiguity-resolver.md` |
|
|
25
|
+
| Announcement Card | `pm-visuals` | `pm-visuals/announcement-card/announcement-card.md` |
|
|
25
26
|
| API Docs Writer | `pm-engineering` | `pm-engineering/api-docs-writer/api-docs-writer.md` |
|
|
26
27
|
| API Versioning Strategy | `pm-engineering` | `pm-engineering/api-versioning-strategy/api-versioning-strategy.md` |
|
|
27
28
|
| Apology Letter | `pm-crisis` | `pm-crisis/apology-letter/apology-letter.md` |
|
|
28
29
|
| Architecture Decision Record (ADR) | `pm-engineering` | `pm-engineering/architecture-decision-record/architecture-decision-record.md` |
|
|
30
|
+
| Architecture Diagram | `pm-visuals` | `pm-visuals/architecture-diagram/architecture-diagram.md` |
|
|
29
31
|
| Assumption Mapper | `pm-discovery` | `pm-discovery/assumption-mapper/assumption-mapper.md` |
|
|
30
32
|
| Board Deck Narrative | `pm-business` | `pm-business/board-deck-narrative/board-deck-narrative.md` |
|
|
31
33
|
| Board Pre-Read | `pm-business` | `pm-business/board-pre-read/board-pre-read.md` |
|
|
@@ -109,6 +111,7 @@
|
|
|
109
111
|
| Engagement Retro | `pm-consulting` | `pm-consulting/engagement-retro/engagement-retro.md` |
|
|
110
112
|
| Engineering Hiring Rubric | `pm-engineering` | `pm-engineering/engineering-hiring-rubric/engineering-hiring-rubric.md` |
|
|
111
113
|
| Engineering Weekly Report | `pm-engineering` | `pm-engineering/engineering-weekly-report/engineering-weekly-report.md` |
|
|
114
|
+
| Entity-Relationship Diagram | `pm-visuals` | `pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md` |
|
|
112
115
|
| Error Decoder | `pm-engineering` | `pm-engineering/error-decoder/error-decoder.md` |
|
|
113
116
|
| Escalation Tree | `pm-support` | `pm-support/escalation-tree/escalation-tree.md` |
|
|
114
117
|
| Eval Rubric Designer | `pm-ai` | `pm-ai/eval-rubric-designer/eval-rubric-designer.md` |
|
|
@@ -132,9 +135,11 @@
|
|
|
132
135
|
| Figma Variant Matrix | `pm-figma` | `pm-figma/figma-variant-matrix/figma-variant-matrix.md` |
|
|
133
136
|
| Financial Due Diligence | `pm-finance` | `pm-finance/financial-due-diligence/financial-due-diligence.md` |
|
|
134
137
|
| Financial Model Narrative | `pm-finance` | `pm-finance/financial-model-narrative/financial-model-narrative.md` |
|
|
138
|
+
| Flowchart | `pm-visuals` | `pm-visuals/flowchart/flowchart.md` |
|
|
135
139
|
| Follow-Up Sequence | `pm-jobsearch` | `pm-jobsearch/follow-up-sequence/follow-up-sequence.md` |
|
|
136
140
|
| Founder-Market Fit | `pm-founders` | `pm-founders/founder-market-fit/founder-market-fit.md` |
|
|
137
141
|
| Fundraising FAQ | `pm-founders` | `pm-founders/fundraising-faq/fundraising-faq.md` |
|
|
142
|
+
| Gantt / Roadmap | `pm-visuals` | `pm-visuals/gantt-roadmap/gantt-roadmap.md` |
|
|
138
143
|
| GDPR Compliance | `pm-compliance` | `pm-compliance/gdpr-compliance/gdpr-compliance.md` |
|
|
139
144
|
| Git Troubleshooter | `pm-engineering` | `pm-engineering/git-troubleshooter/git-troubleshooter.md` |
|
|
140
145
|
| Giving Feedback | `pm-comms` | `pm-comms/giving-feedback/giving-feedback.md` |
|
|
@@ -190,6 +195,7 @@
|
|
|
190
195
|
| Metric Tree Builder | `pm-data` | `pm-data/metric-tree-builder/metric-tree-builder.md` |
|
|
191
196
|
| Metrics Framework | `pm-data` | `pm-data/metrics-framework/metrics-framework.md` |
|
|
192
197
|
| Microservices Decomposition | `pm-engineering` | `pm-engineering/microservices-decomposition/microservices-decomposition.md` |
|
|
198
|
+
| Mind Map | `pm-visuals` | `pm-visuals/mind-map/mind-map.md` |
|
|
193
199
|
| Model Card | `pm-ai` | `pm-ai/model-card/model-card.md` |
|
|
194
200
|
| Model Selection Advisor | `pm-ai` | `pm-ai/model-selection-advisor/model-selection-advisor.md` |
|
|
195
201
|
| Monitoring Setup Guide | `pm-engineering` | `pm-engineering/monitoring-setup-guide/monitoring-setup-guide.md` |
|
|
@@ -204,6 +210,7 @@
|
|
|
204
210
|
| On-Call Runbook | `pm-engineering` | `pm-engineering/oncall-runbook/oncall-runbook.md` |
|
|
205
211
|
| One-on-One Prep | `pm-career` | `pm-career/one-on-one-prep/one-on-one-prep.md` |
|
|
206
212
|
| One-Pager | `pm-personal` | `pm-personal/one-pager/one-pager.md` |
|
|
213
|
+
| Org Chart | `pm-visuals` | `pm-visuals/org-chart/org-chart.md` |
|
|
207
214
|
| Outreach Message | `pm-jobsearch` | `pm-jobsearch/outreach-message/outreach-message.md` |
|
|
208
215
|
| Paid Acquisition Plan | `pm-growth` | `pm-growth/paid-acquisition-plan/paid-acquisition-plan.md` |
|
|
209
216
|
| Parent Communication | `pm-education` | `pm-education/parent-communication/parent-communication.md` |
|
|
@@ -236,6 +243,7 @@
|
|
|
236
243
|
| Proposal Writer | `pm-sales` | `pm-sales/proposal-writer/proposal-writer.md` |
|
|
237
244
|
| QBR Deck | `pm-cs` | `pm-cs/qbr-deck/qbr-deck.md` |
|
|
238
245
|
| Quiz Generator | `pm-education` | `pm-education/quiz-generator/quiz-generator.md` |
|
|
246
|
+
| Quote Card | `pm-visuals` | `pm-visuals/quote-card/quote-card.md` |
|
|
239
247
|
| RACI Matrix | `pm-operations` | `pm-operations/raci-matrix/raci-matrix.md` |
|
|
240
248
|
| RAG Architecture Review | `pm-ai` | `pm-ai/rag-architecture-review/rag-architecture-review.md` |
|
|
241
249
|
| RAG Design Doc | `pm-ai` | `pm-ai/rag-design-doc/rag-design-doc.md` |
|
|
@@ -273,6 +281,7 @@
|
|
|
273
281
|
| Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/security-threat-model.md` |
|
|
274
282
|
| Self-Review | `pm-career` | `pm-career/self-review/self-review.md` |
|
|
275
283
|
| SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/seo-content-brief.md` |
|
|
284
|
+
| Sequence Diagram | `pm-visuals` | `pm-visuals/sequence-diagram/sequence-diagram.md` |
|
|
276
285
|
| Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/service-catalog-entry.md` |
|
|
277
286
|
| Short-Form Script | `pm-creator` | `pm-creator/short-form-script/short-form-script.md` |
|
|
278
287
|
| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/skill-security-auditor.md` |
|
|
@@ -314,6 +323,7 @@
|
|
|
314
323
|
| Transcreation | `pm-localization` | `pm-localization/transcreation/transcreation.md` |
|
|
315
324
|
| Unit Economics | `pm-calculators` | `pm-calculators/unit-economics/unit-economics.md` |
|
|
316
325
|
| User Interview Synthesis | `pm-discovery` | `pm-discovery/user-interview-synthesis/user-interview-synthesis.md` |
|
|
326
|
+
| User Journey Map | `pm-visuals` | `pm-visuals/user-journey-map/user-journey-map.md` |
|
|
317
327
|
| User Research Synthesis | `pm-essentials` | `pm-essentials/user-research-synthesis/user-research-synthesis.md` |
|
|
318
328
|
| User Story Writer | `pm-delivery` | `pm-delivery/user-story-writer/user-story-writer.md` |
|
|
319
329
|
| UX Research Plan | `pm-design` | `pm-design/ux-research-plan/ux-research-plan.md` |
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# Announcement Card Skill
|
|
2
|
+
|
|
3
|
+
A great announcement is short, concrete, and easy to skim — the opposite of a press release. This skill
|
|
4
|
+
writes a tight announcement built to be **shared as an image**: a bold headline, a one-line "what & why it
|
|
5
|
+
matters", a few proof points, and a clear next step. In the playground it exports beautifully via **🖼️ Save
|
|
6
|
+
as image**.
|
|
7
|
+
|
|
8
|
+
## Required Inputs
|
|
9
|
+
|
|
10
|
+
Ask for these only if they aren't already provided:
|
|
11
|
+
|
|
12
|
+
- **What you're announcing** — the launch / milestone / feature / hire / funding / win.
|
|
13
|
+
- **Why it matters** — the benefit or significance to the audience.
|
|
14
|
+
- **One or two proof points** — a number, a name, a before/after, a quote.
|
|
15
|
+
- **Audience & channel** — LinkedIn, X, Slack, email — and the tone (celebratory, matter-of-fact).
|
|
16
|
+
- **Call to action** — what you want people to do next (try it, read more, congratulate the team).
|
|
17
|
+
|
|
18
|
+
## Output Format
|
|
19
|
+
|
|
20
|
+
Keep it short enough to read in five seconds. Use this structure:
|
|
21
|
+
|
|
22
|
+
### [🎉 emoji] [Punchy headline — the news in one line]
|
|
23
|
+
|
|
24
|
+
**[One sentence: what it is and why it matters.]**
|
|
25
|
+
|
|
26
|
+
- **[Proof point 1]** — a number or concrete fact
|
|
27
|
+
- **[Proof point 2]** — another
|
|
28
|
+
- *(optional)* **[Proof point 3]**
|
|
29
|
+
|
|
30
|
+
👉 **[Call to action]** — [link or next step]
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
*Then provide:*
|
|
34
|
+
- **3 alternate headlines** — so they can pick the punchiest.
|
|
35
|
+
- **A one-line caption** for the post body (the card is the image; this is the text beside it).
|
|
36
|
+
- **Channel note** — any tweak for the chosen channel (hashtags for X, tag-the-team for LinkedIn, etc.).
|
|
37
|
+
|
|
38
|
+
## Quality Checks
|
|
39
|
+
|
|
40
|
+
- [ ] Headline states the actual news — not "Exciting update!" but the specific thing
|
|
41
|
+
- [ ] Reads in ~5 seconds; every line earns its place
|
|
42
|
+
- [ ] At least one concrete proof point (number, name, before/after) — not just adjectives
|
|
43
|
+
- [ ] One clear call to action
|
|
44
|
+
- [ ] Tone matches the channel and audience
|
|
45
|
+
- [ ] Structured to look great as an exported image card (short lines, scannable)
|
|
46
|
+
|
|
47
|
+
## Anti-Patterns
|
|
48
|
+
|
|
49
|
+
- [ ] Do not write a press release — this is a card, not three paragraphs
|
|
50
|
+
- [ ] Do not bury the news under throat-clearing ("We're thrilled to share that…") — lead with it
|
|
51
|
+
- [ ] Do not use hollow hype — "game-changing", "revolutionary" with no proof
|
|
52
|
+
- [ ] Do not cram multiple announcements into one card — one piece of news
|
|
53
|
+
- [ ] Do not omit the call to action — tell people what to do next
|
|
54
|
+
|
|
55
|
+
## Based On
|
|
56
|
+
|
|
57
|
+
Social/launch announcement craft (lead with the news, proof over adjectives, one CTA, skimmable for an image card).
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Architecture Diagram Skill
|
|
2
|
+
|
|
3
|
+
"How does the system fit together?" is best answered with a picture. This skill turns a described system
|
|
4
|
+
into a clean **Mermaid architecture diagram** — clients, services, data stores, and third parties, grouped
|
|
5
|
+
into logical layers with labelled connections (sync vs async, protocols) — not an undifferentiated blob of
|
|
6
|
+
boxes.
|
|
7
|
+
|
|
8
|
+
## Required Inputs
|
|
9
|
+
|
|
10
|
+
Ask for these only if they aren't already provided:
|
|
11
|
+
|
|
12
|
+
- **The components** — services, apps, databases, queues, external APIs.
|
|
13
|
+
- **How they connect** — who calls whom; sync (HTTP/gRPC) vs async (queue/event); data flow direction.
|
|
14
|
+
- **Logical groupings** — frontend / backend / data / third-party, or by team/domain.
|
|
15
|
+
- **Focus** — the whole system or one slice (e.g. just the checkout path).
|
|
16
|
+
|
|
17
|
+
## Output Format
|
|
18
|
+
|
|
19
|
+
### [System name] — architecture
|
|
20
|
+
|
|
21
|
+
One line on what the diagram covers and its boundary.
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
flowchart LR
|
|
25
|
+
subgraph Client
|
|
26
|
+
Web[Web app]
|
|
27
|
+
Mobile[Mobile app]
|
|
28
|
+
end
|
|
29
|
+
subgraph Backend
|
|
30
|
+
API[API gateway]
|
|
31
|
+
Svc[Order service]
|
|
32
|
+
end
|
|
33
|
+
subgraph Data
|
|
34
|
+
DB[(Postgres)]
|
|
35
|
+
Cache[(Redis)]
|
|
36
|
+
end
|
|
37
|
+
Web --> API
|
|
38
|
+
Mobile --> API
|
|
39
|
+
API --> Svc
|
|
40
|
+
Svc --> DB
|
|
41
|
+
Svc -.async.-> Queue[[Event bus]]
|
|
42
|
+
Svc --> Cache
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**Component legend** — one line per non-obvious component (what it is, why it's there).
|
|
46
|
+
|
|
47
|
+
**Notes** — trust boundaries, single points of failure, sync vs async (`-.->` = async), anything to revisit.
|
|
48
|
+
|
|
49
|
+
## Mermaid Rules (so it renders)
|
|
50
|
+
|
|
51
|
+
- Use `flowchart LR` (or `TD`) with `subgraph Name ... end` for logical layers.
|
|
52
|
+
- Databases/stores read well as `[(name)]`; queues/buses as `[[name]]`.
|
|
53
|
+
- Solid arrows `-->` for synchronous calls, dotted `-.label.->` for async/events.
|
|
54
|
+
- Short node labels; keep IDs unique and simple. No parentheses/quotes inside labels.
|
|
55
|
+
|
|
56
|
+
## Quality Checks
|
|
57
|
+
|
|
58
|
+
- [ ] Components are grouped into meaningful layers (subgraphs), not one flat pile
|
|
59
|
+
- [ ] Connection direction reflects who calls whom; async vs sync is distinguished
|
|
60
|
+
- [ ] Data stores and external/third-party systems are visually distinct from services
|
|
61
|
+
- [ ] The legend explains anything non-obvious; trust boundaries / SPOFs are noted
|
|
62
|
+
- [ ] The Mermaid block renders without edits
|
|
63
|
+
|
|
64
|
+
## Anti-Patterns
|
|
65
|
+
|
|
66
|
+
- [ ] Do not draw every box the same with undifferentiated arrows — show layers and connection types
|
|
67
|
+
- [ ] Do not omit data stores or external dependencies — they're usually where the risk lives
|
|
68
|
+
- [ ] Do not blur sync and async — they have very different failure modes
|
|
69
|
+
- [ ] Do not cram the entire system when the ask is one slice — match the requested focus
|
|
70
|
+
- [ ] Do not break Mermaid with special characters in labels
|
|
71
|
+
|
|
72
|
+
## Based On
|
|
73
|
+
|
|
74
|
+
Architecture diagramming (C4-style grouping, logical layers, sync/async edges), expressed as renderable Mermaid.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Entity-Relationship Diagram Skill
|
|
2
|
+
|
|
3
|
+
Before you write a migration, it pays to see the data model: the entities, their key fields, and how they
|
|
4
|
+
relate (one-to-many, many-to-many). This skill turns a described domain into a clean **Mermaid ER diagram**
|
|
5
|
+
with proper cardinality notation and the attributes that matter.
|
|
6
|
+
|
|
7
|
+
## Required Inputs
|
|
8
|
+
|
|
9
|
+
Ask for these only if they aren't already provided:
|
|
10
|
+
|
|
11
|
+
- **The entities** — the core objects/tables (User, Order, Product…).
|
|
12
|
+
- **Relationships** — how they relate, and the cardinality (a user *has many* orders, an order *has many* line items).
|
|
13
|
+
- **Key attributes** — the important fields per entity (especially keys); full column lists aren't required.
|
|
14
|
+
- **The domain** — what the system does, so the model is realistic.
|
|
15
|
+
|
|
16
|
+
## Output Format
|
|
17
|
+
|
|
18
|
+
### [Domain] — data model
|
|
19
|
+
|
|
20
|
+
One line on the scope of the model.
|
|
21
|
+
|
|
22
|
+
```mermaid
|
|
23
|
+
erDiagram
|
|
24
|
+
USER ||--o{ ORDER : places
|
|
25
|
+
ORDER ||--|{ LINE_ITEM : contains
|
|
26
|
+
PRODUCT ||--o{ LINE_ITEM : "appears in"
|
|
27
|
+
USER {
|
|
28
|
+
uuid id PK
|
|
29
|
+
string email
|
|
30
|
+
string name
|
|
31
|
+
}
|
|
32
|
+
ORDER {
|
|
33
|
+
uuid id PK
|
|
34
|
+
uuid user_id FK
|
|
35
|
+
datetime created_at
|
|
36
|
+
string status
|
|
37
|
+
}
|
|
38
|
+
LINE_ITEM {
|
|
39
|
+
uuid id PK
|
|
40
|
+
uuid order_id FK
|
|
41
|
+
uuid product_id FK
|
|
42
|
+
int qty
|
|
43
|
+
}
|
|
44
|
+
PRODUCT {
|
|
45
|
+
uuid id PK
|
|
46
|
+
string name
|
|
47
|
+
decimal price
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
**Cardinality key** — `||--o{` = one-to-many, `}o--o{` = many-to-many, `||--||` = one-to-one.
|
|
52
|
+
|
|
53
|
+
**Design notes** — normalization choices, where a join table is needed, indexes worth adding, anything deferred.
|
|
54
|
+
|
|
55
|
+
## Mermaid Rules (so it renders)
|
|
56
|
+
|
|
57
|
+
- Start with `erDiagram`. Relationship line: `A ||--o{ B : label`.
|
|
58
|
+
- Crow's-foot cardinality: `||` (exactly one), `o{` (zero-or-many), `|{` (one-or-many), `o|` (zero-or-one).
|
|
59
|
+
- Attribute blocks: `ENTITY { type name PK }` — mark keys with `PK` / `FK`.
|
|
60
|
+
- Entity names are usually UPPER_SNAKE; quote relationship labels that contain spaces.
|
|
61
|
+
|
|
62
|
+
## Quality Checks
|
|
63
|
+
|
|
64
|
+
- [ ] Every relationship has explicit, correct cardinality (not just a plain line)
|
|
65
|
+
- [ ] Primary and foreign keys are marked (PK/FK)
|
|
66
|
+
- [ ] Many-to-many relationships are resolved with a join entity where appropriate
|
|
67
|
+
- [ ] Attribute types are sensible for the domain
|
|
68
|
+
- [ ] The Mermaid block renders without edits
|
|
69
|
+
|
|
70
|
+
## Anti-Patterns
|
|
71
|
+
|
|
72
|
+
- [ ] Do not draw relationships without cardinality — "related" isn't a data model
|
|
73
|
+
- [ ] Do not leave many-to-many unresolved when a join table is the right call
|
|
74
|
+
- [ ] Do not dump every conceivable column — show the keys and the attributes that matter
|
|
75
|
+
- [ ] Do not omit foreign keys — they're how the relationships are actually enforced
|
|
76
|
+
- [ ] Do not break Mermaid with unquoted spaced labels
|
|
77
|
+
|
|
78
|
+
## Based On
|
|
79
|
+
|
|
80
|
+
Data modeling (entity-relationship modeling, crow's-foot notation, normalization), expressed as renderable Mermaid.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Flowchart Skill
|
|
2
|
+
|
|
3
|
+
A wall of prose describing a process is hard to follow; a flowchart makes the steps, branches, and
|
|
4
|
+
dead-ends obvious at a glance. This skill turns a described process into a clean, correctly-structured
|
|
5
|
+
**Mermaid flowchart** — with real decision diamonds, parallel paths, and end states — not a vague
|
|
6
|
+
box-and-arrow sketch.
|
|
7
|
+
|
|
8
|
+
## Required Inputs
|
|
9
|
+
|
|
10
|
+
Ask for these only if they aren't already provided:
|
|
11
|
+
|
|
12
|
+
- **The process** — what happens, roughly in order (steps, who does what).
|
|
13
|
+
- **Decision points** — where the path branches, and on what condition.
|
|
14
|
+
- **Start and end states** — where it begins and the possible outcomes (success, rejection, error).
|
|
15
|
+
- **Direction preference** (optional) — top-down (`TD`) for most processes, left-right (`LR`) for pipelines.
|
|
16
|
+
|
|
17
|
+
If the process is ambiguous, state the assumption you made rather than inventing steps.
|
|
18
|
+
|
|
19
|
+
## Output Format
|
|
20
|
+
|
|
21
|
+
### [Process name] — flowchart
|
|
22
|
+
|
|
23
|
+
A one-line summary of what the chart shows.
|
|
24
|
+
|
|
25
|
+
```mermaid
|
|
26
|
+
flowchart TD
|
|
27
|
+
A([Start]) --> B[First step]
|
|
28
|
+
B --> C{Decision?}
|
|
29
|
+
C -->|Yes| D[Path A]
|
|
30
|
+
C -->|No| E[Path B]
|
|
31
|
+
D --> F([Done])
|
|
32
|
+
E --> F
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
**Legend / notes**
|
|
36
|
+
- Rounded nodes `([ ])` = start/end, rectangles `[ ]` = actions, diamonds `{ }` = decisions.
|
|
37
|
+
- Call out any swimlane/owner, SLA, or branch that needs attention.
|
|
38
|
+
|
|
39
|
+
**Assumptions** — anything you inferred about the process.
|
|
40
|
+
|
|
41
|
+
## Mermaid Rules (so it renders)
|
|
42
|
+
|
|
43
|
+
- Start with `flowchart TD` (or `LR`). Give every node a short ID (`A`, `step1`) and a label.
|
|
44
|
+
- Decisions are `{ }` with labelled edges: `C -->|Yes| D`.
|
|
45
|
+
- Keep labels short; put detail in the notes, not inside the node.
|
|
46
|
+
- Avoid unescaped parentheses/quotes inside labels — they break parsing. Use plain text.
|
|
47
|
+
- One concept per node; don't cram a sentence into a box.
|
|
48
|
+
|
|
49
|
+
## Quality Checks
|
|
50
|
+
|
|
51
|
+
- [ ] Every decision diamond has all its branches labelled and leading somewhere (no dangling paths)
|
|
52
|
+
- [ ] There is a clear start and at least one explicit end state
|
|
53
|
+
- [ ] Node shapes are used meaningfully (action vs decision vs start/end)
|
|
54
|
+
- [ ] The Mermaid block is syntactically valid and renders without edits
|
|
55
|
+
- [ ] Assumptions about ambiguous steps are stated, not silently invented
|
|
56
|
+
|
|
57
|
+
## Anti-Patterns
|
|
58
|
+
|
|
59
|
+
- [ ] Do not produce a linear chain when the real process has branches — capture the decisions
|
|
60
|
+
- [ ] Do not stuff full sentences into nodes — keep labels short, move detail to notes
|
|
61
|
+
- [ ] Do not leave a decision with only one labelled branch — show what happens on every condition
|
|
62
|
+
- [ ] Do not use parentheses or quotes inside labels in a way that breaks Mermaid
|
|
63
|
+
- [ ] Do not invent steps to fill gaps — flag what you assumed
|
|
64
|
+
|
|
65
|
+
## Based On
|
|
66
|
+
|
|
67
|
+
Process mapping / flowcharting practice (ANSI flowchart conventions), expressed as renderable Mermaid.
|