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.
Files changed (134) hide show
  1. package/README.md +26 -25
  2. package/exports/README.md +1 -1
  3. package/exports/aider/README.md +11 -1
  4. package/exports/aider/pm-visuals/announcement-card/announcement-card.md +57 -0
  5. package/exports/aider/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
  6. package/exports/aider/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
  7. package/exports/aider/pm-visuals/flowchart/flowchart.md +67 -0
  8. package/exports/aider/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
  9. package/exports/aider/pm-visuals/mind-map/mind-map.md +62 -0
  10. package/exports/aider/pm-visuals/org-chart/org-chart.md +69 -0
  11. package/exports/aider/pm-visuals/quote-card/quote-card.md +51 -0
  12. package/exports/aider/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
  13. package/exports/aider/pm-visuals/user-journey-map/user-journey-map.md +70 -0
  14. package/exports/chatgpt/README.md +11 -1
  15. package/exports/chatgpt/pm-visuals/announcement-card/SYSTEM_PROMPT.md +57 -0
  16. package/exports/chatgpt/pm-visuals/architecture-diagram/SYSTEM_PROMPT.md +74 -0
  17. package/exports/chatgpt/pm-visuals/entity-relationship-diagram/SYSTEM_PROMPT.md +80 -0
  18. package/exports/chatgpt/pm-visuals/flowchart/SYSTEM_PROMPT.md +67 -0
  19. package/exports/chatgpt/pm-visuals/gantt-roadmap/SYSTEM_PROMPT.md +72 -0
  20. package/exports/chatgpt/pm-visuals/mind-map/SYSTEM_PROMPT.md +62 -0
  21. package/exports/chatgpt/pm-visuals/org-chart/SYSTEM_PROMPT.md +69 -0
  22. package/exports/chatgpt/pm-visuals/quote-card/SYSTEM_PROMPT.md +51 -0
  23. package/exports/chatgpt/pm-visuals/sequence-diagram/SYSTEM_PROMPT.md +65 -0
  24. package/exports/chatgpt/pm-visuals/user-journey-map/SYSTEM_PROMPT.md +70 -0
  25. package/exports/cline/README.md +11 -1
  26. package/exports/cline/pm-visuals/announcement-card/announcement-card.md +57 -0
  27. package/exports/cline/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
  28. package/exports/cline/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
  29. package/exports/cline/pm-visuals/flowchart/flowchart.md +67 -0
  30. package/exports/cline/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
  31. package/exports/cline/pm-visuals/mind-map/mind-map.md +62 -0
  32. package/exports/cline/pm-visuals/org-chart/org-chart.md +69 -0
  33. package/exports/cline/pm-visuals/quote-card/quote-card.md +51 -0
  34. package/exports/cline/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
  35. package/exports/cline/pm-visuals/user-journey-map/user-journey-map.md +70 -0
  36. package/exports/continue/README.md +11 -1
  37. package/exports/continue/pm-visuals/announcement-card/announcement-card.md +62 -0
  38. package/exports/continue/pm-visuals/architecture-diagram/architecture-diagram.md +79 -0
  39. package/exports/continue/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +85 -0
  40. package/exports/continue/pm-visuals/flowchart/flowchart.md +72 -0
  41. package/exports/continue/pm-visuals/gantt-roadmap/gantt-roadmap.md +77 -0
  42. package/exports/continue/pm-visuals/mind-map/mind-map.md +67 -0
  43. package/exports/continue/pm-visuals/org-chart/org-chart.md +74 -0
  44. package/exports/continue/pm-visuals/quote-card/quote-card.md +56 -0
  45. package/exports/continue/pm-visuals/sequence-diagram/sequence-diagram.md +70 -0
  46. package/exports/continue/pm-visuals/user-journey-map/user-journey-map.md +75 -0
  47. package/exports/cursor/README.md +11 -1
  48. package/exports/cursor/pm-visuals/announcement-card/announcement-card.mdc +63 -0
  49. package/exports/cursor/pm-visuals/architecture-diagram/architecture-diagram.mdc +80 -0
  50. package/exports/cursor/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.mdc +86 -0
  51. package/exports/cursor/pm-visuals/flowchart/flowchart.mdc +73 -0
  52. package/exports/cursor/pm-visuals/gantt-roadmap/gantt-roadmap.mdc +78 -0
  53. package/exports/cursor/pm-visuals/mind-map/mind-map.mdc +68 -0
  54. package/exports/cursor/pm-visuals/org-chart/org-chart.mdc +75 -0
  55. package/exports/cursor/pm-visuals/quote-card/quote-card.mdc +57 -0
  56. package/exports/cursor/pm-visuals/sequence-diagram/sequence-diagram.mdc +71 -0
  57. package/exports/cursor/pm-visuals/user-journey-map/user-journey-map.mdc +76 -0
  58. package/exports/gemini/README.md +11 -1
  59. package/exports/gemini/pm-visuals/announcement-card/GEM_INSTRUCTIONS.md +61 -0
  60. package/exports/gemini/pm-visuals/architecture-diagram/GEM_INSTRUCTIONS.md +78 -0
  61. package/exports/gemini/pm-visuals/entity-relationship-diagram/GEM_INSTRUCTIONS.md +84 -0
  62. package/exports/gemini/pm-visuals/flowchart/GEM_INSTRUCTIONS.md +71 -0
  63. package/exports/gemini/pm-visuals/gantt-roadmap/GEM_INSTRUCTIONS.md +76 -0
  64. package/exports/gemini/pm-visuals/mind-map/GEM_INSTRUCTIONS.md +66 -0
  65. package/exports/gemini/pm-visuals/org-chart/GEM_INSTRUCTIONS.md +73 -0
  66. package/exports/gemini/pm-visuals/quote-card/GEM_INSTRUCTIONS.md +55 -0
  67. package/exports/gemini/pm-visuals/sequence-diagram/GEM_INSTRUCTIONS.md +69 -0
  68. package/exports/gemini/pm-visuals/user-journey-map/GEM_INSTRUCTIONS.md +74 -0
  69. package/exports/kilocode/README.md +11 -1
  70. package/exports/kilocode/pm-visuals/announcement-card/announcement-card.md +57 -0
  71. package/exports/kilocode/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
  72. package/exports/kilocode/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
  73. package/exports/kilocode/pm-visuals/flowchart/flowchart.md +67 -0
  74. package/exports/kilocode/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
  75. package/exports/kilocode/pm-visuals/mind-map/mind-map.md +62 -0
  76. package/exports/kilocode/pm-visuals/org-chart/org-chart.md +69 -0
  77. package/exports/kilocode/pm-visuals/quote-card/quote-card.md +51 -0
  78. package/exports/kilocode/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
  79. package/exports/kilocode/pm-visuals/user-journey-map/user-journey-map.md +70 -0
  80. package/exports/obsidian/README.md +11 -1
  81. package/exports/obsidian/pm-visuals/announcement-card/announcement-card.md +72 -0
  82. package/exports/obsidian/pm-visuals/architecture-diagram/architecture-diagram.md +89 -0
  83. package/exports/obsidian/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +95 -0
  84. package/exports/obsidian/pm-visuals/flowchart/flowchart.md +82 -0
  85. package/exports/obsidian/pm-visuals/gantt-roadmap/gantt-roadmap.md +87 -0
  86. package/exports/obsidian/pm-visuals/mind-map/mind-map.md +77 -0
  87. package/exports/obsidian/pm-visuals/org-chart/org-chart.md +84 -0
  88. package/exports/obsidian/pm-visuals/quote-card/quote-card.md +66 -0
  89. package/exports/obsidian/pm-visuals/sequence-diagram/sequence-diagram.md +80 -0
  90. package/exports/obsidian/pm-visuals/user-journey-map/user-journey-map.md +85 -0
  91. package/exports/roo/README.md +11 -1
  92. package/exports/roo/pm-visuals/announcement-card/announcement-card.md +57 -0
  93. package/exports/roo/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
  94. package/exports/roo/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
  95. package/exports/roo/pm-visuals/flowchart/flowchart.md +67 -0
  96. package/exports/roo/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
  97. package/exports/roo/pm-visuals/mind-map/mind-map.md +62 -0
  98. package/exports/roo/pm-visuals/org-chart/org-chart.md +69 -0
  99. package/exports/roo/pm-visuals/quote-card/quote-card.md +51 -0
  100. package/exports/roo/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
  101. package/exports/roo/pm-visuals/user-journey-map/user-journey-map.md +70 -0
  102. package/exports/windsurf/README.md +11 -1
  103. package/exports/windsurf/pm-visuals/announcement-card/announcement-card.md +62 -0
  104. package/exports/windsurf/pm-visuals/architecture-diagram/architecture-diagram.md +79 -0
  105. package/exports/windsurf/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +85 -0
  106. package/exports/windsurf/pm-visuals/flowchart/flowchart.md +72 -0
  107. package/exports/windsurf/pm-visuals/gantt-roadmap/gantt-roadmap.md +77 -0
  108. package/exports/windsurf/pm-visuals/mind-map/mind-map.md +67 -0
  109. package/exports/windsurf/pm-visuals/org-chart/org-chart.md +74 -0
  110. package/exports/windsurf/pm-visuals/quote-card/quote-card.md +56 -0
  111. package/exports/windsurf/pm-visuals/sequence-diagram/sequence-diagram.md +70 -0
  112. package/exports/windsurf/pm-visuals/user-journey-map/user-journey-map.md +75 -0
  113. package/exports/zed/README.md +11 -1
  114. package/exports/zed/pm-visuals/announcement-card/announcement-card.md +57 -0
  115. package/exports/zed/pm-visuals/architecture-diagram/architecture-diagram.md +74 -0
  116. package/exports/zed/pm-visuals/entity-relationship-diagram/entity-relationship-diagram.md +80 -0
  117. package/exports/zed/pm-visuals/flowchart/flowchart.md +67 -0
  118. package/exports/zed/pm-visuals/gantt-roadmap/gantt-roadmap.md +72 -0
  119. package/exports/zed/pm-visuals/mind-map/mind-map.md +62 -0
  120. package/exports/zed/pm-visuals/org-chart/org-chart.md +69 -0
  121. package/exports/zed/pm-visuals/quote-card/quote-card.md +51 -0
  122. package/exports/zed/pm-visuals/sequence-diagram/sequence-diagram.md +65 -0
  123. package/exports/zed/pm-visuals/user-journey-map/user-journey-map.md +70 -0
  124. package/package.json +2 -2
  125. package/skills/announcement-card/SKILL.md +62 -0
  126. package/skills/architecture-diagram/SKILL.md +79 -0
  127. package/skills/entity-relationship-diagram/SKILL.md +85 -0
  128. package/skills/flowchart/SKILL.md +72 -0
  129. package/skills/gantt-roadmap/SKILL.md +77 -0
  130. package/skills/mind-map/SKILL.md +67 -0
  131. package/skills/org-chart/SKILL.md +74 -0
  132. package/skills/quote-card/SKILL.md +56 -0
  133. package/skills/sequence-diagram/SKILL.md +70 -0
  134. package/skills/user-journey-map/SKILL.md +75 -0
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # 🧠 PM Skills — 319 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
1
+ # 🧠 PM Skills — 329 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
2
2
 
3
3
  [![In the official Anthropic plugin directory](https://img.shields.io/badge/Anthropic%20Plugin%20Directory-Published-D97757?logo=anthropic&logoColor=white)](#-quick-install-2-minutes)
4
4
  [![Stars](https://img.shields.io/github/stars/mohitagw15856/pm-claude-skills?style=social)](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
@@ -9,7 +9,7 @@
9
9
  [![MCP](https://img.shields.io/badge/MCP-registry-0098FF?logo=modelcontextprotocol&logoColor=white)](https://github.com/mohitagw15856/pm-claude-skills#-use-it-anywhere--the-ai-ecosystem)
10
10
  [![Remote MCP](https://img.shields.io/badge/ChatGPT%20%C2%B7%20Claude.ai-connector-10A37F)](mcp-remote/)
11
11
  [![Smithery](https://smithery.ai/badge/mohit15856/pm-skills)](https://smithery.ai/servers/mohit15856/pm-skills)
12
- [![Skills](https://img.shields.io/badge/skills-319-blue)](https://github.com/mohitagw15856/pm-claude-skills)
12
+ [![Skills](https://img.shields.io/badge/skills-329-blue)](https://github.com/mohitagw15856/pm-claude-skills)
13
13
  [![eval](https://img.shields.io/badge/eval--scored-208%20%C2%B7%20avg%204.8%2F5-brightgreen)](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
14
14
  [![Subagents](https://img.shields.io/badge/subagents-4-blueviolet)](agents/)
15
15
  [![Commands](https://img.shields.io/badge/slash%20commands-19-blueviolet)](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&center=true&vCenter=true&width=720&lines=319+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
28
+ <img src="https://readme-typing-svg.demolab.com?font=Inter&weight=600&size=24&pause=900&color=D97757&center=true&vCenter=true&width=720&lines=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
- > 319 professional skills + 4 agent templates across 46 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
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 — v30.2.0 (中文 interfacea bilingual playground):** the whole playground UI now switches between **English and Simplified Chinese** — every page carries a **🌐 中文 / 🌐 English** toggle in the nav (nav, hero, Job Search, Guided Journeys, Catalog, and more are hand-translated, not machine output). Your choice is remembered across visits. This is on top of the **🌐 Translate** button that localizes any *generated result* into 11 languages. *Earlier (v30.1):* a **🌐 Localization bundle** `professional-translator`, `transcreation`, `localization-brief`, `subtitle-caption`, `glossary-builder`, `i18n-readiness-review`. **319 skills across 46 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
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 319 skills](#️-all-319-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
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-319-skills) bundle (résumé, cover letter, bio, LinkedIn, portfolio, one-pager).
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 319 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
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 — 319 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
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 319 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:
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 319 skills**](#️-all-319-skills) grouped by profession.
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 | **319**, across 23 professions | a handful → dozens, usually one domain |
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 319 interactively:
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 319
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 319 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
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 319 skills reach you through every channel — pick whatever fits your stack:
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 319 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
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 319 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
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 319 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.
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 319 skills here are the building blocks for agent templates outside of finance.**
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.** 319 skills across 46 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
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 319-skill library doesn't have 319 equally-mature skills, and pretending otherwise
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 319 Skills
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 319 skills across 46 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
+ 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-319-skills) above). Want
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 **319 skills** to:
11
+ Currently exporting **329 skills** to:
12
12
 
13
13
  - **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
14
14
  - **Google Gemini — Gem instructions** → `exports/gemini/`
@@ -3,7 +3,7 @@
3
3
  > Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
4
4
  > **Do not edit these files by hand** — edit the source skill and regenerate.
5
5
 
6
- 319 skills exported. Copy a `.mdc rule` into the tool to use it.
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.