pm-claude-skills 20.2.0 → 21.0.0

package/README.md

@@ -12,7 +12,7 @@
 [![Platforms](https://img.shields.io/badge/works%20with-Claude%20%7C%20ChatGPT%20%7C%20Gemini%20%7C%20Cursor%20%7C%20Codex%20%7C%20Hermes-8A2BE2)](#-works-with--cross-tool-compatibility)
 [![SkillCheck](https://img.shields.io/github/actions/workflow/status/mohitagw15856/pm-claude-skills/skillcheck.yml?branch=main&label=SkillCheck)](.github/workflows/skillcheck.yml)
 [![Security Audit](https://img.shields.io/github/actions/workflow/status/mohitagw15856/pm-claude-skills/skill-audit.yml?branch=main&label=security%20audit)](.github/workflows/skill-audit.yml)
-[![Version](https://img.shields.io/badge/version-20.2.0-brightgreen)](https://github.com/mohitagw15856/pm-claude-skills/releases)
+[![Version](https://img.shields.io/badge/version-21.0.0-brightgreen)](https://github.com/mohitagw15856/pm-claude-skills/releases)
 [![Install](https://img.shields.io/badge/Install%20in%20Claude%20Code-2%20minutes-orange)](https://github.com/mohitagw15856/pm-claude-skills#-quick-install-2-minutes)
 [![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
 [![Sponsor](https://img.shields.io/badge/sponsor-❤️-ff69b4)](https://github.com/sponsors/mohitagw15856)
@@ -26,16 +26,113 @@ A community-built library of professional skills for every field — product man
 
 **🆕 Latest release (v20.2.0 — Community PRs & New Skill):** a new **YouTube Script Writer** skill (**174 total**), a stdlib **feature-prioritisation** helper, safer installs, and robust frontmatter parsing — all from community contributors. See the [changelog](#-changelog).
 
-<!-- DEMO: replace web/docs-assets/playground.png below with web/docs-assets/playground-demo.gif
-     once recorded (see web/docs-assets/README.md for how). The link goes to the live app. -->
 ### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
 
-[![Skill Playground demo — pick a skill, fill the form, run it with your own Claude key](web/docs-assets/playground.png)](https://mohitagw15856.github.io/pm-claude-skills/)
+<!-- Demo GIF generated by web/docs-assets/record-demo.mjs (Playwright). The streamed
+     output is a representative mock so no API key is needed; re-run with a live key
+     for a real call. Static fallback: web/docs-assets/playground.png -->
+[![Skill Playground demo — pick a skill, fill the form, run it with your own Claude key](web/docs-assets/playground-demo.gif)](https://mohitagw15856.github.io/pm-claude-skills/)
+
+<sub>👆 Pick any skill, fill a short form, and run it with your own key — no install required.</sub>
+
+---
+
+## 👋 New here? Start in 30 seconds
+
+**The problem:** Ask any AI for a PRD, an exec update, or a launch plan and you get *generic* — plausible-sounding filler you still have to rewrite from scratch. The model doesn't know what "good" actually looks like for professional work.
+
+**What this fixes:** Each skill is a battle-tested `SKILL.md` that teaches the AI the real structure, rigour, and judgement a senior professional uses — so the first draft is one you can *ship*, not one you have to redo.
+
+**Try these 5 first** — no install needed, run them right in the [live Playground](https://mohitagw15856.github.io/pm-claude-skills/):
+
+| Skill | Give it… | Get back… |
+|-------|----------|-----------|
+| 📊 [Executive Update](skills/executive-update) | messy progress notes | a tight 250-word briefing for your CEO or board |
+| 📋 [PRD Template](skills/prd-template) | a vague feature idea | a structured PRD with scope, success metrics & risks |
+| 🎯 [RICE Prioritisation](skills/rice-prioritisation) | a pile of backlog ideas | a ranked, defensible priority list |
+| 🔭 [Competitor Teardown](skills/competitor-teardown) | "what are rivals up to?" | a positioning map, feature gaps & strategy |
+| 📝 [Meeting Notes](skills/meeting-notes) | a raw transcript | decisions, owners & next steps |
+
+→ 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 174 skills](#️-all-174-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
+
+---
+
+## 🔄 One library, the whole professional workflow
+
+These 174 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:
+
+```
+  DISCOVER  →   DECIDE   →    BUILD    →    SHIP    →   MEASURE   →  COMMUNICATE
+ ──────────   ──────────   ──────────   ──────────   ──────────   ─────────────
+  frame the    prioritise    design &     launch &     track &      report up
+  problem,     & spec the    engineer     release      analyse      & out
+  research     work          the work     the work     results
+        └────────────────────── feeds the next discovery ──────────────────────┘
+```
+
+| Phase | What you're doing | Start with these skills |
+|-------|-------------------|--------------------------|
+| **🔍 Discover** | Frame the problem, research, validate | `ambiguity-resolver` · `user-research-synthesis` · `competitive-analysis` · `discovery-interview-guide` |
+| **🎯 Decide** | Prioritise, spec, set goals | `rice-prioritisation` · `prd-template` · `okr-builder` · `roadmap-narrative` |
+| **🔨 Build** | Design & engineer the work | `technical-spec-template` · `design-critique` · `sprint-planning` · `architecture-decision-record` |
+| **🚀 Ship** | Launch & release | `go-to-market` · `launch-readiness` · `product-launch-checklist` · `runbook-writer` |
+| **📊 Measure** | Track outcomes & analyse | `metrics-framework` · `cohort-analysis` · `ab-test-planner` · `churn-analysis` |
+| **📣 Communicate** | Report up and out | `executive-update` · `board-deck-narrative` · `stakeholder-update` · `qbr-deck` |
+
+> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 174 skills**](#️-all-174-skills) grouped by profession.
+
+---
+
+## 🧩 Workflow Recipes — chain skills into one flow
+
+Individual skills are great. **Chaining** them is the superpower. A *recipe* runs several skills in sequence and **passes each output forward as context** — so a fuzzy idea comes out the other end as a finished, joined-up set of artifacts. No other skills library chains across professions like this.
+
+```
+/ship-a-feature  "a referral program for B2B users"
+
+  ambiguity-resolver → prd-template → rice-prioritisation → roadmap-narrative → go-to-market
+   frame the problem    spec it        prioritise it        place on roadmap     launch plan
+        └──────────────── each stage's output feeds the next ────────────────┘
+```
+
+| Recipe | What it does | Lifecycle |
+|--------|--------------|-----------|
+| `/ship-a-feature` | idea → PRD → priority → roadmap → launch plan | Discover → Ship |
+| `/close-the-quarter` | metrics → churn → exec update → board deck | Measure → Communicate |
+| `/launch-a-product` | competitors → positioning → GTM → checklist → press release | Decide → Ship |
+| `/rescue-an-account` | health score → churn cause → escalation → renewal plan | Measure → Communicate |
+| `/run-discovery` | frame → interview guide → synthesis → prioritise | Discover → Decide |
+
+→ Full detail and how to add your own in [**WORKFLOWS.md**](WORKFLOWS.md). Recipes run as slash commands in Claude Code, or over MCP via the `get_workflow` tool.
+
+---
+
+## ✅ Eval-verified quality — not just quantity
+
+Most skill libraries ask you to trust the count. This one is **scored**. An [eval harness](evals/) runs each skill against a held-out test case, then an LLM judge (Opus 4.8) rates the output on four dimensions — **structure, completeness, usefulness, grounding** — averaged across two models.
+
+The flagship skills score consistently high (out of 5):
+
+| Skill | Eval score | Skill | Eval score |
+|-------|:---------:|-------|:---------:|
+| `prd-template` | 🟢 **4.9** | `cs-health-scorecard` | 🟢 **4.9** |
+| `rice-prioritisation` | 🟢 **4.9** | `sprint-planning` | 🟢 **4.8** |
+| `competitive-analysis` | 🟢 **4.5** | `executive-summary` | 🟢 **4.5** |
+
+These scores show up as badges in the [Playground](https://mohitagw15856.github.io/pm-claude-skills/) and the [🏆 leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html). Coverage is expanding — run it yourself with `node evals/run-evals.mjs` (needs an API key). *Honest note: 6 skills are eval-scored today; the rest are reviewed against the [authoring standard](SKILL-AUTHORING-STANDARD.md) but not yet auto-scored.*
+
+**See the difference for yourself.** The Playground's *Compare* toggle runs the same inputs with and without the skill, side by side — structured, shippable output on the left; generic mush on the right:
+
+[![Compare mode — the same prompt with and without the skill, side by side](web/docs-assets/compare-demo.gif)](https://mohitagw15856.github.io/pm-claude-skills/)
 
 ---
 
 ## Contents
 
+- [👋 New here? Start in 30 seconds](#-new-here-start-in-30-seconds)
+- [🔄 One library, the whole professional workflow](#-one-library-the-whole-professional-workflow)
+- [🧩 Workflow Recipes — chain skills into one flow](#-workflow-recipes--chain-skills-into-one-flow)
+- [✅ Eval-verified quality](#-eval-verified-quality--not-just-quantity)
 - [🚀 Quick Install](#-quick-install-2-minutes)
 - [🔌 Works With — Cross-Tool Compatibility](#-works-with--cross-tool-compatibility)
 - [🤖 Subagents & Slash Commands](#-subagents--slash-commands)
@@ -58,6 +155,14 @@ A community-built library of professional skills for every field — product man
 npx pm-claude-skills add --agent claude     # or: codex · cursor · hermes · openclaw
 ```
 
+**Or one-line MCP** — make all 174 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
+
+```bash
+claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
+```
+
+Your assistant can then *"search the skills for churn"* or *"run the ship-a-feature workflow"* on demand. Details: [mcp/README.md](mcp/README.md).
+
 **In Claude Code**, run:
 
 /plugin marketplace add mohitagw15856/pm-claude-skills

package/commands/README.md

@@ -11,6 +11,18 @@ Claude Code **slash commands** that run a skill on whatever you pass them.
 | `/retro` | Structured sprint retrospective | retro-analysis |
 | `/exec-summary` | Crisp executive summary | executive-summary |
 
+## 🧩 Workflow recipes — chained commands
+
+These run **several skills in sequence**, passing each output forward as context. Full detail in [WORKFLOWS.md](../WORKFLOWS.md).
+
+| Command | Chains | Lifecycle |
+|---|---|---|
+| `/ship-a-feature` | ambiguity-resolver → prd-template → rice-prioritisation → roadmap-narrative → go-to-market | Discover → Ship |
+| `/close-the-quarter` | metrics-framework → churn-analysis → executive-update → board-deck-narrative | Measure → Communicate |
+| `/launch-a-product` | competitor-teardown → product-positioning-doc → go-to-market → product-launch-checklist → press-release | Decide → Ship |
+| `/rescue-an-account` | cs-health-scorecard → churn-analysis → cs-escalation-brief → renewal-playbook | Measure → Communicate |
+| `/run-discovery` | ambiguity-resolver → discovery-interview-guide → user-research-synthesis → rice-prioritisation | Discover → Decide |
+
 ## Install
 
 ```bash

package/commands/close-the-quarter.md

@@ -0,0 +1,17 @@
+---
+description: Workflow recipe — turn the quarter's raw numbers into a leadership story and board deck by chaining 4 skills.
+argument-hint: [the quarter's metrics, wins, and misses]
+---
+
+Run the **Close the Quarter** workflow recipe for: $ARGUMENTS
+
+This is a *chain* of skills. Run each stage in order and **carry every stage's output forward as context** for the next. Open with a one-line plan of the 4 stages, then ask once for any essential missing inputs (the key numbers, the audience, the period). Don't re-ask between stages.
+
+Run each stage under a clear `## Stage N — <name>` heading:
+
+1. **Map what moved** — apply the `metrics-framework` skill to organise the numbers into a metric tree and identify what actually changed and why.
+2. **Explain retention** — apply the `churn-analysis` skill to separate avoidable from unavoidable churn and surface the headline retention story.
+3. **Brief leadership** — apply the `executive-update` skill, using the findings above, to write a tight leadership briefing for the period.
+4. **Build the board story** — apply the `board-deck-narrative` skill to turn that briefing into a slide-by-slide board deck storyline.
+
+Do not invent numbers — work only with what is given and flag any gaps. End with a 4-bullet **"What you now have"** recap.

package/commands/launch-a-product.md

@@ -0,0 +1,18 @@
+---
+description: Workflow recipe — go from competitive landscape to a fully checklisted launch and press release by chaining 5 skills.
+argument-hint: [the product and who it's for]
+---
+
+Run the **Launch a Product** workflow recipe for: $ARGUMENTS
+
+This is a *chain* of skills. Run each stage in order and **carry every stage's output forward as context** for the next. Open with a one-line plan of the 5 stages, then ask once for any essential missing inputs (the product, target customer, key competitors, launch date). Don't re-ask between stages.
+
+Run each stage under a clear `## Stage N — <name>` heading:
+
+1. **Map the field** — apply the `competitor-teardown` skill to map competitors and find the positioning gap to exploit.
+2. **Position it** — apply the `product-positioning-doc` skill, using that gap, to define positioning, value props, and messaging pillars.
+3. **Plan the GTM** — apply the `go-to-market` skill to turn the messaging into an audience-and-channel launch plan.
+4. **Make it launch-ready** — apply the `product-launch-checklist` skill to produce an owner-by-owner readiness checklist.
+5. **Announce it** — apply the `press-release` skill to draft the announcement, consistent with the positioning above.
+
+Do not invent facts, dates, or competitor claims — flag assumptions. End with a 5-bullet **"What you now have"** recap.

package/commands/rescue-an-account.md

@@ -0,0 +1,17 @@
+---
+description: Workflow recipe — diagnose an at-risk customer and build the full save play through to renewal by chaining 4 skills.
+argument-hint: [the account and what's going wrong]
+---
+
+Run the **Rescue an Account** workflow recipe for: $ARGUMENTS
+
+This is a *chain* of skills. Run each stage in order and **carry every stage's output forward as context** for the next. Open with a one-line plan of the 4 stages, then ask once for any essential missing inputs (ARR, renewal date, usage signals, the trigger). Don't re-ask between stages.
+
+Run each stage under a clear `## Stage N — <name>` heading:
+
+1. **Score the risk** — apply the `cs-health-scorecard` skill to produce a health score and the specific risk drivers.
+2. **Find the cause** — apply the `churn-analysis` skill to identify the root cause and whether the risk is avoidable.
+3. **Escalate it** — apply the `cs-escalation-brief` skill to write the internal brief and resolution plan.
+4. **Plan the renewal** — apply the `renewal-playbook` skill to build the renewal strategy and negotiation plan.
+
+Do not invent account facts — work only with what is given. End with a 4-bullet **"What you now have"** recap.

package/commands/run-discovery.md

@@ -0,0 +1,17 @@
+---
+description: Workflow recipe — go from a vague opportunity to validated insight and a prioritised next step by chaining 4 skills.
+argument-hint: [the opportunity or fuzzy question]
+---
+
+Run the **Run Discovery** workflow recipe for: $ARGUMENTS
+
+This is a *chain* of skills. Run each stage in order and **carry every stage's output forward as context** for the next. Open with a one-line plan of the 4 stages, then ask once for any essential missing inputs (who the users are, what's prompting this, any constraints). Don't re-ask between stages.
+
+Run each stage under a clear `## Stage N — <name>` heading:
+
+1. **Frame it** — apply the `ambiguity-resolver` skill to turn the fuzzy opportunity into a one-page problem brief with a scoped question.
+2. **Plan the research** — apply the `discovery-interview-guide` skill to build a screener and discussion guide for user interviews.
+3. **Synthesise** — apply the `user-research-synthesis` skill to turn findings into themes and validated insights. (If no real findings exist yet, produce a synthesis template to fill in after interviews.)
+4. **Decide what's next** — apply the `rice-prioritisation` skill to rank the resulting opportunities into a defensible next step.
+
+Do not invent research findings — if interviews haven't happened, say so and produce the structure to capture them. End with a 4-bullet **"What you now have"** recap.

package/commands/ship-a-feature.md

@@ -0,0 +1,18 @@
+---
+description: Workflow recipe — take a feature idea from fuzzy brief to launch plan by chaining 5 skills.
+argument-hint: [the feature idea or problem]
+---
+
+Run the **Ship a Feature** workflow recipe for: $ARGUMENTS
+
+This is a *chain* of skills. Run each stage in order and **carry every stage's output forward as context** for the next — that shared context is the whole point. Open with a one-line plan of the 5 stages, then ask once for any essential missing inputs (target user, the problem, a rough success metric). Don't re-ask between stages.
+
+Run each stage under a clear `## Stage N — <name>` heading:
+
+1. **Frame the problem** — apply the `ambiguity-resolver` skill to turn the raw idea into a sharp problem statement and scoped boundaries.
+2. **Spec it** — apply the `prd-template` skill, using the framed problem, to produce a PRD with goals/non-goals, requirements, and success metrics.
+3. **Prioritise it** — apply the `rice-prioritisation` skill to score this work (reach, impact, confidence, effort) so its priority is defensible.
+4. **Place it on the roadmap** — apply the `roadmap-narrative` skill to position the work and tell the story around it.
+5. **Plan the launch** — apply the `go-to-market` skill to produce audience, messaging, channels, and a launch timeline.
+
+Do not invent metrics, dates, or facts — note assumptions instead. After the last stage, end with a 5-bullet **"What you now have"** recap linking each artifact to the stage that produced it.

package/exports/aider/README.md

@@ -95,7 +95,7 @@
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/job-description-writer.md` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/job-story-mapper.md` |
 | Last 30 Days Research | `pm-cross` | `pm-cross/last-30-days-research/last-30-days-research.md` |
-| Launch Readiness | `other` | `other/launch-readiness/launch-readiness.md` |
+| Launch Readiness | `pm-delivery` | `pm-delivery/launch-readiness/launch-readiness.md` |
 | Legal Brief | `pm-legal` | `pm-legal/legal-brief/legal-brief.md` |
 | Literature Review | `pm-research` | `pm-research/literature-review/literature-review.md` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/load-testing-plan.md` |
@@ -148,7 +148,7 @@
 | Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/security-threat-model.md` |
 | SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/seo-content-brief.md` |
 | Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/service-catalog-entry.md` |
-| Skill Security Auditor | `other` | `other/skill-security-auditor/skill-security-auditor.md` |
+| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/skill-security-auditor.md` |
 | SLO and Error Budget | `pm-engineering` | `pm-engineering/slo-error-budget/slo-error-budget.md` |
 | Social Ad Campaign | `pm-social` | `pm-social/social-ad-campaign/social-ad-campaign.md` |
 | Social Media Audit | `pm-social` | `pm-social/social-media-audit/social-media-audit.md` |
@@ -180,4 +180,4 @@
 | Vendor Evaluation | `pm-operations` | `pm-operations/vendor-evaluation/vendor-evaluation.md` |
 | Viral Content Framework | `pm-social` | `pm-social/viral-content-framework/viral-content-framework.md` |
 | Workshop Facilitation Guide | `pm-operations` | `pm-operations/workshop-facilitation-guide/workshop-facilitation-guide.md` |
-| YouTube Script Writer | `other` | `other/youtube-script-writer/youtube-script-writer.md` |
+| YouTube Script Writer | `pm-writers` | `pm-writers/youtube-script-writer/youtube-script-writer.md` |

package/exports/chatgpt/README.md

@@ -95,7 +95,7 @@
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/SYSTEM_PROMPT.md` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/SYSTEM_PROMPT.md` |
 | Last 30 Days Research | `pm-cross` | `pm-cross/last-30-days-research/SYSTEM_PROMPT.md` |
-| Launch Readiness | `other` | `other/launch-readiness/SYSTEM_PROMPT.md` |
+| Launch Readiness | `pm-delivery` | `pm-delivery/launch-readiness/SYSTEM_PROMPT.md` |
 | Legal Brief | `pm-legal` | `pm-legal/legal-brief/SYSTEM_PROMPT.md` |
 | Literature Review | `pm-research` | `pm-research/literature-review/SYSTEM_PROMPT.md` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/SYSTEM_PROMPT.md` |
@@ -148,7 +148,7 @@
 | Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/SYSTEM_PROMPT.md` |
 | SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/SYSTEM_PROMPT.md` |
 | Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/SYSTEM_PROMPT.md` |
-| Skill Security Auditor | `other` | `other/skill-security-auditor/SYSTEM_PROMPT.md` |
+| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/SYSTEM_PROMPT.md` |
 | SLO and Error Budget | `pm-engineering` | `pm-engineering/slo-error-budget/SYSTEM_PROMPT.md` |
 | Social Ad Campaign | `pm-social` | `pm-social/social-ad-campaign/SYSTEM_PROMPT.md` |
 | Social Media Audit | `pm-social` | `pm-social/social-media-audit/SYSTEM_PROMPT.md` |
@@ -180,4 +180,4 @@
 | Vendor Evaluation | `pm-operations` | `pm-operations/vendor-evaluation/SYSTEM_PROMPT.md` |
 | Viral Content Framework | `pm-social` | `pm-social/viral-content-framework/SYSTEM_PROMPT.md` |
 | Workshop Facilitation Guide | `pm-operations` | `pm-operations/workshop-facilitation-guide/SYSTEM_PROMPT.md` |
-| YouTube Script Writer | `other` | `other/youtube-script-writer/SYSTEM_PROMPT.md` |
+| YouTube Script Writer | `pm-writers` | `pm-writers/youtube-script-writer/SYSTEM_PROMPT.md` |

package/exports/cursor/README.md

@@ -95,7 +95,7 @@
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/job-description-writer.mdc` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/job-story-mapper.mdc` |
 | Last 30 Days Research | `pm-cross` | `pm-cross/last-30-days-research/last-30-days-research.mdc` |
-| Launch Readiness | `other` | `other/launch-readiness/launch-readiness.mdc` |
+| Launch Readiness | `pm-delivery` | `pm-delivery/launch-readiness/launch-readiness.mdc` |
 | Legal Brief | `pm-legal` | `pm-legal/legal-brief/legal-brief.mdc` |
 | Literature Review | `pm-research` | `pm-research/literature-review/literature-review.mdc` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/load-testing-plan.mdc` |
@@ -148,7 +148,7 @@
 | Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/security-threat-model.mdc` |
 | SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/seo-content-brief.mdc` |
 | Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/service-catalog-entry.mdc` |
-| Skill Security Auditor | `other` | `other/skill-security-auditor/skill-security-auditor.mdc` |
+| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/skill-security-auditor.mdc` |
 | SLO and Error Budget | `pm-engineering` | `pm-engineering/slo-error-budget/slo-error-budget.mdc` |
 | Social Ad Campaign | `pm-social` | `pm-social/social-ad-campaign/social-ad-campaign.mdc` |
 | Social Media Audit | `pm-social` | `pm-social/social-media-audit/social-media-audit.mdc` |
@@ -180,4 +180,4 @@
 | Vendor Evaluation | `pm-operations` | `pm-operations/vendor-evaluation/vendor-evaluation.mdc` |
 | Viral Content Framework | `pm-social` | `pm-social/viral-content-framework/viral-content-framework.mdc` |
 | Workshop Facilitation Guide | `pm-operations` | `pm-operations/workshop-facilitation-guide/workshop-facilitation-guide.mdc` |
-| YouTube Script Writer | `other` | `other/youtube-script-writer/youtube-script-writer.mdc` |
+| YouTube Script Writer | `pm-writers` | `pm-writers/youtube-script-writer/youtube-script-writer.mdc` |

package/exports/gemini/README.md

@@ -95,7 +95,7 @@
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/GEM_INSTRUCTIONS.md` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/GEM_INSTRUCTIONS.md` |
 | Last 30 Days Research | `pm-cross` | `pm-cross/last-30-days-research/GEM_INSTRUCTIONS.md` |
-| Launch Readiness | `other` | `other/launch-readiness/GEM_INSTRUCTIONS.md` |
+| Launch Readiness | `pm-delivery` | `pm-delivery/launch-readiness/GEM_INSTRUCTIONS.md` |
 | Legal Brief | `pm-legal` | `pm-legal/legal-brief/GEM_INSTRUCTIONS.md` |
 | Literature Review | `pm-research` | `pm-research/literature-review/GEM_INSTRUCTIONS.md` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/GEM_INSTRUCTIONS.md` |
@@ -148,7 +148,7 @@
 | Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/GEM_INSTRUCTIONS.md` |
 | SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/GEM_INSTRUCTIONS.md` |
 | Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/GEM_INSTRUCTIONS.md` |
-| Skill Security Auditor | `other` | `other/skill-security-auditor/GEM_INSTRUCTIONS.md` |
+| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/GEM_INSTRUCTIONS.md` |
 | SLO and Error Budget | `pm-engineering` | `pm-engineering/slo-error-budget/GEM_INSTRUCTIONS.md` |
 | Social Ad Campaign | `pm-social` | `pm-social/social-ad-campaign/GEM_INSTRUCTIONS.md` |
 | Social Media Audit | `pm-social` | `pm-social/social-media-audit/GEM_INSTRUCTIONS.md` |
@@ -180,4 +180,4 @@
 | Vendor Evaluation | `pm-operations` | `pm-operations/vendor-evaluation/GEM_INSTRUCTIONS.md` |
 | Viral Content Framework | `pm-social` | `pm-social/viral-content-framework/GEM_INSTRUCTIONS.md` |
 | Workshop Facilitation Guide | `pm-operations` | `pm-operations/workshop-facilitation-guide/GEM_INSTRUCTIONS.md` |
-| YouTube Script Writer | `other` | `other/youtube-script-writer/GEM_INSTRUCTIONS.md` |
+| YouTube Script Writer | `pm-writers` | `pm-writers/youtube-script-writer/GEM_INSTRUCTIONS.md` |

package/exports/windsurf/README.md

@@ -95,7 +95,7 @@
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/job-description-writer.md` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/job-story-mapper.md` |
 | Last 30 Days Research | `pm-cross` | `pm-cross/last-30-days-research/last-30-days-research.md` |
-| Launch Readiness | `other` | `other/launch-readiness/launch-readiness.md` |
+| Launch Readiness | `pm-delivery` | `pm-delivery/launch-readiness/launch-readiness.md` |
 | Legal Brief | `pm-legal` | `pm-legal/legal-brief/legal-brief.md` |
 | Literature Review | `pm-research` | `pm-research/literature-review/literature-review.md` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/load-testing-plan.md` |
@@ -148,7 +148,7 @@
 | Security Threat Model | `pm-engineering` | `pm-engineering/security-threat-model/security-threat-model.md` |
 | SEO Content Brief | `pm-gtm` | `pm-gtm/seo-content-brief/seo-content-brief.md` |
 | Service Catalog Entry | `pm-engineering` | `pm-engineering/service-catalog-entry/service-catalog-entry.md` |
-| Skill Security Auditor | `other` | `other/skill-security-auditor/skill-security-auditor.md` |
+| Skill Security Auditor | `pm-engineering` | `pm-engineering/skill-security-auditor/skill-security-auditor.md` |
 | SLO and Error Budget | `pm-engineering` | `pm-engineering/slo-error-budget/slo-error-budget.md` |
 | Social Ad Campaign | `pm-social` | `pm-social/social-ad-campaign/social-ad-campaign.md` |
 | Social Media Audit | `pm-social` | `pm-social/social-media-audit/social-media-audit.md` |
@@ -180,4 +180,4 @@
 | Vendor Evaluation | `pm-operations` | `pm-operations/vendor-evaluation/vendor-evaluation.md` |
 | Viral Content Framework | `pm-social` | `pm-social/viral-content-framework/viral-content-framework.md` |
 | Workshop Facilitation Guide | `pm-operations` | `pm-operations/workshop-facilitation-guide/workshop-facilitation-guide.md` |
-| YouTube Script Writer | `other` | `other/youtube-script-writer/youtube-script-writer.md` |
+| YouTube Script Writer | `pm-writers` | `pm-writers/youtube-script-writer/youtube-script-writer.md` |

package/mcp/README.md

@@ -1,6 +1,14 @@
 # MCP Server
 
-A zero-dependency [Model Context Protocol](https://modelcontextprotocol.io) server that exposes this skill library to any MCP client (Claude Desktop, Cline, etc.). Instead of installing 172 files, your assistant can **search and pull skills on demand**.
+A zero-dependency [Model Context Protocol](https://modelcontextprotocol.io) server that exposes this skill library to **any MCP client** (Claude Code, Claude Desktop, Cursor, Windsurf, Cline…). Instead of installing 174 files, your assistant can **search and pull skills — and run workflow recipes — on demand**.
+
+## One-line install (Claude Code)
+
+```bash
+claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
+```
+
+That's it — all 174 skills and 5 workflow recipes are now available in every Claude Code session, on any project.
 
 ## Tools
 
@@ -9,6 +17,8 @@ A zero-dependency [Model Context Protocol](https://modelcontextprotocol.io) serv
 | `list_skills` | List every skill (name, tier, one-line description). Optional `tier` filter. |
 | `search_skills` | Keyword search across name, description, and body — returns the best matches. |
 | `get_skill` | Return the full instructions for one skill by name, ready to apply. |
+| `list_workflows` | List workflow recipes — named chains of skills (e.g. ship-a-feature). |
+| `get_workflow` | Return one recipe: the ordered skills to run and what each produces. |
 
 ## Configure it
 
@@ -25,6 +35,8 @@ A zero-dependency [Model Context Protocol](https://modelcontextprotocol.io) serv
 }
 ```
 
+**Cursor / Windsurf / Cline** — add the same `mcpServers` block to the client's MCP config (`~/.cursor/mcp.json`, Windsurf settings, etc.).
+
 **From a local clone** (no npm install):
 
 ```json
@@ -38,7 +50,7 @@ A zero-dependency [Model Context Protocol](https://modelcontextprotocol.io) serv
 }
 ```
 
-Restart the client. Then ask it to *"search the skills for customer churn"* or *"get the rice-prioritisation skill and apply it to my backlog"* — it calls the tools automatically.
+Restart the client. Then ask it to *"search the skills for customer churn"*, *"get the rice-prioritisation skill and apply it to my backlog"*, or *"run the ship-a-feature workflow for a referral program"* — it calls the tools automatically.
 
 ## How it works
 

package/mcp/server.mjs

@@ -71,6 +71,15 @@ function loadSkills() {
 const SKILLS = loadSkills();
 const byName = new Map(SKILLS.map((s) => [s.name, s]));
 
+// Workflow recipes (chains of skills). Optional — absent in older installs.
+function loadWorkflows() {
+  const f = join(PKG_ROOT, 'workflows.json');
+  if (!existsSync(f)) return [];
+  try { return JSON.parse(readFileSync(f, 'utf8')).workflows || []; } catch { return []; }
+}
+const WORKFLOWS = loadWorkflows();
+const wfById = new Map(WORKFLOWS.map((w) => [w.id, w]));
+
 // ── Tools ───────────────────────────────────────────────────────────────────
 const TOOLS = [
   {
@@ -95,6 +104,16 @@ const TOOLS = [
     description: 'Get the full instructions (the SKILL.md body) for one skill by name. Apply these instructions to the user\'s task.',
     inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'The exact skill name, e.g. "rice-prioritisation".' } }, required: ['name'] },
   },
+  {
+    name: 'list_workflows',
+    description: 'List workflow recipes — named chains that run several skills in sequence, passing each output forward (e.g. ship-a-feature, close-the-quarter). Use when a task spans multiple steps end to end.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'get_workflow',
+    description: 'Get one workflow recipe by id: the ordered list of skills to run and what each produces. Run each step in order with get_skill, carrying every output forward as context for the next.',
+    inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'The workflow id, e.g. "ship-a-feature".' } }, required: ['id'] },
+  },
 ];
 
 function runTool(name, args = {}) {
@@ -125,6 +144,20 @@ function runTool(name, args = {}) {
     if (!s) throw new Error(`Unknown skill "${args.name}". Use search_skills or list_skills to find one.`);
     return s.body;
   }
+  if (name === 'list_workflows') {
+    if (!WORKFLOWS.length) return 'No workflow recipes are available in this install.';
+    return WORKFLOWS.map((w) =>
+      `- ${w.id} (${w.lifecycle}) — ${w.summary}\n    chain: ${w.steps.map((s) => s.skill).join(' → ')}`
+    ).join('\n');
+  }
+  if (name === 'get_workflow') {
+    const w = wfById.get(String(args.id || '').trim());
+    if (!w) throw new Error(`Unknown workflow "${args.id}". Use list_workflows to see available recipes.`);
+    const steps = w.steps.map((s, i) =>
+      `${i + 1}. get_skill("${s.skill}") → produces ${s.produces}.${s.passes ? ` Pass forward: ${s.passes}.` : ''}`
+    ).join('\n');
+    return `Workflow: ${w.name} (${w.lifecycle})\n${w.summary}\n\nRun these in order, carrying each output forward as context for the next:\n${steps}`;
+  }
   throw new Error(`Unknown tool: ${name}`);
 }
 
@@ -165,7 +198,7 @@ function handle(msg) {
   }
 }
 
-process.stderr.write(`[${SERVER_NAME}] MCP server ready — ${SKILLS.length} skills, ${TOOLS.length} tools.\n`);
+process.stderr.write(`[${SERVER_NAME}] MCP server ready — ${SKILLS.length} skills, ${WORKFLOWS.length} workflow recipes, ${TOOLS.length} tools.\n`);
 process.stderr.write(`[${SERVER_NAME}] ⭐ Star the repo: https://github.com/mohitagw15856/pm-claude-skills\n`);
 const rl = createInterface({ input: process.stdin });
 rl.on('line', (line) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-claude-skills",
-  "version": "20.2.0",
+  "version": "21.0.0",
   "type": "module",
   "description": "174 professional Agent Skills (SKILL.md) + subagents + slash commands for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes. Install into any AI coding tool with: npx pm-claude-skills add --agent <tool>.",
   "keywords": [
@@ -46,14 +46,18 @@
     "commands/",
     "output-styles/",
     "exports/",
-    "skill-tiers.json"
+    "skill-tiers.json",
+    "workflows.json"
   ],
   "scripts": {
     "new-skill": "node scripts/new-skill.mjs",
     "skillcheck": "node scripts/skillcheck.mjs",
     "build:exports": "node scripts/build-exports.mjs",
     "build:web": "node web/build-skills.mjs",
-    "check": "node scripts/skillcheck.mjs && node scripts/build-exports.mjs --check && node web/build-skills.mjs && git diff --exit-code -- web/skills.json"
+    "build:workflows": "node scripts/build-workflows.mjs",
+    "build:samples": "node scripts/build-samples.mjs",
+    "skill-of-the-week": "node scripts/skill-of-the-week.mjs",
+    "check": "node scripts/skillcheck.mjs && node scripts/build-exports.mjs --check && node scripts/build-workflows.mjs --check && node web/build-skills.mjs && node scripts/build-samples.mjs && git diff --exit-code -- web/skills.json web/samples.json"
   },
   "engines": {
     "node": ">=18"

package/workflows.json

@@ -0,0 +1,72 @@
+{
+  "_comment": "Workflow recipes — composite chains that run several skills in sequence, passing each output forward as context for the next. Single source of truth: consumed by the slash commands (commands/<command>.md), the MCP server (list_workflows/get_workflow), and WORKFLOWS.md. Each step names an existing skill in skills/<skill>/SKILL.md.",
+  "workflows": [
+    {
+      "id": "ship-a-feature",
+      "command": "/ship-a-feature",
+      "name": "Ship a Feature",
+      "lifecycle": "Discover → Decide → Build → Ship",
+      "summary": "Take a raw feature idea from fuzzy brief all the way to a launch plan, end to end.",
+      "steps": [
+        { "skill": "ambiguity-resolver", "produces": "a sharp problem statement and scoped boundaries", "passes": "the framed problem" },
+        { "skill": "prd-template", "produces": "a full PRD with goals, requirements, and success metrics", "passes": "the PRD scope and metrics" },
+        { "skill": "rice-prioritisation", "produces": "a RICE score positioning this work against alternatives", "passes": "the priority and confidence" },
+        { "skill": "roadmap-narrative", "produces": "where this sits on the roadmap and the story around it", "passes": "the roadmap framing" },
+        { "skill": "go-to-market", "produces": "a launch plan: audience, messaging, channels, and timeline", "passes": null }
+      ]
+    },
+    {
+      "id": "close-the-quarter",
+      "command": "/close-the-quarter",
+      "name": "Close the Quarter",
+      "lifecycle": "Measure → Communicate",
+      "summary": "Turn the quarter's raw numbers into a leadership-ready story and board deck.",
+      "steps": [
+        { "skill": "metrics-framework", "produces": "the metric tree and what actually moved", "passes": "the key metric movements" },
+        { "skill": "churn-analysis", "produces": "why customers left and what is avoidable", "passes": "the retention findings" },
+        { "skill": "executive-update", "produces": "a tight leadership briefing of the quarter", "passes": "the headline narrative" },
+        { "skill": "board-deck-narrative", "produces": "a slide-by-slide board deck storyline", "passes": null }
+      ]
+    },
+    {
+      "id": "launch-a-product",
+      "command": "/launch-a-product",
+      "name": "Launch a Product",
+      "lifecycle": "Decide → Ship",
+      "summary": "Go from competitive landscape to positioning to a fully checklisted launch and press release.",
+      "steps": [
+        { "skill": "competitor-teardown", "produces": "the competitive map and gaps to exploit", "passes": "the positioning opportunity" },
+        { "skill": "product-positioning-doc", "produces": "positioning, value props, and messaging pillars", "passes": "the approved messaging" },
+        { "skill": "go-to-market", "produces": "the GTM plan across audience and channels", "passes": "the launch plan" },
+        { "skill": "product-launch-checklist", "produces": "an owner-by-owner launch readiness checklist", "passes": "the launch date and scope" },
+        { "skill": "press-release", "produces": "the announcement press release", "passes": null }
+      ]
+    },
+    {
+      "id": "rescue-an-account",
+      "command": "/rescue-an-account",
+      "name": "Rescue an Account",
+      "lifecycle": "Measure → Communicate",
+      "summary": "Diagnose an at-risk customer and build the full save play through to renewal.",
+      "steps": [
+        { "skill": "cs-health-scorecard", "produces": "a health score with the specific risk drivers", "passes": "the risk profile" },
+        { "skill": "churn-analysis", "produces": "the root cause and whether the risk is avoidable", "passes": "the diagnosis" },
+        { "skill": "cs-escalation-brief", "produces": "an internal escalation brief for the save", "passes": "the resolution plan" },
+        { "skill": "renewal-playbook", "produces": "the renewal strategy and negotiation plan", "passes": null }
+      ]
+    },
+    {
+      "id": "run-discovery",
+      "command": "/run-discovery",
+      "name": "Run Discovery",
+      "lifecycle": "Discover → Decide",
+      "summary": "From a vague opportunity to validated insight and a prioritised next step.",
+      "steps": [
+        { "skill": "ambiguity-resolver", "produces": "a one-page problem brief from the fuzzy opportunity", "passes": "the scoped question" },
+        { "skill": "discovery-interview-guide", "produces": "a screener and discussion guide for user interviews", "passes": "the research focus" },
+        { "skill": "user-research-synthesis", "produces": "themes and insights from the research", "passes": "the validated insights" },
+        { "skill": "rice-prioritisation", "produces": "a ranked, defensible list of what to do next", "passes": null }
+      ]
+    }
+  ]
+}