pm-claude-skills 28.3.0 → 29.0.0

package/README.md

@@ -45,7 +45,7 @@
 
 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 release (v28.1.0 — Integrations):** PM Skills now plugs into **[n8n](connectors/n8n.md)**, powers **[Lovable](connectors/lovable.md)** apps, and lives in your **[Obsidian](connectors/obsidian.md)** vault — all backed by a read-only **REST API** (`/v1`) on the hosted Worker, auto-deployed via GitHub Actions. *Previously (v28.0.0 — live across the whole AI ecosystem):* every channel is now shipped & public — **[`pip install pm-skills`](https://pypi.org/project/pm-skills/)** (LangChain/CrewAI), the **hosted MCP connector** `https://pm-skills-mcp.pm-claude-skills.workers.dev/` (add to **ChatGPT/Claude.ai/Cursor** by URL), and the **[official MCP registry](https://github.com/mohitagw15856/pm-claude-skills/blob/main/server.json)** listing. See the new **[🌍 Use It Anywhere](#-use-it-anywhere--the-ai-ecosystem)** section. Also: **multi-model playground** (run any skill with your own **Claude / OpenAI / Gemini / Ollama** key — local models included), a **[remote MCP connector](mcp-remote/)** (add PM Skills to **ChatGPT, Claude.ai & Cursor** with one URL — no install), the MCP server now exposes skills as **prompts + resources**, **4 new IDE targets** (Cline, Continue, Zed, Roo — 9 platforms total), a **[Python package](python/)** (`pip install pm-skills` → LangChain/CrewAI tools), an **[`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt)** for agent discovery, a reusable **[score-skills GitHub Action](.github/actions/score-skills/)**, and **MCP-registry manifests**. Plus the full library is now **eval-scored: 196 skills, avg 4.8/5**. **207 skills**. See the [changelog](#-changelog).
+**🆕 Latest release (v29.0.0 — Multilingual + a polished experience):** run any skill in **10 languages** (Spanish, Mandarin, Hindi, Arabic — with RTL — Portuguese, French, German, Japanese, Russian, Indonesian); the frameworks are universal, so the model localizes the whole output. Plus a **[15-page Practical Guide](web/guide.html)** and a **[one-page cheatsheet](CHEATSHEET.md)** (PDF/PNG), a **navigation + playground UX revamp** (a repo link from the playground, sticky nav, a redesigned home), and quality hardening — **[case studies](CASE_STUDIES.md)**, opt-in 👍/👎 feedback, and a CI **regression gate** that blocks score drops. *Earlier (v28.4 — run it free, no credit card):* the playground no longer needs a paid key to start. Use a **free Google AI Studio key** (no card, ~30 seconds) or pick **In-browser** to run a model with **no key at all** (WebLLM on WebGPU — fully private, nothing leaves your device), and every skill now shows a **pre-generated sample output** so you can see the value with zero setup. Plus the **[Professional Brain is now in the browser](https://mohitagw15856.github.io/pm-claude-skills/brain.html)** — a 🧠 Brain page that feeds your durable memory into every run and saves outcomes back. *Earlier (v28.3 — the Professional Brain):* skills gained a durable, local markdown **memory** they read before answering, **write back** to (provenance-tagged, approval-gated), and even **act on** (open tickets/post updates via `action-runner`, dry-run + approval). Set it up in 5 minutes — **[Quickstart](BRAIN_QUICKSTART.md)** · [architecture](BRAIN.md). *Recent integrations:* **[n8n](connectors/n8n.md)**, **[Lovable](connectors/lovable.md)**, **[Obsidian](connectors/obsidian.md)** + a read-only **REST API** (`/v1`) on the hosted Worker. *Earlier (v28.0):* every channel is now shipped & public — **[`pip install pm-skills`](https://pypi.org/project/pm-skills/)** (LangChain/CrewAI), the **hosted MCP connector** `https://pm-skills-mcp.pm-claude-skills.workers.dev/` (add to **ChatGPT/Claude.ai/Cursor** by URL), and the **[official MCP registry](https://github.com/mohitagw15856/pm-claude-skills/blob/main/server.json)** listing. See the new **[🌍 Use It Anywhere](#-use-it-anywhere--the-ai-ecosystem)** section. Also: **multi-model playground** (run any skill with your own **Claude / OpenAI / Gemini / Ollama** key — local models included), a **[remote MCP connector](mcp-remote/)** (add PM Skills to **ChatGPT, Claude.ai & Cursor** with one URL — no install), the MCP server now exposes skills as **prompts + resources**, **4 new IDE targets** (Cline, Continue, Zed, Roo — 9 platforms total), a **[Python package](python/)** (`pip install pm-skills` → LangChain/CrewAI tools), an **[`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt)** for agent discovery, a reusable **[score-skills GitHub Action](.github/actions/score-skills/)**, and **MCP-registry manifests**. Plus the full library is now **eval-scored: 196 skills, avg 4.8/5**. **207 skills**. See the [changelog](#-changelog).
 
 ### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
 
@@ -78,6 +78,36 @@ A community-built library of professional skills for every field — product man
 
 ---
 
+## 📄 One-page cheatsheet
+
+The whole library on one page — install, all 207 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 — 207 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
+  </a>
+</p>
+
+**[📥 Markdown](CHEATSHEET.md)** · **[🖼️ PNG](web/docs-assets/cheatsheet.png)** · **[📄 PDF](web/docs-assets/cheatsheet.pdf)** — regenerate the image/PDF with `node web/docs-assets/shoot.mjs` (`PAGES=cheatsheet`).
+
+> 📖 **Want the full walkthrough?** The **[Practical Guide](web/guide.html)** is a 15-page,
+> 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)**
+
+---
+
+## 🧠 The Professional Brain — local-first memory for any AI agent
+
+Generic AI forgets everything between sessions, so you re-paste context forever and last quarter's *why* evaporates. The **Professional Brain** is the fix — and it's the most novel piece here, worth a look on its own:
+
+- **Plain markdown, no vector DB** — a `brain/` folder (knowledge · decisions · hypotheses · stakeholders) your AI **reads before answering and writes to after**. Grep-able, auditable, Obsidian-compatible — memory you can read and correct by hand, not a black box.
+- **Provenance over confidence theatre** — every fact is tagged `[data] [interview] [external] [verbal] [hunch]`, so a hunch never poses as a measured result.
+- **It acts, safely** — the [`action-runner`](skills/action-runner/) turns a skill's recommendations into real tickets/messages: dry-run, risk-rated, approval-gated, then recorded back. *Nothing acts silently.*
+
+**→ [Read the architecture](BRAIN.md)** · **[5-min Quickstart](BRAIN_QUICKSTART.md)** · **[try it in the browser](https://mohitagw15856.github.io/pm-claude-skills/brain.html)**
+
+---
+
 ## 🔄 One library, the whole professional workflow
 
 These 207 skills aren't a random catalog — they cover the **full arc of professional work**, end to end. Wherever you are in the loop, there's a skill for it:
@@ -167,7 +197,9 @@ The bot runs the skill and posts the result as a reply. `/skill list` shows usag
 
 **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).
+**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.
+
+**The qualitative half — real time saved.** Scores measure quality; **[case studies](CASE_STUDIES.md)** measure outcomes. See the kind of before → after a skill delivers (PRD: ~2 days → ~25 min), and **[add your own 2-minute ROI story](../../issues/new?template=roi-story.yml)** — we'll feature it.
 
 **The loop actually catches bad skills.** A recent run flagged three skills scoring ~2/5 because they asked for missing inputs instead of delivering. We added a "work from a brief" rule, re-ran, and they jumped to **4.75/5**:
 
@@ -317,6 +349,8 @@ The same 207 skills reach you through every channel — pick whatever fits your
 
 > **196 of 207 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)**.
+
 ---
 
 ## 🔌 Works With — Cross-Tool Compatibility

package/exports/aider/pm-cross/professional-brain/professional-brain.md

@@ -1,5 +1,7 @@
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/chatgpt/pm-cross/professional-brain/SYSTEM_PROMPT.md

@@ -1,5 +1,7 @@
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/cline/pm-cross/professional-brain/professional-brain.md

@@ -1,5 +1,7 @@
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/continue/pm-cross/professional-brain/professional-brain.md

@@ -5,6 +5,8 @@ description: "Maintain a durable, local markdown memory ('brain') of your produc
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/cursor/pm-cross/professional-brain/professional-brain.mdc

@@ -6,6 +6,8 @@ alwaysApply: false
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/gemini/pm-cross/professional-brain/GEM_INSTRUCTIONS.md

@@ -4,6 +4,8 @@ Follow these instructions:
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/obsidian/pm-cross/professional-brain/professional-brain.md

@@ -7,6 +7,8 @@ description: "Maintain a durable, local markdown memory ('brain') of your produc
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/roo/pm-cross/professional-brain/professional-brain.md

@@ -1,5 +1,7 @@
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/windsurf/pm-cross/professional-brain/professional-brain.md

@@ -5,6 +5,8 @@ description: "Maintain a durable, local markdown memory ('brain') of your produc
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/exports/zed/pm-cross/professional-brain/professional-brain.md

@@ -1,5 +1,7 @@
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-claude-skills",
-  "version": "28.3.0",
+  "version": "29.0.0",
   "type": "module",
   "mcpName": "io.github.mohitagw15856/pm-claude-skills",
   "description": "206 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>.",

package/skills/professional-brain/SKILL.md

@@ -5,6 +5,8 @@ description: "Maintain a durable, local markdown memory ('brain') of your produc
 
 # Professional Brain Skill
 
+> 🚀 **New to this? Start with the [5-minute Quickstart](../../BRAIN_QUICKSTART.md)** — a folder + one file, with a worked example. This file is the full reference.
+
 Most skills start cold — you paste the same context every time, and decisions made six weeks
 ago lose the *why*. This skill gives the library a **memory**: a plain-markdown `brain/` folder
 on disk that skills read before they answer and write to after. No vector DB, no cloud — just