pm-claude-skills 76.2.1 → 77.0.0

package/README.md

@@ -1,11 +1,18 @@
-# 🧠 PM Skills — 1099 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
+# 🧠 PM Skills — 1117 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
 
 <p align="center">
   <a href="https://mohitagw15856.github.io/pm-claude-skills/">
-    <img src="web/docs-assets/hero.svg" width="100%" alt="PM Skills — 1099 professional skills your AI assistant can read. Plain markdown, works with Claude, ChatGPT, Gemini, Cursor, and Codex. MIT licensed." />
+    <img src="web/docs-assets/hero.svg" width="100%" alt="PM Skills — 1117 professional skills your AI assistant can read. Plain markdown, works with Claude, ChatGPT, Gemini, Cursor, and Codex. MIT licensed." />
   </a>
 </p>
 
+> **Your landlord kept your deposit. Your mom got a medical bill that makes no sense. You got laid off on a Tuesday. Someone you love died, and no one handed you the checklist.**
+>
+> Generic AI gives you filler for the moments that matter most. **PM Skills** gives your AI the exact framework a senior professional would use — for 1,117 real tasks, across work *and* life.
+
+#### 👉 Start with your moment, not the catalogue → **[Skill Packs](PACKS.md)**
+🍼 New parent · 💼 Just laid off · 🌍 New to this country · 👵 Caring for a parent · 🕊️ Losing someone · 💸 Money in crisis · 🔑 Starting over · 🤖 Getting serious about AI
+
 [![In the official Anthropic plugin directory](https://img.shields.io/badge/Anthropic%20Plugin%20Directory-Published-D97757?logo=anthropic&logoColor=white)](#-quick-start)
 [![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)
@@ -25,7 +32,7 @@
 ## What is PM Skills?
 
 <!-- AEO Answer Capsule — 68 words -->
-PM Skills is an open-source library of 1099 Agent Skills — plain-markdown SKILL.md files that teach an AI assistant to do one professional task to a senior professional's standard, from writing a PRD to decoding a lease or running a blameless postmortem. Each skill bundles the framework, an output template, quality checks, and anti-patterns. It is MIT-licensed and works with Claude, ChatGPT, Gemini, Cursor, and Codex.
+PM Skills is an open-source library of 1117 Agent Skills — plain-markdown SKILL.md files that teach an AI assistant to do one professional task to a senior professional's standard, from writing a PRD to decoding a lease or running a blameless postmortem. Each skill bundles the framework, an output template, quality checks, and anti-patterns. It is MIT-licensed and works with Claude, ChatGPT, Gemini, Cursor, and Codex.
 <!-- End AEO Capsule -->
 
 **Decode a lease before you sign it. Write a PRD your team can execute. Simulate the promotion committee before the real one meets. Check the weather with zero API keys.** Generic AI gives you filler; these give you the structure a senior professional actually uses.
@@ -117,8 +124,8 @@ It's not just a folder of files — the whole library is explorable, runnable, a
 <table>
 <tr>
 <td width="50%" align="center">
-<a href="https://mohitagw15856.github.io/pm-claude-skills/galaxy3d.html"><img src="web/docs-assets/demo-galaxy.gif" width="100%" alt="Galaxy 3D — fly through all 1099 skills as a glowing constellation you orbit and click into" /></a>
-<br /><sub><b>🌌 <a href="https://mohitagw15856.github.io/pm-claude-skills/galaxy3d.html">Galaxy 3D</a></b> — fly through all 1099 skills as a living constellation. The ones you've run burn brighter.</sub>
+<a href="https://mohitagw15856.github.io/pm-claude-skills/galaxy3d.html"><img src="web/docs-assets/demo-galaxy.gif" width="100%" alt="Galaxy 3D — fly through all 1117 skills as a glowing constellation you orbit and click into" /></a>
+<br /><sub><b>🌌 <a href="https://mohitagw15856.github.io/pm-claude-skills/galaxy3d.html">Galaxy 3D</a></b> — fly through all 1117 skills as a living constellation. The ones you've run burn brighter.</sub>
 </td>
 <td width="50%" align="center">
 <a href="https://mohitagw15856.github.io/pm-claude-skills/wrapped.html"><img src="web/docs-assets/demo-holo.gif" width="100%" alt="PM Skills Wrapped — your practice turned into a shareable, Spotify-Wrapped-style story" /></a>
@@ -127,7 +134,7 @@ It's not just a folder of files — the whole library is explorable, runnable, a
 </tr>
 </table>
 
-▶ **[Open the Playground](https://mohitagw15856.github.io/pm-claude-skills/)** to run any of the 1099 skills with your own key — or just [browse them all](SKILLS.md).
+▶ **[Open the Playground](https://mohitagw15856.github.io/pm-claude-skills/)** to run any of the 1117 skills with your own key — or just [browse them all](SKILLS.md).
 
 ## 💬 What can I ask it to do?
 
@@ -140,7 +147,7 @@ Anything below is a real ask that activates a real skill — say it in your own
 | 🛂 *"prep me for the visa interview"* → [the-visa-interview](skills/the-visa-interview/SKILL.md) | 🔨 *"is this contractor quote fair?"* → [home-contractor-quote-decoder](skills/home-contractor-quote-decoder/SKILL.md) | 🏡 *"should we rent or buy?"* → [rent-vs-buy](skills/rent-vs-buy/SKILL.md) |
 | 📝 *"draft my self-review honestly"* → [performance-review](skills/performance-review/SKILL.md) | 🚀 *"are we ready to launch?"* → [product-launch-checklist](skills/product-launch-checklist/SKILL.md) | 📬 *"my inbox is 4,000 deep"* → [email-triage-system](skills/email-triage-system/SKILL.md) |
 
-…all 1099 asks live in **[the catalog](SKILLS.md)**.
+…all 1117 asks live in **[the catalog](SKILLS.md)**.
 
 ## ⚡ Quick start
 
@@ -156,7 +163,7 @@ No `npm install` needed — `npx pm-claude-skills …` always runs the latest. `
 
 ## 📚 The skills
 
-Every skill follows the same discipline: what it produces, the inputs it needs, a real framework (severity scales, decision rules — not vibes), a concrete output template, quality checks, and anti-patterns. All 1099 pass the [SkillSpec](SKILLSPEC.md) L3 gate and a security audit in CI.
+Every skill follows the same discipline: what it produces, the inputs it needs, a real framework (severity scales, decision rules — not vibes), a concrete output template, quality checks, and anti-patterns. All 1117 pass the [SkillSpec](SKILLSPEC.md) L3 gate and a security audit in CI.
 
 <table align="center">
   <tr align="center">
@@ -181,6 +188,16 @@ Every skill follows the same discipline: what it produces, the inputs it needs,
   </tr>
 </table>
 
+<p align="center">
+  <b><a href="SKILLS.md">Browse all 1,099 →</a></b> ·
+  <b><a href="https://mohitagw15856.github.io/pm-claude-skills/">try one in your browser →</a></b>
+</p>
+
+<details>
+<summary><b>Every category, with examples</b></summary>
+
+<br>
+
 ### For everyone — life's paperwork and decisions
 
 | Family | What it does | Examples (of many) |
@@ -227,6 +244,8 @@ Every skill follows the same discipline: what it produces, the inputs it needs,
 
 Before installing *anyone's* skills (including these): [skill-vetting](skills/skill-vetting/SKILL.md) — a security read for SKILL.md files. The library's own standard lives in [SKILLSPEC.md](SKILLSPEC.md); every skill's level is enforced in CI.
 
+</details>
+
 ## 🔍 What does a skill look like?
 
 <!-- AEO Answer Capsule — 62 words -->
@@ -246,7 +265,9 @@ description: "Decode a residential lease into plain English and rank the
 
 That's the whole trick: it's markdown. Your agent reads it and gains the judgment; you can read it too, audit it, edit it, or [write your own](SKILL-AUTHORING-STANDARD.md). No lock-in, no runtime, no telemetry.
 
-## 💸 Cut your token bill
+## 💸 What it costs you, and how to prove it
+
+### Cut your token bill
 
 The **[pm-tokens](plugins/pm-tokens)** bundle optimizes every stage of your agent's token journey — no API keys, stdlib Python, nothing leaves your machine. Five habits, typically **30–60% off a session's token flow**:
 
@@ -279,7 +300,7 @@ The **[pm-cowork](plugins/pm-cowork)** bundle is 100 skills for the office work
 
 **Three habits that compound:** (1) **The weekly review is the keystone** — it feeds [task-triage-matrix](skills/task-triage-matrix/SKILL.md), [deep-work-blocking](skills/deep-work-blocking/SKILL.md), and [personal-wip-limits](skills/personal-wip-limits/SKILL.md) automatically. (2) **The skills chain on purpose** — email-to-tasks feeds the task triage; the meeting audit feeds async-instead; delegation-brief hands off what the triage says to shed — follow the links inside each skill. (3) **Teams adopt one norm at a time** — start with [agenda-or-cancel](skills/agenda-or-cancel/SKILL.md) or [working-agreements](skills/working-agreements/SKILL.md), let it stick, then add the next; the ten-norms-on-Monday rollout is how none of them survive.
 
-## 🔬 Prove it, and stop paying rent
+### Prove a skill works, and stop paying MCP rent
 
 Two CLI tools for the trust-and-cost problems the ecosystem keeps hand-waving — both keyless-to-inspect, both one command:
 
@@ -298,7 +319,7 @@ npx pm-claude-skills mcp-audit --connect
 
 **Agent safety:** the **[pm-seatbelt](plugins/pm-seatbelt)** bundle is the pre-flight checklist before an agent touches email, the browser, or files — least-privilege reviews, [prompt-injection spotting](skills/injection-spotter/SKILL.md), and the [blast-radius drill](skills/blast-radius-drill/SKILL.md) for going autonomous. And **[RFC 0002 — HANDOFF.md](docs/rfcs/0002-agent-handoff-file.md)** is a dead-simple session-handoff convention (*your agent, but it remembers Monday*) — a file, not a server, with [reference hooks](hooks/).
 
-## ✅ Quality, not just quantity
+### Quality, not just quantity
 
 - **Every skill passes the [SkillSpec](SKILLSPEC.md) L3 gate** — structure, framework, quality checks, anti-patterns — enforced in CI on every commit
 - **[Eval-scored](https://mohitagw15856.github.io/pm-claude-skills/leaderboard.html)** — 208 scored outputs, avg 4.8/5, judged blind
@@ -309,7 +330,7 @@ npx pm-claude-skills mcp-audit --connect
 
 The library grew an ecosystem — all optional, all linked from the **[full showcase](docs/SHOWCASE.md)**:
 
-**[▶ Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)** — try any skill in your browser, no install · **[📸 the Gallery](docs/GALLERY.md)** — the creative side, in screenshots · **[Anti-Pattern Museum](https://mohitagw15856.github.io/pm-claude-skills/museum.html)** — 2,900+ shareable rules · **[The Handbook](https://mohitagw15856.github.io/pm-claude-skills/handbook.html)** (also a [real printed book](docs/print/)) · **[Workflow recipes](WORKFLOWS.md)** · **[Subagents & slash commands](agents/)** · **[MCP server + REST API](mcp-remote/)** · **[n8n / Slack / Obsidian integrations](connectors/)** · **[The Boardroom](https://mohitagw15856.github.io/pm-claude-skills/boardroom.html)** · **[SkillBench](skillbench/)** · **[Org Edition](org/)** · **[🇪🇸 🇫🇷 🇨🇳 🇯🇵 translations](skills-i18n/)**
+**[📄 The one-page cheatsheet](https://mohitagw15856.github.io/pm-claude-skills/cheatsheet.html)** — the whole library on one printable poster · **[▶ Skill Playground](https://mohitagw15856.github.io/pm-claude-skills/)** — try any skill in your browser, no install · **[📸 the Gallery](docs/GALLERY.md)** — the creative side, in screenshots · **[Anti-Pattern Museum](https://mohitagw15856.github.io/pm-claude-skills/museum.html)** — 2,900+ shareable rules · **[The Handbook](https://mohitagw15856.github.io/pm-claude-skills/handbook.html)** (also a [real printed book](docs/print/)) · **[Workflow recipes](WORKFLOWS.md)** · **[Subagents & slash commands](agents/)** · **[MCP server + REST API](mcp-remote/)** · **[n8n / Slack / Obsidian integrations](connectors/)** · **[The Boardroom](https://mohitagw15856.github.io/pm-claude-skills/boardroom.html)** · **[SkillBench](skillbench/)** · **[Org Edition](org/)** · **[🇪🇸 🇫🇷 🇨🇳 🇯🇵 translations](skills-i18n/)**
 
 ### Lint your own skills in CI
 
@@ -351,37 +372,19 @@ rulings, and how commonly each house rule is actually played.
 times and for settling the argument, because a rules disagreement is usually two
 groups who learned it differently and are both partly right.
 
-## 📄 The one-page cheatsheet
-
-The whole library on one poster — start path, standout features, and install one-liners for every tool. Print it, share it, drop it in a slide.
-
-<p align="center">
-  <a href="https://mohitagw15856.github.io/pm-claude-skills/cheatsheet.html">
-    <img src="web/docs-assets/cheatsheet.png" width="80%" alt="PM Skills cheatsheet — one link to start, the standout features, and install paths for every tool on one poster." />
-  </a>
-</p>
-
-**[🖼️ PNG](https://mohitagw15856.github.io/pm-claude-skills/docs-assets/cheatsheet.png)** · **[📄 PDF](https://mohitagw15856.github.io/pm-claude-skills/docs-assets/cheatsheet.pdf)** · **[🌐 Live poster](https://mohitagw15856.github.io/pm-claude-skills/cheatsheet.html)** · **[📥 Markdown](CHEATSHEET.md)**
-
 ## 🆕 Latest
 
-**v76.0.0 — the systems wave:** 20 new skills for the bureaucracies and emergencies people face alone — [🏛 pm-civic](plugins/pm-civic) (vote, permits, jury duty, [the letter that gets action](skills/elected-rep-letter/SKILL.md), report a hazard), [♿ pm-accessibility](plugins/pm-accessibility) ([appeal a denied disability benefit](skills/disability-benefit-appeal/SKILL.md), [accommodations](skills/accommodation-request/SKILL.md), accessible travel, disclosure), [✈️ pm-newcomer](plugins/pm-newcomer) (first-90-days in a new country: [arrival setup](skills/arrival-setup/SKILL.md), credential recognition, healthcare, [credit from scratch](skills/credit-from-scratch/SKILL.md)), and [🚨 pm-emergency](plugins/pm-emergency) ([go-bag](skills/go-bag-builder/SKILL.md), [your real local hazards](skills/hazard-risk-map/SKILL.md), [outage plan](skills/power-outage-plan/SKILL.md), after-the-disaster) — every one guard-railed and routed to official sources. **1099 skills, 121 bundles**.
-
-**v75.0.0 — the human-edges wave:** 20 new skills for the parts of life nobody built tools for — [🧠 pm-neurodivergent](plugins/pm-neurodivergent) ([masking-budget](skills/masking-budget/SKILL.md), [meltdown-map](skills/meltdown-map/SKILL.md), [body-double-session](skills/body-double-session/SKILL.md), [nt-translator](skills/nt-translator/SKILL.md), [sensory-audit](skills/sensory-audit/SKILL.md)), [🩺 pm-invisible-illness](plugins/pm-invisible-illness) ([diagnosis-limbo-kit](skills/diagnosis-limbo-kit/SKILL.md), [spoon-planner](skills/spoon-planner/SKILL.md), [perimenopause-navigator](skills/perimenopause-navigator/SKILL.md), [flare-day-planner](skills/flare-day-planner/SKILL.md)), [🏳️‍🌈 pm-identity](plugins/pm-identity) ([coming-out-rehearsal](skills/coming-out-rehearsal/SKILL.md), [name-change-navigator](skills/name-change-navigator/SKILL.md), [two-worlds-translator](skills/two-worlds-translator/SKILL.md), [faith-transition-companion](skills/faith-transition-companion/SKILL.md)) — plus [grief-admin](skills/grief-admin/SKILL.md), [legacy-letter](skills/legacy-letter/SKILL.md), [the-ick-decoder](skills/the-ick-decoder/SKILL.md), and [rabbit-hole-rescue](skills/rabbit-hole-rescue/SKILL.md); every sensitive one guard-railed. **1099 skills, 121 bundles**.
-
-**v74.0.0 — the life-expansion wave:** five new bundles for the parts of life beyond the office — [📖 pm-learning](plugins/pm-learning) (learn anything and make it stick: [learn-anything-roadmap](skills/learn-anything-roadmap/SKILL.md), [feynman-explainer](skills/feynman-explainer/SKILL.md), [spaced-repetition-setup](skills/spaced-repetition-setup/SKILL.md)), [💰 pm-wealth](plugins/pm-wealth) (build wealth on purpose — educational, not advice: [investing-for-beginners](skills/investing-for-beginners/SKILL.md), [first-100k-plan](skills/first-100k-plan/SKILL.md), [ask-for-a-raise](skills/ask-for-a-raise/SKILL.md)), [🤝 pm-social](plugins/pm-social) (the human conversations: [make-friends-as-an-adult](skills/make-friends-as-an-adult/SKILL.md), [boundary-setting-scripts](skills/boundary-setting-scripts/SKILL.md), [repair-after-a-fight](skills/repair-after-a-fight/SKILL.md)), [🩺 pm-caregiving](plugins/pm-caregiving) (care for aging parents — not medical/legal advice: [medical-appointment-advocate](skills/medical-appointment-advocate/SKILL.md), [caregiver-burnout-check](skills/caregiver-burnout-check/SKILL.md)), and [🤖 pm-ai-native](plugins/pm-ai-native) (use AI itself well: [prompt-library-builder](skills/prompt-library-builder/SKILL.md), [delegate-to-ai](skills/delegate-to-ai/SKILL.md), [spot-ai-mistakes](skills/spot-ai-mistakes/SKILL.md)) — 50 new skills; **1099 skills, 121 bundles**.
-
-**v73.0.0 — think differently:** two bundles that change *how* your AI reasons, not just what it does — [💭 pm-thinking](plugins/pm-thinking) (escape the generic answer: [the-third-answer](skills/the-third-answer/SKILL.md), [five-minds](skills/five-minds/SKILL.md), [red-team-my-plan](skills/red-team-my-plan/SKILL.md), [devils-advocate](skills/devils-advocate-on-demand/SKILL.md)) and [🎯 pm-focus](plugins/pm-focus) (ADHD-friendly executive function: [where-do-i-start](skills/where-do-i-start/SKILL.md), [overwhelm-triage](skills/overwhelm-triage/SKILL.md), [build-my-memory-file](skills/build-my-memory-file/SKILL.md)) — 50 skills inspired by parallel-divergent-ideation research; passes the 1,000 mark — now 1099 skills, 110 bundles.
-
-**v72.0.0 — the Everyday Life update:** the biggest single drop yet — **100 new skills** across four new bundles: [🎲 hobbies](plugins/pm-hobbies) (wine pairing, board-game nights, D&D), [💪 wellbeing](plugins/pm-wellbeing) (workouts, sleep, habits), [🔐 digital self-defense](plugins/pm-digital-safety) (identity-theft recovery, phishing triage, doxxing response), and [👪 family](plugins/pm-family) (new-baby logistics, wedding vows, condolences) — plus new money, legal, home, career, freelance and learning skills; **1099 skills, 108 bundles**.
+**[v76.2.1](https://github.com/mohitagw15856/pm-claude-skills/releases/latest)** — SkillCheck as a GitHub Action, and the design skills now compute their contrast numbers instead of estimating them.
 
-**v67.0.0 — the everywhere wave:** six new rooms — [the trades](plugins/pm-trades) (quotes, stage payments, apprentices), [the committee](plugins/pm-committee) (AGMs, treasurers, the council mic), [open-source maintainers](plugins/pm-maintainer), [aging parents](plugins/pm-aging-parents) (the talks, the sibling summit), [the kitchen](plugins/pm-kitchen), [the band](plugins/pm-musician) — plus [used-car](skills/used-car-decoder/SKILL.md)/[mechanic-quote](skills/mechanic-quote-decoder/SKILL.md) decoders, the [group-trip fixer](skills/group-trip-negotiator/SKILL.md), and [🌱 daily practice](https://mohitagw15856.github.io/pm-claude-skills/streak.html); 1099 skills, 104 bundles. *v66 — new-gen;* [pm-newgen](plugins/pm-newgen) — [decode your first brand deal](skills/creator-deal-decoder/SKILL.md), [clip the podcast](skills/clip-factory/SKILL.md), [prep tonight's D&D](skills/ttrpg-session-forge/SKILL.md), [fix the dating profile honestly](skills/dating-profile-doctor/SKILL.md), [vibe-check the weekend app](skills/the-vibe-check/SKILL.md), [keep the flat peaceful](skills/roommate-agreement/SKILL.md), [climb ranked on purpose](skills/ranked-climb-coach/SKILL.md), [flip thrift finds](skills/resale-flip-kit/SKILL.md), [plan the micro-retirement](skills/micro-retirement-planner/SKILL.md), [get your attention back](skills/attention-reset/SKILL.md); 1099 skills, 104 bundles. *v65 — pm-2027;* ten skills for problems you don't have yet (but will) — [offboard an AI coworker](skills/agent-severance/SKILL.md), [drill the deepfake wire-fraud call](skills/deepfake-drill/SKILL.md), [hire your agent like an employee](skills/agent-hiring-panel/SKILL.md), [declare context bankruptcy](skills/context-bankruptcy/SKILL.md), [send your position to meetings instead of your body](skills/clone-brief/SKILL.md), [publish your personal API](skills/api-for-yourself/SKILL.md), [simulate the reorg before announcing it](skills/the-org-simulator/SKILL.md); 1099 skills, 104 bundles. *v64 — game night;* [pm-tabletop](plugins/pm-tabletop) — teach any board game in 5 minutes, settle rules arguments fairly, plan the lineup, design your own game, and [spar the Catan trade](skills/tabletop-negotiator/SKILL.md) against a hidden agenda with a scored debrief; 1099 skills, 104 bundles. *v63.1 — pixel confetti:* [pixel-gif-maker](skills/pixel-gif-maker/SKILL.md) — custom retro Slack GIFs (scroll, pulse, party, sparkle) from a pure-stdlib deterministic encoder; 1099 skills. *And v63.0.0 — the dead mentors:* history's sharpest operators, resurrected as skills — **[Machiavelli](skills/machiavelli-counsel/SKILL.md)** reads your reorg (with the honest counterweight built in), **[Sun Tzu](skills/sun-tzu-strategy-brief/SKILL.md)** decides fight/reshape/decline, **[Franklin's decision algebra](skills/franklin-decision-ledger/SKILL.md)** settles the offer you keep flip-flopping on, **[Marcus Aurelius](skills/stoic-setback-debrief/SKILL.md)** debriefs the day that went badly, and **[Arnold Bennett (1908)](skills/bennett-time-audit/SKILL.md)** finds your inner day — real methods from public-domain classics, chapter-cited, never misquoted. *Earlier — v62.2, the distribution wave* (SkillScan, telemetry, SkillBench v2, quiz, wins, WhatsApp); *v62.1, nine frontiers.* Full history: **[CHANGELOG](CHANGELOG.md)** · [releases](https://github.com/mohitagw15856/pm-claude-skills/releases)
+Everything else is in the **[changelog](CHANGELOG.md)** and the
+**[releases](https://github.com/mohitagw15856/pm-claude-skills/releases)** — a
+README should say what this is, not what it was.
 
 ## ❓ First-timer questions, straight answers
 
 <details>
 <summary><b>Is it actually free?</b></summary>
-Yes — MIT, all 1099 skills, forever. The skills are markdown; there is nothing to gate. Sponsors fund the playground's free model runs, not access.
+Yes — MIT, all 1117 skills, forever. The skills are markdown; there is nothing to gate. Sponsors fund the playground's free model runs, not access.
 </details>
 
 <details>
@@ -424,4 +427,4 @@ MIT — use them, fork them, ship them at work. Skills are judgment, and judgmen
 
 ---
 
-*Built by [Mohit](https://github.com/mohitagw15856) with Claude. 1099 skills · 121 bundles · 35 professions · every commit gated. The long version of this README — every feature, wave, and frontier bet — lives in the **[Showcase](docs/SHOWCASE.md)**.*
+*Built by [Mohit](https://github.com/mohitagw15856) with Claude. 1117 skills · 121 bundles · 35 professions · every commit gated. The long version of this README — every feature, wave, and frontier bet — lives in the **[Showcase](docs/SHOWCASE.md)**.*

package/exports/README.md

@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
 node scripts/build-exports.mjs
 ```
 
-Currently exporting **1099 skills** to:
+Currently exporting **1117 skills** to:
 
 - **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
 - **Google Gemini — Gem instructions** → `exports/gemini/`

package/exports/aider/README.md

@@ -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.
 
-1099 skills exported. Copy a `.md rule` into the tool to use it.
+1117 skills exported. Copy a `.md rule` into the tool to use it.
 
 | Skill | Bundle | Path |
 |---|---|---|
@@ -33,6 +33,7 @@
 | Aging-in-Place Assessment | `pm-caregiving` | `pm-caregiving/aging-in-place-assessment/aging-in-place-assessment.md` |
 | Aging Parent Talks | `pm-aging-parents` | `pm-aging-parents/aging-parent-talks/aging-parent-talks.md` |
 | AGM In A Box | `pm-committee` | `pm-committee/agm-in-a-box/agm-in-a-box.md` |
+| AI-Agent Reliability | `pm-ai-native` | `pm-ai-native/ai-agent-reliability/ai-agent-reliability.md` |
 | AI-Assisted Performance Review | `pm-aiwork` | `pm-aiwork/ai-assisted-performance-review/ai-assisted-performance-review.md` |
 | AI Code Review | `pm-engineering` | `pm-engineering/ai-code-review/ai-code-review.md` |
 | AI Content Audit | `pm-aiwork` | `pm-aiwork/ai-content-audit/ai-content-audit.md` |
@@ -79,8 +80,10 @@
 | Backup Strategy | `pm-digital-safety` | `pm-digital-safety/backup-strategy/backup-strategy.md` |
 | Band Agreement | `pm-musician` | `pm-musician/band-agreement/band-agreement.md` |
 | Bank Fee Refund | `pm-money` | `pm-money/bank-fee-refund/bank-fee-refund.md` |
+| Bankruptcy Decision | `pm-hardship` | `pm-hardship/bankruptcy-decision/bankruptcy-decision.md` |
 | Behavior Intervention Plan | `pm-teaching` | `pm-teaching/behavior-intervention-plan/behavior-intervention-plan.md` |
 | Beneficiary Audit | `pm-estate` | `pm-estate/beneficiary-audit/beneficiary-audit.md` |
+| Benefits-Cliff Check | `pm-hardship` | `pm-hardship/benefits-cliff-check/benefits-cliff-check.md` |
 | Benefits Decoder | `pm-decoders` | `pm-decoders/benefits-decoder/benefits-decoder.md` |
 | Bennett Time Audit | `pm-dead-mentors` | `pm-dead-mentors/bennett-time-audit/bennett-time-audit.md` |
 | Bid / Tender Review | `pm-construction` | `pm-construction/bid-tender-review/bid-tender-review.md` |
@@ -155,6 +158,7 @@
 | Claim Denial Decoder | `pm-decoders` | `pm-decoders/claim-denial-decoder/claim-denial-decoder.md` |
 | Claims Triage | `pm-insurance` | `pm-insurance/claims-triage/claims-triage.md` |
 | Class-Action Claim Finder | `pm-money` | `pm-money/class-action-claim-finder/class-action-claim-finder.md` |
+| Claude Project Setup | `pm-ai-native` | `pm-ai-native/claude-project-setup/claude-project-setup.md` |
 | Claude Superpowers | `pm-engineering` | `pm-engineering/claude-superpowers/claude-superpowers.md` |
 | Clause Explainer | `pm-legal` | `pm-legal/clause-explainer/clause-explainer.md` |
 | Client Discharge Notes | `pm-veterinary` | `pm-veterinary/client-discharge-notes/client-discharge-notes.md` |
@@ -257,6 +261,7 @@
 | Daycare vs Stay-Home | `pm-calculators` | `pm-calculators/daycare-vs-stay-home/daycare-vs-stay-home.md` |
 | dbt Model Spec | `pm-dataeng` | `pm-dataeng/dbt-model-spec/dbt-model-spec.md` |
 | Debt Collector Response | `pm-money` | `pm-money/debt-collector-response/debt-collector-response.md` |
+| Debt-Collector Scripts | `pm-hardship` | `pm-hardship/debt-collector-scripts/debt-collector-scripts.md` |
 | Debt Payoff | `pm-calculators` | `pm-calculators/debt-payoff/debt-payoff.md` |
 | Debt Payoff Plan | `pm-money` | `pm-money/debt-payoff-plan/debt-payoff-plan.md` |
 | Debugging Log Analyser | `pm-engineering` | `pm-engineering/debugging-log-analyser/debugging-log-analyser.md` |
@@ -354,6 +359,7 @@
 | ESG Disclosure Draft | `pm-climate` | `pm-climate/esg-disclosure-draft/esg-disclosure-draft.md` |
 | Estate Planning Kit | `pm-money` | `pm-money/estate-planning-kit/estate-planning-kit.md` |
 | Estate Settlement Organizer | `pm-estate` | `pm-estate/estate-settlement-organizer/estate-settlement-organizer.md` |
+| Eulogy & Obituary Writer | `pm-grief` | `pm-grief/eulogy-and-obituary-writer/eulogy-and-obituary-writer.md` |
 | Eulogy Writer | `pm-lifeadmin` | `pm-lifeadmin/eulogy-writer/eulogy-writer.md` |
 | Euthanasia Conversation | `pm-veterinary` | `pm-veterinary/euthanasia-conversation/euthanasia-conversation.md` |
 | EV vs Gas | `pm-calculators` | `pm-calculators/ev-vs-gas/ev-vs-gas.md` |
@@ -382,6 +388,7 @@
 | Explain My Decision To Me | `pm-thinking` | `pm-thinking/explain-my-decision-to-me/explain-my-decision-to-me.md` |
 | Explain Simply | `pm-comms` | `pm-comms/explain-simply/explain-simply.md` |
 | Exploratory Test Charter | `pm-qa` | `pm-qa/exploratory-test-charter/exploratory-test-charter.md` |
+| Expungement Navigator | `pm-reentry` | `pm-reentry/expungement-navigator/expungement-navigator.md` |
 | Fact-Check Pass | `pm-journalism` | `pm-journalism/fact-check-pass/fact-check-pass.md` |
 | Factory Acceptance Test | `pm-hardware` | `pm-hardware/factory-acceptance-test/factory-acceptance-test.md` |
 | Faith Transition Companion | `pm-identity` | `pm-identity/faith-transition-companion/faith-transition-companion.md` |
@@ -413,6 +420,7 @@
 | Fine Appeal Letter | `pm-lifeadmin` | `pm-lifeadmin/fine-appeal-letter/fine-appeal-letter.md` |
 | FIRE Number | `pm-calculators` | `pm-calculators/fire-number/fire-number.md` |
 | First 100k Plan | `pm-wealth` | `pm-wealth/first-100k-plan/first-100k-plan.md` |
+| First 90 Days Out | `pm-reentry` | `pm-reentry/first-90-days-out/first-90-days-out.md` |
 | First Client Contract | `pm-sidehustle` | `pm-sidehustle/first-client-contract/first-client-contract.md` |
 | First-Hire Plan | `pm-career` | `pm-career/first-hire-plan/first-hire-plan.md` |
 | First Maintainer Month | `pm-maintainer` | `pm-maintainer/first-maintainer-month/first-maintainer-month.md` |
@@ -457,6 +465,7 @@
 | Gratitude Practice | `pm-wellbeing` | `pm-wellbeing/gratitude-practice/gratitude-practice.md` |
 | Greenwashing Self-Audit | `pm-climate` | `pm-climate/greenwashing-self-audit/greenwashing-self-audit.md` |
 | Grief Admin | `other` | `other/grief-admin/grief-admin.md` |
+| Grieving at Work | `pm-grief` | `pm-grief/grieving-at-work/grieving-at-work.md` |
 | Grocery Budget Audit | `pm-kitchen` | `pm-kitchen/grocery-budget-audit/grocery-budget-audit.md` |
 | Group Trip Negotiator | `other` | `other/group-trip-negotiator/group-trip-negotiator.md` |
 | Growth Experiment Backlog | `pm-growth` | `pm-growth/growth-experiment-backlog/growth-experiment-backlog.md` |
@@ -485,6 +494,7 @@
 | Hospital-Stay Plan | `pm-caregiving` | `pm-caregiving/hospital-stay-plan/hospital-stay-plan.md` |
 | House Style Enforcer | `pm-cowork` | `pm-cowork/house-style-enforcer/house-style-enforcer.md` |
 | Houseplant Care | `pm-hobbies` | `pm-hobbies/houseplant-care/houseplant-care.md` |
+| Housing With a Record | `pm-reentry` | `pm-reentry/housing-with-a-record/housing-with-a-record.md` |
 | Human-in-the-Loop Design | `pm-agentnative` | `pm-agentnative/human-in-the-loop-design/human-in-the-loop-design.md` |
 | Hydration & Energy Plan | `pm-wellbeing` | `pm-wellbeing/hydration-and-energy-plan/hydration-and-energy-plan.md` |
 | Hyperfocus Exit | `pm-focus` | `pm-focus/hyperfocus-exit/hyperfocus-exit.md` |
@@ -534,6 +544,7 @@
 | JD Decoder | `pm-jobsearch` | `pm-jobsearch/jd-decoder/jd-decoder.md` |
 | Job Application | `pm-business` | `pm-business/job-application/job-application.md` |
 | Job Description Writer | `pm-hr` | `pm-hr/job-description-writer/job-description-writer.md` |
+| Job Search With a Record | `pm-reentry` | `pm-reentry/job-search-with-a-record/job-search-with-a-record.md` |
 | Job Story Mapper | `pm-discovery` | `pm-discovery/job-story-mapper/job-story-mapper.md` |
 | Journaling Prompts | `pm-wellbeing` | `pm-wellbeing/journaling-prompts/journaling-prompts.md` |
 | Jury Duty Guide | `pm-legal` | `pm-legal/jury-duty-guide/jury-duty-guide.md` |
@@ -652,6 +663,7 @@
 | Note-Taking System | `pm-learning` | `pm-learning/note-taking-system/note-taking-system.md` |
 | NotebookLM Connector | `pm-cross` | `pm-cross/notebooklm-connector/notebooklm-connector.md` |
 | Notes Humanizer | `pm-writers` | `pm-writers/notes-humanizer/notes-humanizer.md` |
+| Notify Everyone of a Death | `pm-grief` | `pm-grief/notify-everyone-of-a-death/notify-everyone-of-a-death.md` |
 | Notion DB Hygiene (Live) | `pm-cowork-live` | `pm-cowork-live/notion-db-hygiene/notion-db-hygiene.md` |
 | NT Translator | `pm-neurodivergent` | `pm-neurodivergent/nt-translator/nt-translator.md` |
 | Offer Comparison | `pm-calculators` | `pm-calculators/offer-comparison/offer-comparison.md` |
@@ -752,6 +764,7 @@
 | 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` |
 | Promotion Plan | `pm-ecommerce` | `pm-ecommerce/promotion-plan/promotion-plan.md` |
+| Prompt Debugging | `pm-ai-native` | `pm-ai-native/prompt-debugging/prompt-debugging.md` |
 | Prompt-Library Builder | `pm-ai-native` | `pm-ai-native/prompt-library-builder/prompt-library-builder.md` |
 | Prompt Optimizer | `pm-ai` | `pm-ai/prompt-optimizer/prompt-optimizer.md` |
 | Prompt Regression Suite | `pm-agentops` | `pm-agentops/prompt-regression-suite/prompt-regression-suite.md` |
@@ -784,6 +797,7 @@
 | Reading Retention System | `pm-learning` | `pm-learning/reading-retention-system/reading-retention-system.md` |
 | README Writer | `pm-devrel` | `pm-devrel/readme-writer/readme-writer.md` |
 | Receipts Audit | `pm-method` | `pm-method/receipts-audit/receipts-audit.md` |
+| Reconnect After Time Away | `pm-reentry` | `pm-reentry/reconnect-after-time-away/reconnect-after-time-away.md` |
 | Reconnect With Someone | `other` | `other/reconnect-with-someone/reconnect-with-someone.md` |
 | Recovery Day Planner | `pm-wellbeing` | `pm-wellbeing/recovery-day-planner/recovery-day-planner.md` |
 | Recruiter Outreach | `pm-recruiting` | `pm-recruiting/recruiter-outreach/recruiter-outreach.md` |
@@ -949,6 +963,7 @@
 | Stock Snapshot | `pm-live` | `pm-live/stock-snapshot/stock-snapshot.md` |
 | Stoic Setback Debrief | `pm-dead-mentors` | `pm-dead-mentors/stoic-setback-debrief/stoic-setback-debrief.md` |
 | Stop Overthinking This | `pm-focus` | `pm-focus/stop-overthinking-this/stop-overthinking-this.md` |
+| Stop-the-Bleed Triage | `pm-hardship` | `pm-hardship/stop-the-bleed-triage/stop-the-bleed-triage.md` |
 | Story Pitch | `pm-journalism` | `pm-journalism/story-pitch/story-pitch.md` |
 | Strategic Narrative Generator | `pm-strategy` | `pm-strategy/strategic-narrative-generator/strategic-narrative-generator.md` |
 | Strategy Memo | `pm-business` | `pm-business/strategy-memo/strategy-memo.md` |
@@ -971,6 +986,7 @@
 | Support Macro | `pm-support` | `pm-support/support-macro/support-macro.md` |
 | Support Runbook | `pm-support` | `pm-support/support-runbook/support-runbook.md` |
 | Support Staffing Model | `pm-calculators` | `pm-calculators/support-staffing-model/support-staffing-model.md` |
+| Support the Bereaved | `pm-grief` | `pm-grief/support-the-bereaved/support-the-bereaved.md` |
 | Survey Design Basics | `pm-cowork` | `pm-cowork/survey-design-basics/survey-design-basics.md` |
 | Sycophancy Challenger | `pm-cross` | `pm-cross/sycophancy-challenger/sycophancy-challenger.md` |
 | Synthetic User Research | `pm-research` | `pm-research/synthetic-user-research/synthetic-user-research.md` |
@@ -1022,6 +1038,7 @@
 | The Vibe Check | `pm-newgen` | `pm-newgen/the-vibe-check/the-vibe-check.md` |
 | The Visa Interview | `pm-simulators` | `pm-simulators/the-visa-interview/the-visa-interview.md` |
 | The Worry Decompiler | `pm-focus` | `pm-focus/the-worry-decompiler/the-worry-decompiler.md` |
+| The Year of Firsts | `pm-grief` | `pm-grief/the-year-of-firsts/the-year-of-firsts.md` |
 | Thesis Outline | `pm-students` | `pm-students/thesis-outline/thesis-outline.md` |
 | Think From Another Angle | `pm-thinking` | `pm-thinking/think-from-another-angle/think-from-another-angle.md` |
 | Thread To Decision | `pm-cowork` | `pm-cowork/thread-to-decision/thread-to-decision.md` |
@@ -1073,6 +1090,7 @@
 | Volunteer Treasurer Basics | `pm-committee` | `pm-committee/volunteer-treasurer-basics/volunteer-treasurer-basics.md` |
 | Voting Navigator | `pm-civic` | `pm-civic/voting-navigator/voting-navigator.md` |
 | Vulnerability Triage | `pm-security` | `pm-security/vuln-triage/vuln-triage.md` |
+| Wage-Garnishment Response | `pm-hardship` | `pm-hardship/wage-garnishment-response/wage-garnishment-response.md` |
 | Warranty Claim | `pm-money` | `pm-money/warranty-claim/warranty-claim.md` |
 | Weather Now | `pm-live` | `pm-live/weather-now/weather-now.md` |
 | Wedding Budget | `pm-wedding` | `pm-wedding/wedding-budget/wedding-budget.md` |

package/exports/aider/pm-ai-native/ai-agent-reliability/ai-agent-reliability.md

@@ -0,0 +1,61 @@
+# AI-Agent Reliability
+
+An AI agent that works in a demo and one you can trust in production are different things — the gap is everything that happens when input is messy, the model hallucinates, a tool call goes wrong, or an error fails silently. This maps where your agent can fail and the specific checks that catch each, scaled to the stakes, plus a rollout that earns trust incrementally — so "works sometimes" becomes "works reliably."
+
+## What This Skill Produces
+
+- **A failure map** — where this agent can go wrong: bad/unexpected input, hallucinated output, wrong or malformed tool calls, unhandled edge cases, silent failures, and runaway loops
+- **The catching checks per failure** — input validation, output verification, evals on real cases, schema/format checks on tool calls, human-in-the-loop gates, and monitoring/alerts
+- **An eval approach** — testing on a real set of cases (including the hard ones) so quality is measured, not assumed, and regressions are caught
+- **Human-in-the-loop placement** — where a human must approve, scaled to consequence (irreversible/external actions gated, low-stakes automated)
+- **A right-sized plan** — reliability effort matched to the stakes, not gold-plating a low-risk toy or under-testing a high-risk system
+- **A trust-building rollout** — shadow mode → low-stakes → expand, with monitoring, rather than shipping it everywhere and hoping
+
+## Required Inputs
+
+Ask for these if not provided:
+- **The agent** — what it does, what tools/actions it takes, what it touches
+- **The stakes** — what a failure costs (drives how hard to test and gate)
+- **Where it fails now** — the flakiness you've seen (points at the weak spots)
+- **Your setup** — the framework/tools, and whether you can add evals/monitoring
+
+## Framework: Map Failures, Catch Each, Earn Trust
+
+1. **Enumerate the failure modes.** Walk the agent's path — input, reasoning, tool calls, output, actions — and name where each step can break. You can't guard what you haven't named.
+2. **Attach a check to each.** Validation for input, verification for output, schema checks for tool calls, evals for quality, gates for consequential actions — a specific catch per failure.
+3. **Build real evals.** A set of representative and hard cases, scored — so you know it works and catch regressions before users do.
+4. **Gate by consequence.** Irreversible or external actions get a human check; low-stakes steps run free. Match the gate to the cost.
+5. **Right-size it.** Don't over-engineer a low-risk helper or under-test a system that moves money or data — effort follows stakes.
+6. **Roll out to earn trust.** Shadow mode, then low-stakes live, then expand — with monitoring and alerts — so reliability is proven, not assumed.
+
+## Output Format
+
+### Agent reliability: [what it does] · stakes [level]
+
+**Failure map:** [bad input · hallucination · wrong tool call · edge cases · silent errors · runaway loops].
+**Catch each:** [failure → the check: validation / verification / schema / eval / human gate / monitor].
+**Evals:** [the real + hard cases to test on, scored].
+**Human gates:** [the consequential actions that need approval].
+**Right-sized:** [effort matched to stakes — where to invest, where not].
+**Rollout:** [shadow → low-stakes → expand, with monitoring].
+
+## Quality Checks
+- [ ] Enumerates failure modes across the agent's whole path
+- [ ] Attaches a specific check to each failure
+- [ ] Includes evals on real and hard cases, scored
+- [ ] Gates consequential actions with a human; automates low-stakes
+- [ ] Scales effort to stakes; rolls out to build trust incrementally
+
+## Anti-Patterns
+- **Shipping a demo** as if it's production-ready.
+- **No evals** — quality assumed, regressions invisible.
+- **The same trust level** for a summary and a money transfer.
+- **Gold-plating a toy** or under-testing a high-stakes system.
+- **Big-bang launch** with no shadow mode or monitoring.
+
+## Example Trigger Phrases
+- "How do I test my AI agent so I can actually trust it?"
+- "My automation works sometimes — how do I make it reliable?"
+- "How do I put an AI workflow into production safely?"
+- "What checks does my agent need before I let it run on real data?"
+- "How do I know my agent won't do something dumb and irreversible?"

package/exports/aider/pm-ai-native/claude-project-setup/claude-project-setup.md

@@ -0,0 +1,62 @@
+# Claude Project Setup
+
+An AI coding agent is only as good as the context it starts with — drop it into a repo with no orientation and it guesses at your architecture, conventions, and commands. A good CLAUDE.md (or equivalent project-context file) is the onboarding doc that turns flailing into fluency. This builds yours: the architecture and conventions the agent needs, the commands to run, the guardrails on what not to touch, and a habit to keep it current.
+
+## What This Skill Produces
+
+- **A structured CLAUDE.md** — the sections an agent actually needs: what the project is, architecture/layout, key conventions, the commands (build/test/lint/run), and the do-nots
+- **The right altitude** — enough to orient the agent fast, not an exhaustive doc it drowns in; signal over completeness
+- **Guardrails** — what the agent must not touch, how to run tests before claiming done, and where irreversible actions need a human
+- **Convention capture** — the implicit rules a human learns over months (naming, patterns, where things go) made explicit
+- **A commands block** — the exact commands to build, test, lint, and run, so the agent verifies its own work
+- **A maintenance habit** — updating it as the project changes so it doesn't drift into wrong
+
+## Required Inputs
+
+Ask for these if not provided:
+- **The project** — what it is, the stack, rough architecture
+- **The conventions** — the patterns and rules you'd tell a new hire
+- **The commands** — how to build, test, lint, run
+- **The danger zones** — what an agent should never touch or must be careful with
+- **Your agent** — Claude Code, Cursor, etc. (file name/location may differ)
+
+## Framework: Orient, Constrain, Verify, Maintain
+
+1. **Orient fast.** Lead with what the project is and its architecture at a glance — the agent needs the map before the details.
+2. **Capture the implicit conventions.** The rules a human absorbs over months (where files go, naming, preferred patterns) are exactly what an agent can't infer — write them down.
+3. **Give the commands.** Build/test/lint/run commands let the agent verify its own work instead of guessing — this single section prevents most bad output.
+4. **Set guardrails.** What not to touch, always-run-tests-before-done, and where a human must approve — so autonomy doesn't become damage.
+5. **Keep the altitude right.** Enough to be useful, short enough to be read — prune anything that doesn't change the agent's behavior.
+6. **Maintain it.** Update as the project evolves; a stale context file is worse than none because it misleads.
+
+## Output Format
+
+### CLAUDE.md for [project]
+
+**What this is:** [one-paragraph orientation + architecture at a glance].
+**Layout:** [key directories/modules and what they do].
+**Conventions:** [naming · patterns · where things go · style].
+**Commands:** `build:` · `test:` · `lint:` · `run:`.
+**Guardrails:** [do-not-touch · run tests before done · human-approval zones].
+**Maintenance:** [update when X changes — keep it current].
+
+## Quality Checks
+- [ ] Orients the agent to purpose and architecture first
+- [ ] Makes implicit conventions explicit
+- [ ] Includes the exact build/test/lint/run commands
+- [ ] Sets guardrails on danger zones and verification
+- [ ] Keeps the doc at a readable altitude; sets a maintenance habit
+
+## Anti-Patterns
+- **A novel** the agent won't read, or a stub that orients nothing.
+- **Omitting the commands**, so the agent can't verify its work.
+- **Missing guardrails** on irreversible or dangerous actions.
+- **Assuming the agent infers conventions** it has no way to know.
+- **Writing it once** and letting it drift out of date.
+
+## Example Trigger Phrases
+- "How do I set up a CLAUDE.md for my repo?"
+- "Configure my project so Claude Code works well in it."
+- "My AI agent keeps misunderstanding my codebase — how do I fix that?"
+- "What should go in my project's AI context file?"
+- "Onboard an AI coding agent to my project properly."

package/exports/aider/pm-ai-native/prompt-debugging/prompt-debugging.md

@@ -0,0 +1,63 @@
+# Prompt Debugging
+
+When a prompt misbehaves, most people randomly reword it until something sticks — slow, and it doesn't teach you anything. Prompts fail in diagnosable ways: ambiguity, missing context, a format the model can't follow, or instructions that contradict each other. This finds the actual failure, applies the targeted fix, and names the principle — so you fix it once and stop hitting the same wall.
+
+## What This Skill Produces
+
+- **A diagnosis** — the specific failure mode: ambiguous ask, missing context, unspecified output format, conflicting instructions, buried key instruction, or too much at once
+- **The targeted fix** — the change that addresses *that* failure, not a superstitious reword
+- **A corrected prompt** — rewritten to fix the diagnosed problem, with the change explained
+- **A generalization check** — testing that the fix works across cases, not just the one example (the trap of overfitting to a single output)
+- **The principle** — the underlying rule (be specific, show the format, resolve conflicts, front-load the key instruction) so you recognize it next time
+- **When it's the model, not the prompt** — the honest call when the task is beyond what prompting fixes
+
+## Required Inputs
+
+Ask for these if not provided:
+- **The prompt** — the actual text that's misbehaving
+- **What it's doing wrong** — ignoring an instruction, wrong format, inconsistent, off-topic
+- **What you want** — the correct output, ideally with an example
+- **The pattern** — does it fail always or sometimes (points at ambiguity vs. a hard miss)
+
+## Framework: Diagnose Before You Reword
+
+1. **Name the failure mode.** Match the symptom to a cause — ignored instructions often mean it's buried or conflicting; inconsistent output usually means ambiguity; wrong shape means the format wasn't specified.
+2. **Fix that cause specifically.** Ambiguous → add specificity; missing context → add it; no format → show the exact format; conflict → resolve it; buried → move the key instruction up front.
+3. **Show, don't just tell.** For format and quality problems, an example of the desired output fixes more than paragraphs of description.
+4. **Check it generalizes.** Re-test on several cases — a fix that only works on your one example is overfitting, not a fix.
+5. **Extract the principle.** Name the rule behind the fix so the next prompt starts right.
+6. **Know when to stop.** If the task genuinely exceeds the model or needs tools/context it can't have, say so instead of endless rewording.
+
+## Output Format
+
+### Prompt debug: [what's failing]
+
+**Diagnosis:** [the specific failure mode — ambiguity / missing context / no format / conflict / buried / overloaded].
+**The fix:** [the targeted change for that cause].
+**Corrected prompt:**
+> [rewritten prompt].
+
+**Generalization check:** [test across cases, not just the one example].
+**Principle:** [the rule — so you avoid it next time].
+**If it's not the prompt:** [when the task exceeds prompting → what's actually needed].
+
+## Quality Checks
+- [ ] Diagnoses a specific failure mode before rewriting
+- [ ] Applies the fix that matches the cause
+- [ ] Uses an example where the problem is format/quality
+- [ ] Checks the fix generalizes beyond one case
+- [ ] Names the principle; flags when it's a model limit, not a prompt one
+
+## Anti-Patterns
+- **Randomly rewording** until something works, learning nothing.
+- **Fixing to one example** and overfitting.
+- **Adding more words** when the issue is a conflict or buried instruction.
+- **Describing the format** instead of showing it.
+- **Blaming the model** when the prompt is fixable — or the reverse.
+
+## Example Trigger Phrases
+- "Why isn't my prompt working?"
+- "The AI keeps ignoring one of my instructions — why?"
+- "My prompt gives me different results every time."
+- "Help me fix this prompt, it's not doing what I want."
+- "How do I get consistent output from this prompt?"

package/exports/aider/pm-grief/eulogy-and-obituary-writer/eulogy-and-obituary-writer.md

@@ -0,0 +1,63 @@
+# Eulogy & Obituary Writer
+
+When you have to put a whole person into words while grieving, the blank page is cruel. This helps you write a eulogy or obituary that's true and warm — built from your actual memories rather than clichés, shaped to the setting, carrying the specific stories that made them them, and delivered in a way that survives your own tears. You bring the memories; this helps them become the piece.
+
+## What This Skill Produces
+
+- **A draft in your voice** — a eulogy or obituary written from the details and stories you share, not generic filler
+- **The right shape** — structure and length for the setting (a spoken eulogy vs. a printed obituary), so it fits the moment
+- **The details that make it theirs** — the specific quirks, phrases, and moments that bring them to life better than adjectives
+- **Tone guidance** — the balance of grief and warmth (and humor, if it's true to them), pitched to the audience
+- **Delivery help (eulogy)** — length for speaking, how to handle breaking down, a printed copy, a backup reader
+- **Obituary essentials** — the facts, survivors, and service/donation details an obituary needs, in the conventional order
+
+## Required Inputs
+
+Ask for these if not provided:
+- **Who they were** — name, relationship to you, a few facts (age, what they did, who survives them)
+- **Your memories** — stories, quirks, phrases, moments — the raw material (the more specific, the better)
+- **The setting** — spoken eulogy or printed obituary, audience, and any length limit
+- **The tone you want** — solemn, warm, a little funny — whatever is true to them
+
+## Framework: Their Specifics Over Clichés
+
+1. **Gather the specifics.** The one story only you know beats every "she was a loving mother." Draw out concrete memories, phrases, habits — those are the piece.
+2. **Choose the shape.** Eulogy (spoken, personal, ~3–5 minutes) vs. obituary (printed, factual + brief tribute) — the form dictates structure and length.
+3. **Open with something true and small.** A specific image or line pulls people in more than a grand statement.
+4. **Build around a few stories.** Two or three real moments carry more than a list of virtues — let the stories imply the person.
+5. **Match the tone to them.** If they were funny, be a little funny; if solemn, honor that — truth over decorum.
+6. **Prepare the delivery.** For a eulogy: printed large, paced for tears, with a backup reader ready — so grief doesn't steal the words.
+
+## Output Format
+
+### For [name] — [eulogy / obituary]
+
+**Draft:**
+> [the piece, in the writer's voice, built from their memories]
+
+**Why it's shaped this way:** [structure/length for the setting].
+**Details that made it theirs:** [the specific stories/quirks used].
+**Tone:** [solemn / warm / lightly funny — matched to them].
+**Delivery (eulogy):** [print large · pace for tears · backup reader ready].
+**Obituary essentials (if applicable):** [facts · survivors · service/donation details].
+
+## Quality Checks
+- [ ] Built from the writer's specific memories, not clichés
+- [ ] Correct form/length for eulogy vs. obituary
+- [ ] Anchored in two or three real stories
+- [ ] Tone true to the person, in the writer's voice
+- [ ] Includes delivery help (eulogy) or the required facts (obituary)
+
+## Anti-Patterns
+- **Generic virtues** ("kind, loving, generous") with no specifics.
+- **Cramming in everything** instead of a few resonant stories.
+- **A tone that isn't theirs** — solemn for someone who was joyful.
+- **Forgetting delivery** — an unreadable wall of text at the podium.
+- **Missing obituary facts** — survivors, service details, donations.
+
+## Example Trigger Phrases
+- "Help me write a eulogy for my father."
+- "I have to speak at the funeral and I don't know where to start."
+- "Write an obituary for my grandmother."
+- "I don't know how to put who she was into words."
+- "How long should a eulogy be and how do I get through it?"