pm-claude-skills 29.2.0 → 29.3.0

package/README.md

@@ -4,7 +4,7 @@
   </a>
 </p>
 
-# 🧠 PM Skills — 232 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
+# 🧠 PM Skills — 238 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
 
 [![Stars](https://img.shields.io/github/stars/mohitagw15856/pm-claude-skills?style=social)](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
 [![npm](https://img.shields.io/npm/v/pm-claude-skills?logo=npm&color=cb3837)](https://www.npmjs.com/package/pm-claude-skills)
@@ -14,7 +14,7 @@
 [![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)
 [![Remote MCP](https://img.shields.io/badge/ChatGPT%20%C2%B7%20Claude.ai-connector-10A37F)](mcp-remote/)
 [![Smithery](https://smithery.ai/badge/mohit15856/pm-skills)](https://smithery.ai/servers/mohit15856/pm-skills)
-[![Skills](https://img.shields.io/badge/skills-232-blue)](https://github.com/mohitagw15856/pm-claude-skills)
+[![Skills](https://img.shields.io/badge/skills-238-blue)](https://github.com/mohitagw15856/pm-claude-skills)
 [![eval](https://img.shields.io/badge/eval--scored-196%20%C2%B7%20avg%204.8%2F5-brightgreen)](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
 [![Subagents](https://img.shields.io/badge/subagents-4-blueviolet)](agents/)
 [![Commands](https://img.shields.io/badge/slash%20commands-6-blueviolet)](commands/)
@@ -30,7 +30,7 @@
 
 <p align="center">
   <a href="https://mohitagw15856.github.io/pm-claude-skills/">
-    <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=232+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
+    <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=238+pro+AI+skills;PRDs%2C+roadmaps%2C+launches+%E2%80%94+done+right;Run+any+one+free+in+your+browser" alt="PM Skills" />
   </a>
 </p>
 
@@ -40,12 +40,22 @@
 
 ### ⭐ If this saves you time, [star the repo](https://github.com/mohitagw15856/pm-claude-skills) — it's the #1 way to help others find it.
 
+## ⚡ Use it in 30 seconds — pick one
+
+| You want to… | Do this |
+|---|---|
+| **Just try it** (no install) | Open the **[Playground](https://mohitagw15856.github.io/pm-claude-skills/)** → pick a skill → run it in your browser. |
+| **Use it in Claude Code / Cursor / Codex** | `npx pm-claude-skills add --agent claude` &nbsp;*(or `cursor`, `codex`, `windsurf`…)* |
+| **Have it in every AI session** | `claude mcp add pm-skills -- npx -y pm-claude-skills-mcp` |
+
+*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`.
+
 > **PM stands for Professional, not just Product Management.**
-> 232 professional skills + 4 agent templates across 31 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
+> 238 professional skills + 4 agent templates across 32 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
 
 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).
 
-**🆕 Latest — v29.2.0 (Compliance pack + C-suite + Personas):** a new **[Compliance & Trust](PERSONAS.md) bundle** for regulated/enterprise teams — `soc2-readiness`, `gdpr-compliance`, `hipaa-safeguards`, `iso-27001-isms`, `vendor-security-review`, `data-retention-policy` — and here's the twist: **every one ships a stdlib scoring script** (computed readiness, not vibes). Plus a **C-suite decision pack** (`decision-memo`, `strategy-memo`, `board-pre-read`, `capital-allocation`) and **[curated role Personas](PERSONAS.md)** — each role gets a skill loadout + a recipe + a subagent. **232 skills across 31 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
+**🆕 Latest — v29.3.0 (run skills from the terminal + a Career pack):** the CLI can now **run** any skill headless — `cat notes.txt | npx pm-claude-skills run meeting-notes --out summary.md` — so every skill is scriptable and CI-usable, not just installable or browser-only. Plus a new **Career & Growth bundle** (`brag-doc`, `self-review`, `promotion-packet`, `one-on-one-prep`, `career-ladder-map`, `salary-negotiation` with a total-comp comparison script). *Earlier (v29.2):* a **Compliance & Trust** bundle (SOC 2, GDPR, HIPAA, ISO 27001 — each with a scoring script), a **C-suite decision pack**, and **[role Personas](PERSONAS.md)**. **238 skills across 32 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
 
 ### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
 
@@ -74,17 +84,20 @@ A community-built library of professional skills for every field — product man
 | 🔭 [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 232 skills](#️-all-232-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
+→ 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 238 skills](#️-all-238-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
 
 ---
 
 ## 📄 One-page cheatsheet
 
-The whole library on one page — install, all 232 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
+<details>
+<summary>Read more ↓</summary>
+
+The whole library on one page — install, all 238 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
 
 <p align="center">
   <a href="CHEATSHEET.md">
-    <img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills one-page cheatsheet — 232 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
+    <img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills one-page cheatsheet — 238 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
   </a>
 </p>
 
@@ -94,6 +107,8 @@ The whole library on one page — install, all 232 skills by profession, the Pro
 > example-driven manual — install → your first skill → worked examples (PRD, exec update, RICE,
 > postmortem) → chaining recipes → the Brain → running anywhere → tips. **[Download the PDF →](web/docs-assets/PM-Skills-Guide.pdf)**
 
+</details>
+
 ---
 
 ## 🧠 The Professional Brain — local-first memory for any AI agent
@@ -110,13 +125,16 @@ Generic AI forgets everything between sessions, so you re-paste context forever
 
 ## 🔄 One library, the whole professional workflow
 
-These 232 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:
+<details>
+<summary>Read more ↓</summary>
+
+These 238 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:
 
 ```mermaid
 flowchart LR
     A(["🔍 Discover"]) --> B(["🎯 Decide"]) --> C(["🔨 Build"]) --> D(["🚀 Ship"]) --> E(["📊 Measure"]) --> F(["📣 Communicate"])
     F -. "feeds the next discovery" .-> A
-    classDef s fill:#1d232b,stroke:#d97757,color:#e7ebf0;
+    classDef s fill:#1d238b,stroke:#d97757,color:#e7ebf0;
     class A,B,C,D,E,F s;
 ```
 
@@ -129,12 +147,17 @@ flowchart LR
 | **📊 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 232 skills**](#️-all-232-skills) grouped by profession.
+> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 238 skills**](#️-all-238-skills) grouped by profession.
+
+</details>
 
 ---
 
 ## 🧩 Workflow Recipes — chain skills into one flow
 
+<details>
+<summary>Read more ↓</summary>
+
 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.
 
 ```
@@ -163,10 +186,15 @@ Individual skills are great. **Chaining** them is the superpower. A *recipe* run
 
 [![Workflow Canvas — drag skills into a chain and run it, each step feeding the next](web/docs-assets/canvas-demo.gif)](https://mohitagw15856.github.io/pm-claude-skills/canvas.html)
 
+</details>
+
 ---
 
 ## 🧠 Skill Memory — set your context once, every skill uses it
 
+<details>
+<summary>Read more ↓</summary>
+
 Generic output is the #1 complaint with AI. **Skill Memory** fixes it: tell the skills who you are *once*, and every skill and recipe produces output already tuned to your product, audience, and voice — no re-typing.
 
 - **In Claude Code:** run [`/setup-context`](commands/setup-context.md) (or copy [`templates/pm-context.example.md`](templates/pm-context.example.md) → `pm-context.md`). Skills read it as standing context.
@@ -178,10 +206,15 @@ With context:      "write an exec update" → your voice, your metrics,
                     your audience — shippable on the first try
 ```
 
+</details>
+
 ---
 
 ## 🤖 Run a skill from a GitHub comment (ChatOps)
 
+<details>
+<summary>Read more ↓</summary>
+
 This repo ships a [**Skill Bot**](.github/workflows/skill-bot.yml): comment on any issue or PR and a skill runs and replies inline.
 
 ```
@@ -191,10 +224,15 @@ Audience: CEO. Period: Q2. Shipped onboarding redesign; activation up; hiring be
 
 The bot runs the skill and posts the result as a reply. `/skill list` shows usage. It's gated to repo collaborators (so random commenters can't trigger paid API calls) and needs an `ANTHROPIC_API_KEY` secret. Copy the workflow into your own repo to give your whole team skill-powered ChatOps.
 
+</details>
+
 ---
 
 ## ✅ Eval-verified quality — not just quantity
 
+<details>
+<summary>Read more ↓</summary>
+
 **Grounded in canonical frameworks.** These aren't invented prompts — each skill encodes a proven method and cites it: RICE (Intercom), Jobs-to-be-Done (Christensen), Continuous Discovery (Teresa Torres), Porter's Five Forces, the Pyramid Principle (Minto), Google SRE, WCAG, *Obviously Awesome* (April Dunford), and more. The source shows as a **"📚 Based on"** line on every [skill page](https://mohitagw15856.github.io/pm-claude-skills/skill/rice-prioritisation.html) and in the Playground.
 
 **And measured, not just claimed.** 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. **15 skills are eval-scored** today (and climbing); the rest are reviewed against the [authoring standard](SKILL-AUTHORING-STANDARD.md). A **[regression gate](.github/workflows/skill-pr-check.yml)** then blocks any PR that drops a skill's score, so quality can't quietly rot as models change.
@@ -219,15 +257,20 @@ That's not luck — it's a [self-improving pipeline](scripts/improve-skill.mjs)
 
 This whole thing is an open, reproducible **[benchmark for AI professional work](https://mohitagw15856.github.io/pm-claude-skills/benchmark.html)** — and it's *eval-gated*: every contributed skill is auto-checked for structure and scored on the rubric. The easiest way to add one is **[Skill Studio](https://mohitagw15856.github.io/pm-claude-skills/studio.html)** — describe a skill in your browser, generate a compliant `SKILL.md`, and open a pull request in one click ([or use the form →](https://github.com/mohitagw15856/pm-claude-skills/issues/new?template=submit-skill.yml)).
 
+</details>
+
 ---
 
 ## ⚖️ How it compares
 
+<details>
+<summary>Read more ↓</summary>
+
 Most skill repos are a folder of prompts. This one is a **system** — measured, composable, and usable in the browser:
 
 | | **PM Skills** | Typical skill repo |
 |---|:---:|:---:|
-| Skills | **232**, across 23 professions | a handful → dozens, usually one domain |
+| Skills | **238**, across 23 professions | a handful → dozens, usually one domain |
 | Quality | **eval-scored** on a rubric + a public [benchmark](https://mohitagw15856.github.io/pm-claude-skills/benchmark.html) | trust the README |
 | Improves itself | ✅ eval → critique → rewrite (kept only if it scores higher) | ✗ |
 | Grounded in frameworks | ✅ each cites its source (RICE, JTBD, Pyramid Principle…) | rarely |
@@ -236,38 +279,29 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
 | Works beyond Claude | ✅ MCP · ChatGPT/Gemini exports · VS Code extension | usually one tool |
 | Community | ✅ per-skill discussions + a [hub](https://mohitagw15856.github.io/pm-claude-skills/community.html) | issues only |
 
----
-
-## 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)
-- [🧠 Skill Memory — set your context once](#-skill-memory--set-your-context-once-every-skill-uses-it)
-- [✅ 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)
-- [🌐 Skill Playground — try any skill in your browser](#-skill-playground--try-any-skill-in-your-browser)
-- [📦 Plugin Directory](#-plugin-directory)
-- [🤖 Building Blocks for Agent Templates](#-building-blocks-for-agent-templates)
-- [🏷️ Skill Tiers — start with the strongest](#️-skill-tiers--start-with-the-strongest)
-- [🗂️ All 232 Skills](#️-all-232-skills)
-- [📋 Changelog](#-changelog)
-- [🤝 Contributing](#-contributing--add-your-skill)
-- [🔗 Related Projects](#-related-projects)
+</details>
 
 ---
 
 ## 🚀 Quick Install (2 minutes)
 
-**With the [`skills`](https://github.com/vercel-labs/skills) CLI** (the open agent-skills installer that works across Claude Code, Cursor, Codex, OpenCode & 60+ agents) — pick from all 232 interactively:
+<details>
+<summary>Read more ↓</summary>
+
+> **Not sure where to start?** Pick by what you want:
+> - **Just try it (0 install):** open the **[live Playground](https://mohitagw15856.github.io/pm-claude-skills/)** and run any skill.
+> - **Use it in Claude Code:** `npx pm-claude-skills add --agent claude` (or the `/plugin` route below).
+> - **Have it in every session:** add the MCP server (one line, below).
+>
+> ⚠️ **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.
+
+**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 238 interactively:
 
 ```bash
 npx skills add mohitagw15856/pm-claude-skills            # browse & pick (auto-detects your agent)
 npx skills add mohitagw15856/pm-claude-skills --list     # just preview the catalog
 npx skills add mohitagw15856/pm-claude-skills --skill prd-template   # grab one
-npx skills add mohitagw15856/pm-claude-skills --skill '*'            # install all 232
+npx skills add mohitagw15856/pm-claude-skills --skill '*'            # install all 238
 ```
 
 **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:
@@ -276,7 +310,7 @@ npx skills add mohitagw15856/pm-claude-skills --skill '*'            # install a
 npx pm-claude-skills add --agent claude     # or: codex · cursor · hermes · openclaw
 ```
 
-**Or one-line MCP** — make all 232 skills + 5 workflow recipes available in *every* session of any MCP client (Claude Code, Claude Desktop, Cursor, Windsurf), no per-file install:
+**Or one-line MCP** — make all 238 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
@@ -322,18 +356,22 @@ claude plugin install pm-social@pm-claude-skills         # Social Media 🆕
 
 claude plugin install pm-writers@pm-claude-skills        # Writers & Content Creators 🆕
 
-
 Or clone and symlink for auto-updates:
 
 git clone https://github.com/mohitagw15856/pm-claude-skills.git ~/pm-claude-skills
 mkdir -p ~/.claude/skills
 ln -s ~/pm-claude-skills/skills/* ~/.claude/skills/
 
+</details>
+
 ---
 
 ## 🌍 Use It Anywhere — the AI Ecosystem
 
-The same 232 skills reach you through every channel — pick whatever fits your stack:
+<details>
+<summary>Read more ↓</summary>
+
+The same 238 skills reach you through every channel — pick whatever fits your stack:
 
 | Channel | Get it |
 |---|---|
@@ -347,14 +385,19 @@ The same 232 skills reach you through every channel — pick whatever fits your
 | 🖥️ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo** — [`exports/`](exports/) |
 | 🤖 **Agents & answer engines** | [`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt) makes the whole library discoverable & citable |
 
-> **196 of 232 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
+> **196 of 238 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
 
 > 🧠 **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)**.
 
+</details>
+
 ---
 
 ## 🔌 Works With — Cross-Tool Compatibility
 
+<details>
+<summary>Read more ↓</summary>
+
 These skills were built for Claude Code, but they aren't locked to it. Each `SKILL.md` is
 two portable parts: a small **frontmatter** block (`name` + `description`) and a
 **markdown body** that is just a well-structured set of instructions and output templates.
@@ -364,7 +407,7 @@ There are two kinds of support. **Native `SKILL.md` agents** read the file as-is
 auto-discover skills from the `description` frontmatter. **Other tools** take the markdown
 body as a system prompt — for those we ship ready-made [exports](#ready-to-use-exports).
 
-**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all 232 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
+**In your editor (VS Code / Cursor):** the [**`vscode-extension/`**](vscode-extension/) brings all 238 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
 
 | Platform | How it works | Auto-trigger? |
 |---|---|---|
@@ -434,10 +477,15 @@ node scripts/build-exports.mjs --check    # CI: fail if exports are stale
 
 > Prefer a hand-curated ChatGPT collection? There's also a [companion Custom GPT library](#-companion-repository--chatgpt-custom-gpts) built from the same frameworks.
 
+</details>
+
 ---
 
 ## 🤖 Subagents & Slash Commands
 
+<details>
+<summary>Read more ↓</summary>
+
 It's not just skills. The library also ships **Claude Code subagents** and **slash commands** built on top of the strongest skills, so common workflows are one delegation or one command away.
 
 **Subagents** ([`agents/`](agents/)) — focused personas Claude delegates to automatically by description:
@@ -465,10 +513,15 @@ npx pm-claude-skills add --agent claude   # ~/.claude/{skills,agents,commands,ou
 
 Commands whose skill ships a Python helper (RICE, sprint capacity, customer health) run it to **compute** results, not estimate them. To string these together, see the [orchestration patterns](ORCHESTRATION.md) (skill chains & multi-agent handoffs).
 
+</details>
+
 ---
 
 ## 🧩 MCP Server — Skills on Demand
 
+<details>
+<summary>Read more ↓</summary>
+
 For MCP clients (Claude Desktop, Cline, …), there's a zero-dependency [**MCP server**](mcp/) so your assistant **searches and pulls skills on demand** instead of installing 172 files. It exposes three tools — `list_skills`, `search_skills`, `get_skill` — over stdio (no network, nothing leaves your machine).
 
 ```json
@@ -485,10 +538,15 @@ Then ask: *"search the skills for customer churn, then apply the best one to my
 
 > `pm-skills` needs **no auth**. To connect GitHub, Slack, Notion, etc., you add *that* provider's MCP server with its own token/OAuth **once** in your client — then every skill can use it. (filesystem = a folder you grant; GitHub = a PAT; Slack/Notion = OAuth.)
 
+</details>
+
 ---
 
 ## ⚙️ AI-Powered Tooling
 
+<details>
+<summary>Read more ↓</summary>
+
 Three ways to put the library to work beyond installing files:
 
 **🤖 Run a skill in your CI — [GitHub Action](action/).** Auto-write PR descriptions, changelogs, release notes, or run a code-review checklist on every PR:
@@ -509,12 +567,17 @@ ANTHROPIC_API_KEY=sk-ant-… npx pm-claude-skills generate --from ./team-process
 
 **🏆 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)**
 
-> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all 232 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.
+> **Score the *whole* library, cheaply.** `npm run eval:gen-cases` writes a representative input for **all 238 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.
+
+</details>
 
 ---
 
 ## 🌐 Skill Playground — Try Any Skill in Your Browser
 
+<details>
+<summary>Read more ↓</summary>
+
 **▶ Live: [mohitagw15856.github.io/pm-claude-skills](https://mohitagw15856.github.io/pm-claude-skills/)** · 📚 [Browse the full skill catalog](https://mohitagw15856.github.io/pm-claude-skills/catalog.html)
 
 Don't want to install anything yet? Run any of these skills from a **zero-backend web app** using **your own Claude, OpenAI, or Gemini key**. Pick a provider, pick a skill, fill in the auto-generated form, and the result streams back live. Your key is stored only in your browser (`localStorage`) and sent **directly to the provider you chose** — nothing touches a server we own.
@@ -533,10 +596,15 @@ cd web && python3 -m http.server 8000   # serve over HTTP (not file://)
 
 It's fully static — deploy the `web/` folder to GitHub Pages, Netlify, or Vercel with no environment variables. Full details in [`web/README.md`](web/README.md).
 
+</details>
+
 ---
 
 ## 📦 Plugin Directory
 
+<details>
+<summary>Read more ↓</summary>
+
 Not sure which plugin to install? Here's what each one covers:
 
 | Plugin | Skills | Best for |
@@ -567,10 +635,15 @@ Not sure which plugin to install? Here's what each one covers:
 | **pm-strategy** | ambiguity-resolver, competitive-intelligence-monitor, competitor-signal-tracker, executive-update, stakeholder-influence-mapper, strategic-narrative-generator | Senior PM and strategic work — resolving ambiguity, tracking competitive signals, mapping stakeholder influence, writing executive updates, and building strategic narratives. |
 | **pm-writers** | aeo-optimizer, instagram-post-downloader, notes-humanizer, substack-notes-scraper, thumbnail-creator | For content creators and writers using Claude: optimising for AI search engines, humanising notes, scraping research from Substack, and generating thumbnail concepts. |
 
+</details>
+
 ---
 
 ## 🎬 See It in Action
 
+<details>
+<summary>Read more ↓</summary>
+
 **Debugging Log Analyser** — paste a stack trace or error log, get a structured root cause diagnosis with probable cause, affected code path, a specific fix, and next debugging steps.
 
 **PR Description Writer** — share your diff or commit list, get a reviewer-friendly PR description with summary, changes made, testing steps, and reviewer notes.
@@ -579,13 +652,18 @@ Not sure which plugin to install? Here's what each one covers:
 
 > 📹 Drop a demo in [Discussions](../../discussions) and we'll feature it here.
 
+</details>
+
 ---
 
 ## 🤖 Building Blocks for Agent Templates
 
+<details>
+<summary>Read more ↓</summary>
+
 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.
 
-This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The 232 skills here are the building blocks for agent templates outside of finance.**
+This library is the largest open-source collection of professional skills available — covering 20 professions beyond financial services. **The 238 skills here are the building blocks for agent templates outside of finance.**
 
 ### What is an agent template?
 
@@ -615,7 +693,6 @@ Examples of agent templates this library supports:
 | **Finance Board Pack Agent** | investor-update, board-deck-narrative, financial-model-narrative | NetSuite or Xero, Google Drive | KPI variance analyst |
 | **Marketing Launch Agent** | go-to-market, content-calendar, email-campaign, media-pitch | HubSpot, Notion | Channel strategist |
 
-
 ### Available agent templates
 
 The pm-claude-skills library now includes four working agent templates, each built from existing skills in this library combined with subagents and connectors. All four follow the architecture Anthropic introduced for [financial services agent templates](https://www.anthropic.com/news/finance-agents) on May 5, 2026.
@@ -640,39 +717,45 @@ All templates are part of the main library — installing the marketplace gives
 
 /plugin marketplace add mohitagw15856/pm-claude-skills
 
-
 Then navigate to the template you want and follow its README:
 
 cd templates/pm-sprint-agent      # or pm-discovery-agent, etc.
 cat README.md                       # full setup instructions
 
-
 ### Building your own template
 
 If you want to build a template for a workflow not covered above — Legal Contract Review, Sales Pursuit, Finance Board Pack, HR Onboarding, Marketing Campaign — see the [template contribution guide](./templates/CONTRIBUTING.md).
 
 The pattern is consistent: pick a multi-step workflow, identify which existing skills cover the structured outputs, add connectors for data access, and define subagents for specialised analysis. The four templates above are reference implementations.
 
-
 It combines four skills, two connectors, and two subagents into a single workflow that handles end-to-end sprint planning.
 
 Documentation, working orchestration script, and example outputs are included in the template folder.
 
 More templates will follow. If you want to contribute one, see the [template contribution guide](./templates/CONTRIBUTING.md).
 
+</details>
+
 ---
 
 ## 📋 Changelog
 
-**Latest: v29.1.0 — AI/ML + Growth skill packs, composable recipes, a deeper Brain.** 232 skills across 31 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
+<details>
+<summary>Read more ↓</summary>
+
+**Latest: v29.1.0 — AI/ML + Growth skill packs, composable recipes, a deeper Brain.** 238 skills across 32 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
 
 Full [Keep a Changelog](https://keepachangelog.com/)-format history — every release back to the start — is in **[CHANGELOG.md](CHANGELOG.md)**.
 
+</details>
 
 ---
 
 ## 📚 The Article Series
 
+<details>
+<summary>Read more ↓</summary>
+
 This repo was built alongside a published 16-part article series on Medium.
 
 <details>
@@ -699,11 +782,16 @@ This repo was built alongside a published 16-part article series on Medium.
 
 </details>
 
+</details>
+
 ---
 
 ## 🏷️ Skill Tiers — Start With the Strongest
 
-A 232-skill library doesn't have 232 equally-mature skills, and pretending otherwise
+<details>
+<summary>Read more ↓</summary>
+
+A 238-skill library doesn't have 238 equally-mature skills, and pretending otherwise
 wastes your time. Skills are tiered honestly so you can start with the best work:
 
 - 🟢 **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.**
@@ -714,9 +802,14 @@ wastes your time. Skills are tiered honestly so you can start with the best work
 
 If you're new, install `pm-essentials` and try a couple of Production-Ready skills before going wide.
 
+</details>
+
 ---
 
-## 🗂️ All 232 Skills
+## 🗂️ All 238 Skills
+
+<details>
+<summary>Read more ↓</summary>
 
 Every skill, grouped by profession. **[Browse the full per-skill catalog → SKILLS.md](SKILLS.md)** · **[searchable live catalog](https://mohitagw15856.github.io/pm-claude-skills/catalog.html)** · **[run any skill in the browser](https://mohitagw15856.github.io/pm-claude-skills/)**
 
@@ -746,11 +839,16 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
 
 > Full per-skill detail (folder paths, descriptions, "🆕" markers) lives in **[SKILLS.md](SKILLS.md)**.
 
+</details>
+
 ---
 
 ## ❤️ Sponsor This Work
 
-Building and maintaining 232 skills across 31 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
+<details>
+<summary>Read more ↓</summary>
+
+Building and maintaining 238 skills across 32 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
 
 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)).
 
@@ -765,10 +863,15 @@ Full details and where the money goes: **[SPONSORS.md](SPONSORS.md)**.
 
 **Our sponsors:** *be the [first](https://github.com/sponsors/mohitagw15856) — your logo goes right here.*
 
+</details>
+
 ---
 
 ## 🤝 Contributing — Add Your Skill
 
+<details>
+<summary>Read more ↓</summary>
+
 This is an open-source community library. If you've built a skill that saves you time, share it here.
 
 **New here?** See the [Roadmap & good first issues](ROADMAP.md#-good-first-issues) for starter tasks. **Found a bug?** [Open a bug report →](../../issues/new?template=bug-report.md).
@@ -793,7 +896,6 @@ description: "One sentence. Use when [trigger condition]. Produces [output descr
 
 [Instructions for Claude to follow when this skill is invoked]
 
-
 **What makes a good skill:**
 - Solves a recurring professional workflow (not a one-off task)
 - Has a clear trigger description so Claude knows when to activate it
@@ -816,10 +918,15 @@ Have a skill idea? Add it to [SKILL_REQUEST.md](SKILL_REQUEST.md), [open an issu
 
 **Contributors** get credited in this README and in the article series. 🙌
 
+</details>
+
 ---
 
 ## 📦 All Plugin Bundles
 
+<details>
+<summary>Read more ↓</summary>
+
 Install the whole library or just the bundles you need:
 
 # Install everything
@@ -876,20 +983,30 @@ claude plugin install pm-social@pm-claude-skills         # Social Media 🆕
 
 claude plugin install pm-writers@pm-claude-skills        # Writers & Content Creators 🆕
 
+</details>
+
 ---
 
 ## 🤖 Companion Repository — ChatGPT Custom GPTs
 
+<details>
+<summary>Read more ↓</summary>
+
 If you use ChatGPT instead of Claude Code, there's a companion repo with the same professional frameworks built as Custom GPT system prompts:
 
 **[professional-gpt-library](https://github.com/mohitagw15856/professional-gpt-library)** — 10 starter GPTs across 8 professions, MIT licence.
 
 Read the full breakdown: [Part 12 — I Built the Same Skills Library for ChatGPT](https://medium.com/product-powerhouse/i-built-the-same-skills-library-for-chatgpt-heres-what-s-different-a9305f9c20b9)
 
+</details>
+
 ---
 
 ## 🔗 Related Projects
 
+<details>
+<summary>Read more ↓</summary>
+
 Claude Skills is a fast-growing open ecosystem. If this library doesn't have what you
 need, these community projects are worth a look — and if you maintain one of the lists
 below, a reciprocal link is always welcome. 🙌
@@ -912,10 +1029,15 @@ below, a reciprocal link is always welcome. 🙌
 
 > Maintain a Claude Skills project and want to be listed here? [Open a PR](../../pulls) or an [issue](../../issues).
 
+</details>
+
 ---
 
 ## 🛠️ Custom Skills for Your Team
 
+<details>
+<summary>Read more ↓</summary>
+
 The 155 skills in this library are built for general professional workflows. But the most powerful version of Claude Skills is one built specifically for *your* team — your templates, your terminology, your processes, your quality standards.
 
 **What custom skills look like in practice:**
@@ -931,10 +1053,15 @@ The difference between a generic skill and one built for your context is signifi
 
 Include a brief description of your team, the workflows you want to automate, and the tools you use. I'll come back to you within 48 hours.
 
+</details>
+
 ---
 
 ## 📖 How Skills Work
 
+<details>
+<summary>Read more ↓</summary>
+
 Skills are markdown files that Claude reads dynamically. When you describe a task, Claude scans available skill descriptions (~100 tokens) and loads the full skill only when relevant. This means:
 
 - Skills are efficient — they only use tokens when triggered
@@ -944,10 +1071,15 @@ Skills are markdown files that Claude reads dynamically. When you describe a tas
 
 Learn more: [Anthropic's Skills documentation](https://code.claude.com/docs/en/skills)
 
+</details>
+
 ---
 
 ## ⭐ Star Milestones
 
+<details>
+<summary>Read more ↓</summary>
+
 Stars unlock the next wave of skills and features. We've hit every milestone so far — here's the track record, and what's next:
 
 | Milestone | Unlocks | Status |
@@ -971,3 +1103,7 @@ Want a specific skill built? [Vote or request in SKILL_REQUEST.md](SKILL_REQUEST
 ---
 
 *Built and maintained by [Mohit Aggarwal](https://medium.com/@mohit15856) | [Product Notes publication](https://medium.com/product-powerhouse) | [💖 Sponsor my work](https://github.com/sponsors/mohitagw15856)*
+
+</details>
+
+---