npm - pm-claude-skills - Versions diffs - 30.0.0 → 30.2.0 - Mend

pm-claude-skills 30.0.0 → 30.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (400) hide show

package/README.md CHANGED Viewed

@@ -1,4 +1,4 @@
-# 🧠 PM Skills — 313 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
+# 🧠 PM Skills — 319 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
 [![In the official Anthropic plugin directory](https://img.shields.io/badge/Anthropic%20Plugin%20Directory-Published-D97757?logo=anthropic&logoColor=white)](#-quick-install-2-minutes)
 [![Stars](https://img.shields.io/github/stars/mohitagw15856/pm-claude-skills?style=social)](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
@@ -9,10 +9,10 @@
 [![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-313-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)
+[![Skills](https://img.shields.io/badge/skills-319-blue)](https://github.com/mohitagw15856/pm-claude-skills)
+[![eval](https://img.shields.io/badge/eval--scored-208%20%C2%B7%20avg%204.8%2F5-brightgreen)](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)
 [![Subagents](https://img.shields.io/badge/subagents-4-blueviolet)](agents/)
-[![Commands](https://img.shields.io/badge/slash%20commands-6-blueviolet)](commands/)
+[![Commands](https://img.shields.io/badge/slash%20commands-19-blueviolet)](commands/)
 [![Personas](https://img.shields.io/badge/personas-4-blueviolet)](output-styles/)
 [![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)
 [![Integrations](https://img.shields.io/badge/integrates%20with-n8n%20%C2%B7%20Lovable%20%C2%B7%20Obsidian-0E9F6E)](connectors/)
@@ -25,7 +25,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=313+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=319+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>
@@ -56,11 +56,11 @@
 *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.**
-> 313 professional skills + 4 agent templates across 45 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
+> 319 professional skills + 4 agent templates across 46 bundles covering 23 professions. Built for Claude Code — and now portable to ChatGPT, Gemini, and Hermes Agent. Built by a PM, used by everyone.
 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 — v30.0.0 (25 new skills, 4 new bundles + eval coverage):** **🤖 AI-builder pack** (prompt-optimizer, eval-rubric-designer, RAG architecture review, LLM guardrails spec, agent-design review, model-selection advisor), **🚨 Crisis & sensitive comms** (PR crisis response, incident public statement, customer outage notice, layoff communication, apology letter), **🩺 Healthcare documentation** (SOAP note, discharge summary, prior-authorization letter, clinical-trial protocol), **📮 Life-admin letters** (complaint, dispute, reference, rental application, insurance claim), **🎗️ Nonprofit** (impact report, case for support, donor update) and **procurement** (RFP writer, vendor-contract checklist). Plus a new **[📈 Eval-coverage page](https://mohitagw15856.github.io/pm-claude-skills/coverage.html)** showing which bundles are scored. *Earlier (v29.7):* Data-Eng, Consulting & Support packs + Guided Journeys. **313 skills across 45 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
+**🆕 Latest — v30.2.0 (中文 interface — a bilingual playground):** the whole playground UI now switches between **English and Simplified Chinese** — every page carries a **🌐 中文 / 🌐 English** toggle in the nav (nav, hero, Job Search, Guided Journeys, Catalog, and more are hand-translated, not machine output). Your choice is remembered across visits. This is on top of the **🌐 Translate** button that localizes any *generated result* into 11 languages. *Earlier (v30.1):* a **🌐 Localization bundle** — `professional-translator`, `transcreation`, `localization-brief`, `subtitle-caption`, `glossary-builder`, `i18n-readiness-review`. **319 skills across 46 bundles.** → **[Full release history & notes](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
 ### ▶ See it in action — [try the live Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)
@@ -89,7 +89,7 @@ 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 313 skills](#️-all-313-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 319 skills](#️-all-319-skills) · [**⭐ star the repo**](https://github.com/mohitagw15856/pm-claude-skills/stargazers) so others find it.
 ---
@@ -112,7 +112,7 @@ It's not just text — the playground exports every result as a **professionally
   </tr>
 </table>
-> Generate yours: run a skill in the [Playground](https://mohitagw15856.github.io/pm-claude-skills/), then **Download → PDF · Paper / Modern / Technical**. Add a `Brand color: #hex` line to your context and it tints to match (last tile). Personal documents live in the [`pm-personal`](#️-all-313-skills) bundle (résumé, cover letter, bio, LinkedIn, portfolio, one-pager).
+> Generate yours: run a skill in the [Playground](https://mohitagw15856.github.io/pm-claude-skills/), then **Download → PDF · Paper / Modern / Technical**. Add a `Brand color: #hex` line to your context and it tints to match (last tile). Personal documents live in the [`pm-personal`](#️-all-319-skills) bundle (résumé, cover letter, bio, LinkedIn, portfolio, one-pager).
 ---
@@ -121,11 +121,11 @@ It's not just text — the playground exports every result as a **professionally
 <details>
 <summary>Read more ↓</summary>
-The whole library on one page — install, all 313 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
+The whole library on one page — install, all 319 skills by profession, the Professional Brain, the REST API, integrations, and quality tooling. Great to **print, share, or drop into a slide**.
 <p align="center">
   <a href="CHEATSHEET.md">
-    <img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills one-page cheatsheet — 313 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 — 319 skills, the Professional Brain, REST API, integrations, and tooling at a glance." />
   </a>
 </p>
@@ -156,7 +156,7 @@ Generic AI forgets everything between sessions, so you re-paste context forever
 <details>
 <summary>Read more ↓</summary>
-These 313 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:
+These 319 skills aren't a random catalog — they cover the **full arc of professional work**, end to end. Wherever you are in the loop, there's a skill for it:
 ```mermaid
 flowchart LR
@@ -175,7 +175,7 @@ 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 313 skills**](#️-all-313-skills) grouped by profession.
+> New here? Start with the [**top-tier skills**](#️-skill-tiers--start-with-the-strongest), or jump straight to [**all 319 skills**](#️-all-319-skills) grouped by profession.
 </details>
@@ -263,7 +263,7 @@ 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). 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.
+**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. **208 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.
@@ -298,7 +298,7 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
 | | **PM Skills** | Typical skill repo |
 |---|:---:|:---:|
-| Skills | **313**, across 23 professions | a handful → dozens, usually one domain |
+| Skills | **319**, 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 |
@@ -323,13 +323,13 @@ Most skill repos are a folder of prompts. This one is a **system** — measured,
 >
 > ⚠️ **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 313 interactively:
+**With the [`skills`](https://github.com/vercel-labs/skills) CLI** (the open agent-skills installer that works across Claude Code, Cursor, Codex, OpenCode & 60+ agents) — pick from all 319 interactively:
 ```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 313
+npx skills add mohitagw15856/pm-claude-skills --skill '*'            # install all 319
 ```
 **Or our own installer** — via the [`pm-claude-skills`](https://www.npmjs.com/package/pm-claude-skills) npm package (Windows/macOS/Linux, needs Node), which also installs subagents, slash commands & cross-tool exports:
@@ -338,7 +338,7 @@ npx skills add mohitagw15856/pm-claude-skills --skill '*'            # install a
 npx pm-claude-skills add --agent claude     # or: codex · cursor · hermes · openclaw
 ```
-**Or one-line MCP** — make all 313 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 319 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
@@ -399,7 +399,7 @@ ln -s ~/pm-claude-skills/skills/* ~/.claude/skills/
 <details>
 <summary>Read more ↓</summary>
-The same 313 skills reach you through every channel — pick whatever fits your stack:
+The same 319 skills reach you through every channel — pick whatever fits your stack:
 | Channel | Get it |
 |---|---|
@@ -410,10 +410,10 @@ The same 313 skills reach you through every channel — pick whatever fits your
 | 🧠 **MCP (local)** | `npx -y pm-claude-skills-mcp` — tools, **prompts & resources**. Listed in the [official MCP registry](https://github.com/mohitagw15856/pm-claude-skills/blob/main/server.json). |
 | ⚡ **MCP (hosted)** | Add **`https://pm-skills-mcp.pm-claude-skills.workers.dev/`** as a connector URL in **ChatGPT, Claude.ai, or Cursor** — no install. Also on **[Smithery](https://smithery.ai/servers/mohit15856/pm-skills)**. ([build your own](mcp-remote/)) |
 | 🧩 **Browser extension** | A skill picker inside ChatGPT, Claude.ai & Gemini — [`extension/`](extension/) |
-| 🖥️ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo** — [`exports/`](exports/) |
+| 🖥️ **IDE rules** | Generated exports for **Cursor, Windsurf, Aider, Cline, Continue, Zed, Roo, Kilo Code** — [`exports/`](exports/) |
 | 🤖 **Agents & answer engines** | [`llms.txt`](https://mohitagw15856.github.io/pm-claude-skills/llms.txt) makes the whole library discoverable & citable |
-> **196 of 313 skills are eval-scored, averaging 4.8/5** — see the [leaderboard](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html).
+> **208 of 319 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)**.
@@ -435,7 +435,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 313 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 319 skills into the Command Palette — search and *insert a skill as context* for Copilot/Cursor chat, copy it, or open it in the Playground.
 | Platform | How it works | Auto-trigger? |
 |---|---|---|
@@ -595,7 +595,7 @@ 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 313 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 319 skills** (curated cases kept verbatim; the rest auto-generated), then `npm run eval:all` runs the full pass on Haiku for **~$2** total. The weakest scorers can then be auto-rewritten with **`npm run improve -- <skill>`** (`/improve`), which keeps a change only if the score goes up.
 </details>
@@ -691,7 +691,7 @@ Not sure which plugin to install? Here's what each one covers:
 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 313 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 319 skills here are the building blocks for agent templates outside of finance.**
 ### What is an agent template?
@@ -771,7 +771,7 @@ More templates will follow. If you want to contribute one, see the [template con
 <details>
 <summary>Read more ↓</summary>
-**Latest: v30.0.0 — 25 new skills, 4 new bundles (AI-builder, crisis comms, healthcare, life-admin, nonprofit) & an eval-coverage page.** 313 skills across 45 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
+**Latest: v30.0.0 — 25 new skills, 4 new bundles (AI-builder, crisis comms, healthcare, life-admin, nonprofit) & an eval-coverage page.** 319 skills across 46 bundles, 23 professions. Every tagged release has complete notes on the **[Releases page](https://github.com/mohitagw15856/pm-claude-skills/releases)**.
 Full [Keep a Changelog](https://keepachangelog.com/)-format history — every release back to the start — is in **[CHANGELOG.md](CHANGELOG.md)**.
@@ -819,7 +819,7 @@ This repo was built alongside a published 16-part article series on Medium.
 <details>
 <summary>Read more ↓</summary>
-A 313-skill library doesn't have 313 equally-mature skills, and pretending otherwise
+A 319-skill library doesn't have 319 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.**
@@ -834,7 +834,7 @@ If you're new, install `pm-essentials` and try a couple of Production-Ready skil
 ---
-## 🗂️ All 313 Skills
+## 🗂️ All 319 Skills
 <details>
 <summary>Read more ↓</summary>
@@ -876,7 +876,7 @@ Every skill, grouped by profession. **[Browse the full per-skill catalog → SKI
 <details>
 <summary>Read more ↓</summary>
-Building and maintaining 313 skills across 45 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
+Building and maintaining 319 skills across 46 bundles takes real time — testing skills against new model releases, building new ones from community requests, writing the article series, and keeping documentation current.
 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)).
@@ -895,6 +895,24 @@ Full details and where the money goes: **[SPONSORS.md](SPONSORS.md)**.
 ---
+## 🌐 Community Skills — get listed, earn the badge
+Built your own skills? **[List them in the Community Skills directory](COMMUNITY-SKILLS.md)** —
+a place to showcase skill repos and packs that follow the `SKILL.md` standard. It's a **one-row
+pull request**, and once it's merged you earn a badge to show off in your own repo:
+[![Featured in PM Skills Community](https://mohitagw15856.github.io/pm-claude-skills/assets/community-badge.svg)](COMMUNITY-SKILLS.md)
+```markdown
+[![Featured in PM Skills Community](https://mohitagw15856.github.io/pm-claude-skills/assets/community-badge.svg)](https://github.com/mohitagw15856/pm-claude-skills/blob/main/COMMUNITY-SKILLS.md)
+```
+Community listings live in their authors' own repos and are **community-maintained — not
+eval-scored or security-audited** (that's the [curated library](#️-all-319-skills) above). Want
+your skill *in* the curated library instead? See **Contributing** below.
+---
 ## 🤝 Contributing — Add Your Skill
 <details>
@@ -902,6 +920,8 @@ Full details and where the money goes: **[SPONSORS.md](SPONSORS.md)**.
 This is an open-source community library. If you've built a skill that saves you time, share it here.
+**Two ways to share:** contribute a skill into the **curated library** (eval-scored, in the playground/MCP/exports) via the quality-gated flow below — or, if you'd rather keep it in your own repo, **list it in [Community Skills](COMMUNITY-SKILLS.md)** with a one-row PR and earn a **"Featured in PM Skills Community" badge** for your repo (community-maintained, not eval-scored).
 **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).
 **How to contribute:**

package/bin/cli.mjs CHANGED Viewed

@@ -26,7 +26,7 @@ const VERSION = (() => {
 const NATIVE = new Set(['claude', 'hermes', 'codex', 'openclaw']);
 // Rule-file agents install generated files from exports/<agent> (ext per agent).
-const RULEFILE = { cursor: '.mdc', windsurf: '.md', aider: '.md' };
+const RULEFILE = { cursor: '.mdc', windsurf: '.md', aider: '.md', kilocode: '.md' };
 const defaultTarget = (agent) => ({
   claude: join(homedir(), '.claude', 'skills'),
   hermes: join(homedir(), '.hermes', 'skills'),
@@ -35,6 +35,7 @@ const defaultTarget = (agent) => ({
   cursor: join(process.cwd(), '.cursor', 'rules'),
   windsurf: join(process.cwd(), '.windsurf', 'rules'),
   aider: join(process.cwd(), '.aider', 'skills'),
+  kilocode: join(process.cwd(), '.kilocode', 'rules'),
 }[agent]);
 function parse(argv) {
@@ -74,7 +75,7 @@ function placeDir(src, dest, { link, dryRun }) {
 function add(opts) {
   const agent = opts.agent;
   if (!agent || !(NATIVE.has(agent) || agent in RULEFILE)) {
-    console.error(`Error: --agent must be one of: claude, hermes, codex, openclaw, cursor, windsurf, aider.`);
+    console.error(`Error: --agent must be one of: claude, hermes, codex, openclaw, cursor, windsurf, aider, kilocode.`);
     process.exit(2);
   }
   const skillsDir = join(PKG_ROOT, 'skills');
@@ -135,6 +136,7 @@ function add(opts) {
       cursor: `Cursor will pick up the rules in ${target} on its next session.`,
       windsurf: `Windsurf will pick up the rules in ${target} on its next session.`,
       aider: `Load any of them with:  aider --read ${join(target, '<skill>.md')}`,
+      kilocode: `Kilo Code will pick up the rules in ${target} on its next session.`,
     }[agent] || `Restart ${agent} — it auto-discovers SKILL.md skills in ${target} by their description.`;
     console.log(note);
     console.log(`\n${STAR}`);

package/exports/README.md CHANGED Viewed

@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
 node scripts/build-exports.mjs
 ```
-Currently exporting **313 skills** to:
+Currently exporting **319 skills** to:
 - **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
 - **Google Gemini — Gem instructions** → `exports/gemini/`
@@ -19,6 +19,7 @@ Currently exporting **313 skills** to:
 - **Continue.dev — rule (.md)** → `exports/continue/`
 - **Zed — .rules file (.md)** → `exports/zed/`
 - **Roo Code — .roo/rules/ rule (.md)** → `exports/roo/`
+- **Kilo Code — .kilocode/rules/ rule (.md)** → `exports/kilocode/`
 - **Obsidian — vault skill note (AI-plugin prompt)** → `exports/obsidian/`
 Adding a new platform is a few lines in the `PLATFORMS` registry of

package/exports/aider/README.md CHANGED Viewed

@@ -3,7 +3,7 @@
 > Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
 > **Do not edit these files by hand** — edit the source skill and regenerate.
-313 skills exported. Copy a `.mdc rule` into the tool to use it.
+319 skills exported. Copy a `.mdc rule` into the tool to use it.
 | Skill | Bundle | Path |
 |---|---|---|
@@ -138,6 +138,7 @@
 | GDPR Compliance | `pm-compliance` | `pm-compliance/gdpr-compliance/gdpr-compliance.md` |
 | Git Troubleshooter | `pm-engineering` | `pm-engineering/git-troubleshooter/git-troubleshooter.md` |
 | Giving Feedback | `pm-comms` | `pm-comms/giving-feedback/giving-feedback.md` |
+| Glossary Builder | `pm-localization` | `pm-localization/glossary-builder/glossary-builder.md` |
 | Go-To-Market | `pm-gtm` | `pm-gtm/go-to-market/go-to-market.md` |
 | Go-to-Market Planner | `pm-delivery` | `pm-delivery/go-to-market-planner/go-to-market-planner.md` |
 | Grant Proposal | `pm-cross` | `pm-cross/grant-proposal/grant-proposal.md` |
@@ -147,6 +148,7 @@
 | HIPAA Safeguards | `pm-compliance` | `pm-compliance/hipaa-safeguards/hipaa-safeguards.md` |
 | Hiring Rubric | `pm-people` | `pm-people/hiring-rubric/hiring-rubric.md` |
 | Hook Writer | `pm-creator` | `pm-creator/hook-writer/hook-writer.md` |
+| i18n Readiness Review | `pm-localization` | `pm-localization/i18n-readiness-review/i18n-readiness-review.md` |
 | IEP Goal Support | `pm-education` | `pm-education/iep-goal-support/iep-goal-support.md` |
 | Impact Report | `pm-nonprofit` | `pm-nonprofit/impact-report/impact-report.md` |
 | Incident Postmortem | `pm-engineering` | `pm-engineering/incident-postmortem/incident-postmortem.md` |
@@ -178,6 +180,7 @@
 | LLM Guardrails Spec | `pm-ai` | `pm-ai/llm-guardrails-spec/llm-guardrails-spec.md` |
 | Load Testing Plan | `pm-engineering` | `pm-engineering/load-testing-plan/load-testing-plan.md` |
 | Local Dev Setup | `pm-engineering` | `pm-engineering/local-dev-setup/local-dev-setup.md` |
+| Localization Brief | `pm-localization` | `pm-localization/localization-brief/localization-brief.md` |
 | Managing Up | `pm-comms` | `pm-comms/managing-up/managing-up.md` |
 | Marketing Funnel Plan | `pm-growth` | `pm-growth/marketing-funnel-plan/marketing-funnel-plan.md` |
 | Media Pitch | `pm-gtm` | `pm-gtm/media-pitch/media-pitch.md` |
@@ -226,6 +229,7 @@
 | Product Launch Checklist | `pm-delivery` | `pm-delivery/product-launch-checklist/product-launch-checklist.md` |
 | Product Positioning Doc | `pm-gtm` | `pm-gtm/product-positioning-doc/product-positioning-doc.md` |
 | Professional Brain | `pm-cross` | `pm-cross/professional-brain/professional-brain.md` |
+| Professional Translator | `pm-localization` | `pm-localization/professional-translator/professional-translator.md` |
 | Project Status Report | `pm-operations` | `pm-operations/project-status-report/project-status-report.md` |
 | Promotion Packet | `pm-career` | `pm-career/promotion-packet/promotion-packet.md` |
 | Prompt Optimizer | `pm-ai` | `pm-ai/prompt-optimizer/prompt-optimizer.md` |
@@ -293,6 +297,7 @@
 | Strategy Memo | `pm-business` | `pm-business/strategy-memo/strategy-memo.md` |
 | Student Feedback | `pm-education` | `pm-education/student-feedback/student-feedback.md` |
 | Substack Notes Scraper | `pm-writers` | `pm-writers/substack-notes-scraper/substack-notes-scraper.md` |
+| Subtitle & Caption | `pm-localization` | `pm-localization/subtitle-caption/subtitle-caption.md` |
 | Support Macro | `pm-support` | `pm-support/support-macro/support-macro.md` |
 | Support Runbook | `pm-support` | `pm-support/support-runbook/support-runbook.md` |
 | Sycophancy Challenger | `pm-cross` | `pm-cross/sycophancy-challenger/sycophancy-challenger.md` |
@@ -306,6 +311,7 @@
 | Technical Spec Template | `pm-delivery` | `pm-delivery/technical-spec-template/technical-spec-template.md` |
 | Test Strategy Document | `pm-engineering` | `pm-engineering/test-strategy-doc/test-strategy-doc.md` |
 | Thumbnail Creator Skill (via Gemini) | `pm-writers` | `pm-writers/thumbnail-creator/thumbnail-creator.md` |
+| Transcreation | `pm-localization` | `pm-localization/transcreation/transcreation.md` |
 | Unit Economics | `pm-calculators` | `pm-calculators/unit-economics/unit-economics.md` |
 | User Interview Synthesis | `pm-discovery` | `pm-discovery/user-interview-synthesis/user-interview-synthesis.md` |
 | User Research Synthesis | `pm-essentials` | `pm-essentials/user-research-synthesis/user-research-synthesis.md` |

package/exports/aider/pm-localization/glossary-builder/glossary-builder.md ADDED Viewed

@@ -0,0 +1,56 @@
+# Glossary Builder Skill
+Inconsistent terminology is the most visible localization failure — when "dashboard" is translated three
+ways across one product, it looks amateur and confuses users. A glossary (termbase) fixes the key terms
+*once*, so every translator and every locale uses the approved rendering. This skill builds it: extract
+the terms that matter, define them in context, and set the approved translation (or do-not-translate flag).
+## Required Inputs
+Ask for these only if they aren't already provided:
+- **The source material / domain** — product UI, docs, or a term list; and the field (so definitions are right).
+- **Target locale(s)** — which languages need approved translations.
+- **Existing decisions** — any brand terms, product names, or prior translations to lock in.
+- **Do-not-translate candidates** — brand/product names, trademarks, code/API terms.
+## Output Format
+### Glossary: [product/domain]
+A termbase table — one row per term:
+| Source term | Part of speech | Definition / context | Do-not-translate? | [Locale 1] | [Locale 2] |
+|---|---|---|---|---|---|
+| Dashboard | noun | the main metrics screen | no | 仪表板 | Tableau de bord |
+| Acme Cloud | proper noun | product name | **yes (keep verbatim)** | Acme Cloud | Acme Cloud |
+| sync (verb) | verb | to reconcile data both ways | no | 同步 | synchroniser |
+**Guidance included:**
+- **Definitions/context** — so a translator knows *which* meaning (e.g. "ticket" = support case, not event admission), preventing the classic wrong-sense error.
+- **Do-not-translate list** — brand/product names, trademarks, code identifiers, UI elements that must stay in English.
+- **Part of speech / forms** — flag terms where the form matters (verb vs. noun "filter").
+- **Consistency notes** — preferred vs. avoided synonyms in the source itself ("use 'sign in', not 'log in'").
+**Output note:** structured for import into a CAT tool (Trados/memoQ/Crowdin) or to sit in the localization style guide. Mark any translation that needs native review as *(draft — confirm)*.
+## Quality Checks
+- [ ] Each term has a definition/context so translators pick the right sense
+- [ ] Do-not-translate terms (brand, product, code) are clearly flagged
+- [ ] An approved translation is given per target locale (or marked draft for review)
+- [ ] Part of speech / ambiguous forms are disambiguated
+- [ ] Source-side consistency (preferred synonyms) is noted
+- [ ] Structured for a CAT tool / style-guide import
+## Anti-Patterns
+- [ ] Do not list terms without context — "ticket" or "filter" with no definition guarantees wrong-sense translations
+- [ ] Do not omit the do-not-translate flags — that's how brand/product names get mangled across locales
+- [ ] Do not present machine translations as approved — mark them draft for native review
+- [ ] Do not ignore source consistency — if the source mixes "sign in/log in," the glossary should pick one
+- [ ] Do not forget part of speech — a term that's both noun and verb often needs two entries
+## Based On
+Terminology-management practice — termbases, do-not-translate lists, context definitions, CAT-tool glossary structure.

package/exports/aider/pm-localization/i18n-readiness-review/i18n-readiness-review.md ADDED Viewed

@@ -0,0 +1,56 @@
+# i18n Readiness Review Skill
+Localizing a product that isn't *internationalized* fails expensively — translators hit hard-coded
+strings, layouts break on longer languages, dates show in the wrong format, and RTL shatters the UI.
+i18n is the engineering groundwork; localization is the content. This skill audits whether the product
+is ready, so you fix the foundations *before* paying to translate into the cracks.
+## Required Inputs
+Ask for these only if they aren't already provided:
+- **The product** — web/app/codebase, stack/framework (i18n tooling differs).
+- **Target languages** — especially if any need RTL (Arabic/Hebrew), CJK (Chinese/Japanese/Korean), or are long (German/Finnish).
+- **What you can share** — code snippets, UI screenshots, or a description of how strings/formatting are handled today.
+## Output Format
+### i18n Readiness: [product]
+A readiness audit across the dimensions that break localization, each with status (🟢 ready / 🟡 partial / 🔴 blocker) and the fix:
+| Dimension | Check | Status | Fix |
+|---|---|---|---|
+| **String externalization** | no user-facing text hard-coded; all in resource files / i18n keys | | move strings to a catalog; no concatenated sentences |
+| **Formatting** | dates, numbers, currency, plurals via locale-aware libs (Intl/ICU) | | use Intl/ICU; never string-format dates |
+| **Pluralization** | plural rules handled (not `count + " items"`) | | ICU plural categories (some langs have 4–6) |
+| **Layout/expansion** | UI tolerates ~+30–40% text length; no fixed-width truncation | | flexible layouts, no text baked into images |
+| **Encoding** | UTF-8 throughout; CJK renders | | UTF-8 end to end |
+| **RTL** | layout mirrors for right-to-left scripts | | logical CSS properties, dir attribute |
+| **Locale plumbing** | locale selection, fallback, and persistence exist | | a locale resolver + fallback chain |
+| **Assets/content** | images with text, examples, names are swappable | | externalize locale-specific assets |
+**Prioritised fixes** — the blockers (🔴) first (hard-coded strings, no Intl formatting, broken RTL), then 🟡s. These must land **before** translation begins, or you translate into a broken foundation.
+**Verdict** — ready to localize / fix-blockers-first / not yet, in one line.
+## Quality Checks
+- [ ] Checks string externalization (the #1 blocker) — no hard-coded or concatenated UI text
+- [ ] Verifies locale-aware formatting (Intl/ICU) for dates, numbers, currency, plurals
+- [ ] Assesses layout expansion (+30–40%) and RTL if a target needs it
+- [ ] Confirms UTF-8 / CJK encoding end to end
+- [ ] Prioritises blockers to fix *before* translation starts
+- [ ] Ends with a clear ready / not-ready verdict
+## Anti-Patterns
+- [ ] Do not start translating before i18n is ready — you'll translate into hard-coded strings and broken layouts
+- [ ] Do not concatenate sentence fragments — word order differs by language; translate whole strings with placeholders
+- [ ] Do not string-format dates/numbers — use Intl/ICU, or every locale shows them wrong
+- [ ] Do not assume text length — German/Finnish expand; fixed-width UI truncates and clips
+- [ ] Do not ignore RTL until late — retrofitting right-to-left into a left-to-right layout is a rebuild, not a tweak
+## Based On
+Internationalization engineering practice — string externalization, ICU/Intl formatting & plurals, text expansion, RTL, UTF-8.

package/exports/aider/pm-localization/localization-brief/localization-brief.md ADDED Viewed

@@ -0,0 +1,60 @@
+# Localization Brief Skill
+Localization is not translation — it's making a product *feel native* in a market, which touches formats,
+imagery, payment methods, legal norms, and cultural expectations far beyond the strings. This skill plans
+it: what to translate, what to adapt, what to rebuild for the locale, in priority order, with the cultural
+and regulatory pitfalls that sink naïve "just translate the UI" launches.
+## Required Inputs
+Ask for these only if they aren't already provided:
+- **The product/content** and the **target locale(s)** (language + region — fr-FR vs fr-CA matters).
+- **What it is** — SaaS UI, marketing site, app, docs, campaign — sets what needs adapting.
+- **Goal & depth** — testing a market (light) vs. full local presence (deep).
+- **Known constraints** — budget, what's already internationalized (i18n-ready or not).
+## Output Format
+### Localization Brief: [product] → [locale(s)]
+**1. Scope per locale** — language + region, and the depth (translate-only vs. full localization).
+**2. Translate / Adapt / Rebuild** — the core matrix; what each element needs:
+| Area | Action | Notes |
+|---|---|---|
+| UI strings | translate | register, length expansion (DE ~+30%) |
+| Dates/numbers/currency | adapt | formats, separators, currency + display |
+| Imagery / examples | adapt | culturally appropriate people, scenarios, names |
+| Payments | rebuild | local methods (e.g. Alipay/WeChat in CN, iDEAL in NL) |
+| Legal / privacy | adapt | local consent, terms, data residency |
+| Content / SEO | adapt | local keywords, not translated ones |
+| Tone / formality | adapt | formality norms, humour that travels |
+**3. Priorities** — what to do first for the goal (often: UI + payments + legal for a real launch; UI + a landing page for a market test). Sequence by impact.
+**4. Cultural & regulatory pitfalls** — the specific traps for this market: colour/symbol connotations, name/address/phone formats, RTL if relevant, regulated claims, censorship/hosting requirements. The stuff that embarrasses or blocks a launch.
+**5. Process & QA** — who translates (native + in-market review), how strings are managed (don't hard-code), and pseudo-localization / in-context QA before launch.
+## Quality Checks
+- [ ] Distinguishes translate vs. adapt vs. rebuild per element — not "translate everything"
+- [ ] Covers formats, imagery, payments, legal, and SEO — not just UI strings
+- [ ] Region (not just language) is specified where it changes things
+- [ ] Priorities are sequenced to the goal (market test vs. full launch)
+- [ ] Names the specific cultural/regulatory pitfalls for this market
+- [ ] Includes native + in-market review in the QA plan
+## Anti-Patterns
+- [ ] Do not equate localization with translation — payments, legal, formats, and imagery decide whether it feels native
+- [ ] Do not ignore region — fr-FR ≠ fr-CA, es-ES ≠ es-MX; the variant changes copy, formats, and norms
+- [ ] Do not localize SEO by translating keywords — research how locals actually search
+- [ ] Do not skip local payment methods — the best-localized UI converts nothing if they can't pay how they pay
+- [ ] Do not launch without in-market native review — machine/relay translation misses the embarrassing stuff
+## Based On
+Localization / internationalization practice — the translate/adapt/rebuild model, locale formats, market-specific payments & legal, in-country QA.

package/exports/aider/pm-localization/professional-translator/professional-translator.md ADDED Viewed

@@ -0,0 +1,50 @@
+# Professional Translator Skill
+Machine translation is literal; professional translation conveys *meaning, tone, and intent* the way a
+native speaker would say it. This skill translates with attention to register (formal vs. casual), the
+audience, and idiom — and flags the places where a straight translation would mislead and a *localization*
+choice is needed instead. (For marketing copy that must land emotionally in-culture, use
+[`transcreation`](../transcreation/SKILL.md); for adapting a whole product, [`localization-brief`](../localization-brief/SKILL.md).)
+## Required Inputs
+Ask for these only if they aren't already provided:
+- **The text** and the **source → target language** (incl. regional variant where it matters — e.g. Simplified vs. Traditional Chinese, LATAM vs. European Spanish).
+- **Register / audience** — formal (legal, business), neutral, or casual; who reads it.
+- **Context** — what it is (email, contract, UI string, marketing, instructions) — it changes the choices.
+- **Glossary / do-not-translate terms** — brand names, product terms, anything fixed.
+## Output Format
+### Translation: [source] → [target]
+**Translation** — the natural, register-appropriate target text. Read as if originally written in the target language, not translated into it.
+**Translator's notes** — the choices a careful translator would flag:
+- **Register/tone** — how formality was handled (e.g. 您 vs. 你 in Chinese, tu vs. usted, keigo in Japanese).
+- **Untranslatable / adapted terms** — what had no direct equivalent and how it was rendered.
+- **Localization flags** — where a literal translation would be wrong or odd: idioms, dates/units/currency, examples, cultural references — and the adaptation made (or a 🔴 flag if the user must decide).
+- **Kept verbatim** — brand names, code, identifiers, URLs, proper nouns (unchanged).
+- **Ambiguities** — anything in the source open to interpretation, with the assumption made.
+## Quality Checks
+- [ ] Reads natural and idiomatic in the target language — not a literal word map
+- [ ] Register/formality matches the audience and is noted (esp. you/formality distinctions)
+- [ ] Brand names, code, identifiers, and URLs are kept unchanged
+- [ ] Idioms, units, dates, and cultural references are adapted (or flagged), not translated literally
+- [ ] Regional variant is respected where it matters
+- [ ] Genuine ambiguities are surfaced, not silently guessed
+## Anti-Patterns
+- [ ] Do not translate word-for-word — convey meaning and tone the way a native would phrase it
+- [ ] Do not ignore register — the wrong formality (over-familiar or stiff) can offend or undermine
+- [ ] Do not translate idioms literally — render the equivalent expression or the plain meaning
+- [ ] Do not translate brand/product/proper names or code — keep them verbatim
+- [ ] Do not silently resolve ambiguity — flag it; the author may mean something specific
+## Based On
+Professional translation practice — meaning-based (not literal) translation, register matching, and the translation-vs-localization distinction.