pm-claude-skills 61.2.2 → 61.3.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 (68) hide show
  1. package/README.md +5 -5
  2. package/exports/README.md +1 -1
  3. package/exports/aider/README.md +4 -1
  4. package/exports/aider/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
  5. package/exports/aider/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
  6. package/exports/aider/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
  7. package/exports/chatgpt/README.md +4 -1
  8. package/exports/chatgpt/pm-devrel/deprecation-comms-plan/SYSTEM_PROMPT.md +65 -0
  9. package/exports/chatgpt/pm-recruiting/reference-check-script/SYSTEM_PROMPT.md +62 -0
  10. package/exports/chatgpt/pm-social/community-moderation-policy/SYSTEM_PROMPT.md +59 -0
  11. package/exports/cline/README.md +4 -1
  12. package/exports/cline/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
  13. package/exports/cline/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
  14. package/exports/cline/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
  15. package/exports/continue/README.md +4 -1
  16. package/exports/continue/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +70 -0
  17. package/exports/continue/pm-recruiting/reference-check-script/reference-check-script.md +67 -0
  18. package/exports/continue/pm-social/community-moderation-policy/community-moderation-policy.md +64 -0
  19. package/exports/cursor/README.md +4 -1
  20. package/exports/cursor/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.mdc +71 -0
  21. package/exports/cursor/pm-recruiting/reference-check-script/reference-check-script.mdc +68 -0
  22. package/exports/cursor/pm-social/community-moderation-policy/community-moderation-policy.mdc +65 -0
  23. package/exports/gemini/README.md +4 -1
  24. package/exports/gemini/pm-devrel/deprecation-comms-plan/GEM_INSTRUCTIONS.md +69 -0
  25. package/exports/gemini/pm-recruiting/reference-check-script/GEM_INSTRUCTIONS.md +66 -0
  26. package/exports/gemini/pm-social/community-moderation-policy/GEM_INSTRUCTIONS.md +63 -0
  27. package/exports/kilocode/README.md +4 -1
  28. package/exports/kilocode/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
  29. package/exports/kilocode/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
  30. package/exports/kilocode/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
  31. package/exports/obsidian/README.md +4 -1
  32. package/exports/obsidian/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +80 -0
  33. package/exports/obsidian/pm-recruiting/reference-check-script/reference-check-script.md +77 -0
  34. package/exports/obsidian/pm-social/community-moderation-policy/community-moderation-policy.md +74 -0
  35. package/exports/openclaw/README.md +4 -1
  36. package/exports/openclaw/community-moderation-policy/SKILL.md +69 -0
  37. package/exports/openclaw/deprecation-comms-plan/SKILL.md +75 -0
  38. package/exports/openclaw/reference-check-script/SKILL.md +72 -0
  39. package/exports/roo/README.md +4 -1
  40. package/exports/roo/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
  41. package/exports/roo/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
  42. package/exports/roo/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
  43. package/exports/windsurf/README.md +4 -1
  44. package/exports/windsurf/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +70 -0
  45. package/exports/windsurf/pm-recruiting/reference-check-script/reference-check-script.md +67 -0
  46. package/exports/windsurf/pm-social/community-moderation-policy/community-moderation-policy.md +64 -0
  47. package/exports/zed/README.md +4 -1
  48. package/exports/zed/pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md +65 -0
  49. package/exports/zed/pm-recruiting/reference-check-script/reference-check-script.md +62 -0
  50. package/exports/zed/pm-social/community-moderation-policy/community-moderation-policy.md +59 -0
  51. package/package.json +2 -2
  52. package/skills/community-moderation-policy/SKILL.md +64 -0
  53. package/skills/deprecation-comms-plan/SKILL.md +70 -0
  54. package/skills/reference-check-script/SKILL.md +67 -0
  55. package/web/benchmark.html +1 -1
  56. package/web/cheatsheet.html +4 -4
  57. package/web/city.html +1 -1
  58. package/web/galaxy.html +1 -1
  59. package/web/galaxy3d.html +2 -2
  60. package/web/guide.html +5 -5
  61. package/web/handbook.html +3 -3
  62. package/web/holo.html +2 -2
  63. package/web/index.html +3 -3
  64. package/web/learn.html +1 -1
  65. package/web/remix.html +1 -1
  66. package/web/semantic.html +2 -2
  67. package/web/skills.json +1 -1
  68. package/web/voice.html +1 -1
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # 🧠 PM Skills — 751 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
1
+ # 🧠 PM Skills — 754 Professional Agent Skills for Claude, ChatGPT, Gemini, Cursor, Codex & Hermes
2
2
 
3
3
  [![In the official Anthropic plugin directory](https://img.shields.io/badge/Anthropic%20Plugin%20Directory-Published-D97757?logo=anthropic&logoColor=white)](#-quick-start)
4
4
  [![Stars](https://img.shields.io/github/stars/mohitagw15856/pm-claude-skills?style=social)](https://github.com/mohitagw15856/pm-claude-skills/stargazers)
@@ -12,7 +12,7 @@
12
12
  [![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
13
13
  [![Sponsor](https://img.shields.io/badge/sponsor-❤️-ff69b4)](https://github.com/sponsors/mohitagw15856)
14
14
 
15
- **A library of 751 skills — each one a plain `SKILL.md` file that teaches your AI assistant to do one professional task properly.** 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.
15
+ **A library of 754 skills — each one a plain `SKILL.md` file that teaches your AI assistant to do one professional task properly.** 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.
16
16
 
17
17
  Works natively in **Claude Code** and **Hermes Agent**, with ready-to-paste exports for **ChatGPT, Gemini, Cursor, Codex** and 8 more tools. *(PM stands for Professional, not just Product Management.)*
18
18
 
@@ -30,7 +30,7 @@ No `npm install` needed — `npx pm-claude-skills …` always runs the latest. `
30
30
 
31
31
  ## 📚 The skills
32
32
 
33
- 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 751 pass the [SkillSpec](SKILLSPEC.md) L3 gate and a security audit in CI.
33
+ 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 754 pass the [SkillSpec](SKILLSPEC.md) L3 gate and a security audit in CI.
34
34
 
35
35
  ### For everyone — life's paperwork and decisions
36
36
 
@@ -155,7 +155,7 @@ The whole library on one poster — start path, standout features, and install o
155
155
 
156
156
  ## 🆕 Latest
157
157
 
158
- **v61.2.2 — long-form video:** **[youtube-script](skills/youtube-script/SKILL.md)** — a full YouTube script (explainer/tutorial/video essay) engineered for watch-time: title + thumbnail concepts, a timed cold open, retention beats with B-roll cues, and chapter timestamps. Sibling to [short-form-script](skills/short-form-script/SKILL.md); for other languages, [professional-translator](skills/professional-translator/SKILL.md). *Earlier — v61.2, the builder's toolkit:* prove quality against real references, red-team robustness, test skills before a PR, run them offline, and sign what they produce. *v61.1, the demand side:* **[find](https://mohitagw15856.github.io/pm-claude-skills/find.html)** (task→skill router) with an honest per-skill **measured / no-claim** badge, per-skill versioning, and **[SkillSpec as an adoptable standard](conformance/REGISTRY.md)** (earnable `--badge` + public registry). Full history: **[CHANGELOG](CHANGELOG.md)** · [releases](https://github.com/mohitagw15856/pm-claude-skills/releases)
158
+ **v61.3.0 — most-requested:** three skills built straight from the demand queue — **[reference-check-script](skills/reference-check-script/SKILL.md)** (rigorous candidate reference calls with a scoring rubric), **[deprecation-comms-plan](skills/deprecation-comms-plan/SKILL.md)** (the customer-comms program for sunsetting an API/feature), and **[community-moderation-policy](skills/community-moderation-policy/SKILL.md)** (a fair, enforceable moderation policy + enforcement ladder for a user community). *Earlier — v61.2.2:* **[youtube-script](skills/youtube-script/SKILL.md)** (long-form video). *v61.2, the builder's toolkit;* *v61.1, the demand side:* **[find](https://mohitagw15856.github.io/pm-claude-skills/find.html)** (task→skill router) with an honest **measured / no-claim** badge and **[SkillSpec as an adoptable standard](conformance/REGISTRY.md)**. Full history: **[CHANGELOG](CHANGELOG.md)** · [releases](https://github.com/mohitagw15856/pm-claude-skills/releases)
159
159
 
160
160
  ## 🤝 Contributing
161
161
 
@@ -171,4 +171,4 @@ MIT — use them, fork them, ship them at work. Skills are judgment, and judgmen
171
171
 
172
172
  ---
173
173
 
174
- *Built by [Mohit](https://github.com/mohitagw15856) with Claude. 751 skills · 90 bundles · 31 professions · every commit gated. The long version of this README — every feature, wave, and frontier bet — lives in the **[Showcase](docs/SHOWCASE.md)**.*
174
+ *Built by [Mohit](https://github.com/mohitagw15856) with Claude. 754 skills · 90 bundles · 31 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 CHANGED
@@ -8,7 +8,7 @@ by hand; edit the source skill and run:
8
8
  node scripts/build-exports.mjs
9
9
  ```
10
10
 
11
- Currently exporting **751 skills** to:
11
+ Currently exporting **754 skills** to:
12
12
 
13
13
  - **ChatGPT — Custom GPT instructions** → `exports/chatgpt/`
14
14
  - **Google Gemini — Gem instructions** → `exports/gemini/`
@@ -3,7 +3,7 @@
3
3
  > Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
4
4
  > **Do not edit these files by hand** — edit the source skill and regenerate.
5
5
 
6
- 751 skills exported. Copy a `.md rule` into the tool to use it.
6
+ 754 skills exported. Copy a `.md rule` into the tool to use it.
7
7
 
8
8
  | Skill | Bundle | Path |
9
9
  |---|---|---|
@@ -126,6 +126,7 @@
126
126
  | College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/college-app-parent-guide.md` |
127
127
  | College Cost | `pm-calculators` | `pm-calculators/college-cost/college-cost.md` |
128
128
  | Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/community-management-playbook.md` |
129
+ | Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/community-moderation-policy.md` |
129
130
  | Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/company-brief.md` |
130
131
  | Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/company-event-ops.md` |
131
132
  | Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/comparative-market-analysis.md` |
@@ -203,6 +204,7 @@
203
204
  | Demo Script | `pm-cowork` | `pm-cowork/demo-script/demo-script.md` |
204
205
  | Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/dependency-audit.md` |
205
206
  | Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/dependency-conflict-resolver.md` |
207
+ | Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md` |
206
208
  | Design Critique | `pm-design` | `pm-design/design-critique/design-critique.md` |
207
209
  | Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/design-handoff-brief.md` |
208
210
  | Design System Audit | `pm-design` | `pm-design/design-system-audit/design-system-audit.md` |
@@ -541,6 +543,7 @@
541
543
  | Red-Team Review | `pm-cross` | `pm-cross/red-team-review/red-team-review.md` |
542
544
  | Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/redundancy-consultation.md` |
543
545
  | Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/refactoring-plan.md` |
546
+ | Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/reference-check-script.md` |
544
547
  | Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/reference-letter.md` |
545
548
  | Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/reference-request-kit.md` |
546
549
  | Referral Program | `pm-growth` | `pm-growth/referral-program/referral-program.md` |
@@ -0,0 +1,65 @@
1
+ # Deprecation Comms Plan Skill
2
+
3
+ Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
4
+
5
+ ## Working from a brief
6
+
7
+ Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
13
+ - **Who depends on it** — rough usage, and which segments/contracts are exposed
14
+ - **The replacement / migration path** (or that there isn't one yet)
15
+ - **Hard constraints** — a forcing date (security, legal, contract), team capacity
16
+
17
+ ## Output Format
18
+
19
+ ### Deprecation policy in one line
20
+ The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
21
+
22
+ ### Timeline
23
+
24
+ | Phase | Date / window | What changes | What customers can still do |
25
+ |---|---|---|---|
26
+ | Announce | | nothing breaks; docs + warnings | full use, start migrating |
27
+ | Deprecated | | warnings, no new adoption | migrate |
28
+ | Sunset | | turned off | must have migrated |
29
+
30
+ Include grace periods and any extension policy for large accounts.
31
+
32
+ ### Tiered messaging
33
+ Segmented by dependence, not one blast:
34
+ - **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
35
+ - **Tier 2 — active users:** direct email + in-product warning + migration guide.
36
+ - **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
37
+
38
+ For each: the core message (what, when, why, what to do), the ask, and the escalation path.
39
+
40
+ ### Migration guide outline
41
+ The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
42
+
43
+ ### Channel plan
44
+ Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
45
+
46
+ ### Internal escalation playbook
47
+ The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
48
+
49
+ ## Quality Checks
50
+
51
+ - [ ] A migration path exists and is referenced everywhere before any customer message goes out
52
+ - [ ] Runway is sized to migration difficulty, with grace periods stated
53
+ - [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
54
+ - [ ] Every message says what, when, why, and the exact next step
55
+ - [ ] The channel cadence includes reminders and a final notice, not a single announcement
56
+ - [ ] High-risk accounts have a named owner and an escalation/extension path
57
+
58
+ ## Anti-Patterns
59
+
60
+ - Too little runway for the migration actually required
61
+ - A silent breaking change, or burying it in a changelog nobody reads
62
+ - Announcing before the migration path is live
63
+ - One-size messaging that treats a whale like a dormant free user
64
+ - No plan for the accounts that physically can't migrate in time
65
+ - "Why" that blames the customer or the old system instead of owning the change
@@ -0,0 +1,62 @@
1
+ # Reference Check Script Skill
2
+
3
+ A reference check fails when it's a formality — you call, they say "great to work with," you tick the box. This skill writes a call that actually de-risks the hire: questions that make it *safe and easy* for a referee to be honest, follow-ups that open the gap between polite and true, and a rubric that turns what you hear into a defensible signal.
4
+
5
+ ## Working from a brief
6
+
7
+ Given the role and what you need to validate, **write the full script** — tailor the questions to the specific concerns (the shaky interview signal, the seniority stretch, the manager-vs-IC question). Default to a ~20–25 minute call structure.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **Role** and level, and the **1–3 things to validate or de-risk** (the open questions from interviews)
13
+ - **Referee relationship** to the candidate (former manager / peer / report / client)
14
+ - **Reference type** — candidate-provided or back-channel (changes how candid you probe)
15
+
16
+ ## Output Format
17
+
18
+ ### Framing (how to open)
19
+ A 2–3 sentence opener that sets candor: confidential, no scripted "sales pitch" needed, you're calibrating not gatekeeping. The single most important move — referees mirror the tone you set.
20
+
21
+ ### Question set (in order)
22
+ Grouped, with the *intent* of each noted:
23
+ 1. **Relationship & context** — how they worked together, for how long, on what.
24
+ 2. **Scope & performance** — what the candidate actually owned; where they ranked among peers.
25
+ 3. **Strengths** — with a concrete example ("tell me about a time…").
26
+ 4. **Growth areas** — asked as _"where did they most need to grow / what coaching helped?"_ (not "weaknesses").
27
+ 5. **Working style** — how they handle conflict, feedback, ambiguity, pressure.
28
+ 6. **The rehire question** — _"Would you hire them again? For what kind of role?"_ — and listen to the hesitation.
29
+
30
+ ### Probing follow-ups
31
+ The second question that opens the gap: "Can you give me an example?" · "How did that compare to others at that level?" · "What would their harshest fair critic say?" · silence (let them fill it).
32
+
33
+ ### Scoring rubric
34
+
35
+ | Signal | 🟢 Green | 🟡 Yellow | 🔴 Red |
36
+ |---|---|---|---|
37
+ | Specificity | concrete examples | generic praise | evasive / can't recall |
38
+ | Rehire | enthusiastic, unprompted | qualified | hesitation or no |
39
+ | Growth honesty | candid, coachable | vague | defensive / dodged |
40
+
41
+ Plus a one-line **overall read** and any follow-up to run (e.g. a back-channel if listed refs are all glowing-but-generic).
42
+
43
+ ### Legal & fairness guardrails
44
+ Ask about job performance only. Do **not** ask about age, health/disability, family/pregnancy, religion, national origin, or other protected characteristics. Keep it consistent across candidates so it's comparable and defensible.
45
+
46
+ ## Quality Checks
47
+
48
+ - [ ] The opener explicitly invites candor (not a box-tick)
49
+ - [ ] Questions are open and non-leading — no "they were a great team player, right?"
50
+ - [ ] At least one question forces a concrete example and one comparative ranking
51
+ - [ ] The rehire question is included and its hesitation is scored, not just its answer
52
+ - [ ] The rubric converts what's heard into 🟢🟡🔴 with an overall read
53
+ - [ ] Protected-class questions are explicitly excluded; the script is consistent across candidates
54
+
55
+ ## Anti-Patterns
56
+
57
+ - Leading questions that hand the referee the answer
58
+ - Accepting "they were great" without a follow-up for a specific example
59
+ - Only calling candidate-selected references (all curated to be positive)
60
+ - Treating the call as confirmation, not investigation
61
+ - Asking anything about protected characteristics
62
+ - No rubric — a vibe instead of a comparable, documented signal
@@ -0,0 +1,59 @@
1
+ # Community Moderation Policy Skill
2
+
3
+ A moderation policy fails when it's vague ("be respectful") or applied inconsistently — members can't predict what's allowed, and mods burn out making judgment calls with no backing. This skill writes a policy that is *enforceable*: concrete rules with examples, a ladder that matches consequence to behavior, and the process that makes enforcement feel fair even to the person on the receiving end.
4
+
5
+ ## Working from a brief
6
+
7
+ Given the community (platform, size, purpose, audience), **write the full policy** — tune severity and tone to the space (a professional Slack ≠ a gaming Discord). Keep the public-facing rules short and human; put the operational detail in the moderator guidelines.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **The community** — platform, rough size, purpose, and audience norms
13
+ - **The values / what "good" looks like** here, and the behaviors you most want to prevent
14
+ - **Team** — how many moderators, volunteer or staff, tools available
15
+ - **Legal/brand constraints** — platform ToS, regulated topics, company brand line
16
+
17
+ ## Output Format
18
+
19
+ ### Code of conduct (public-facing)
20
+ Short, plain, and specific. The core rules stated positively where possible, each with a **one-line example of what crosses the line** so it's not ambiguous. Cover the usual: harassment, hate speech, spam/self-promo, off-topic, NSFW, illegal content — scoped to this community.
21
+
22
+ ### Enforcement ladder
23
+ Consequence matched to behavior and repetition:
24
+
25
+ | Level | Trigger | Action | Who can apply |
26
+ |---|---|---|---|
27
+ | 1 | first minor / borderline | friendly warning, edit/remove | any mod |
28
+ | 2 | repeat / clear violation | formal warning, temp mute | any mod |
29
+ | 3 | serious or repeated | temp ban (e.g. 7 days) | senior mod |
30
+ | 4 | severe / incorrigible | permanent ban | admin |
31
+ | **Zero-tolerance** | threats, doxxing, CSAM, targeted harassment | immediate ban + report | admin, no warning |
32
+
33
+ ### Appeals process
34
+ How a member contests an action: where to appeal, who reviews (not the acting mod), the timeline, and what can/can't be overturned. Appeals are what make the ladder feel legitimate.
35
+
36
+ ### Moderator guidelines (internal)
37
+ - **Consistency** — decide by the rule, not the person; document every Level 2+ action.
38
+ - **Conflicts** — don't moderate a thread you're personally in; hand off.
39
+ - **Edge cases** — borderline calls, sarcasm/context, brigading and coordinated behavior, when to lock vs remove.
40
+ - **Transparency** — what's communicated to the member vs. handled quietly; a mod log.
41
+ - **Mod wellbeing** — rotation for heavy content, escalation for threats to mods.
42
+
43
+ ## Quality Checks
44
+
45
+ - [ ] Every rule is concrete enough to predict a call, with an example of the line
46
+ - [ ] The ladder ties specific triggers to specific actions and who may apply them
47
+ - [ ] Severe cases (threats, doxxing, CSAM) are zero-tolerance and route to reporting
48
+ - [ ] An appeals path exists and is reviewed by someone other than the acting mod
49
+ - [ ] Mod guidelines cover consistency, conflicts of interest, and documentation
50
+ - [ ] Tone and severity fit this community; it aligns with the platform ToS
51
+
52
+ ## Anti-Patterns
53
+
54
+ - Vague rules ("don't be a jerk") with no examples — unenforceable and arbitrary-feeling
55
+ - A single "ban" hammer with no graduated steps for minor issues
56
+ - Inconsistent enforcement by mood or by who the member is
57
+ - No appeals process (every action feels final and unjust)
58
+ - Unwritten rules enforced as if everyone knew them
59
+ - Warning-laddering genuine threats or doxxing instead of acting immediately
@@ -3,7 +3,7 @@
3
3
  > Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
4
4
  > **Do not edit these files by hand** — edit the source skill and regenerate.
5
5
 
6
- 751 skills exported. Copy a `SYSTEM_PROMPT.md` into the tool to use it.
6
+ 754 skills exported. Copy a `SYSTEM_PROMPT.md` into the tool to use it.
7
7
 
8
8
  | Skill | Bundle | Path |
9
9
  |---|---|---|
@@ -126,6 +126,7 @@
126
126
  | College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/SYSTEM_PROMPT.md` |
127
127
  | College Cost | `pm-calculators` | `pm-calculators/college-cost/SYSTEM_PROMPT.md` |
128
128
  | Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/SYSTEM_PROMPT.md` |
129
+ | Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/SYSTEM_PROMPT.md` |
129
130
  | Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/SYSTEM_PROMPT.md` |
130
131
  | Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/SYSTEM_PROMPT.md` |
131
132
  | Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/SYSTEM_PROMPT.md` |
@@ -203,6 +204,7 @@
203
204
  | Demo Script | `pm-cowork` | `pm-cowork/demo-script/SYSTEM_PROMPT.md` |
204
205
  | Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/SYSTEM_PROMPT.md` |
205
206
  | Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/SYSTEM_PROMPT.md` |
207
+ | Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/SYSTEM_PROMPT.md` |
206
208
  | Design Critique | `pm-design` | `pm-design/design-critique/SYSTEM_PROMPT.md` |
207
209
  | Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/SYSTEM_PROMPT.md` |
208
210
  | Design System Audit | `pm-design` | `pm-design/design-system-audit/SYSTEM_PROMPT.md` |
@@ -541,6 +543,7 @@
541
543
  | Red-Team Review | `pm-cross` | `pm-cross/red-team-review/SYSTEM_PROMPT.md` |
542
544
  | Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/SYSTEM_PROMPT.md` |
543
545
  | Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/SYSTEM_PROMPT.md` |
546
+ | Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/SYSTEM_PROMPT.md` |
544
547
  | Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/SYSTEM_PROMPT.md` |
545
548
  | Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/SYSTEM_PROMPT.md` |
546
549
  | Referral Program | `pm-growth` | `pm-growth/referral-program/SYSTEM_PROMPT.md` |
@@ -0,0 +1,65 @@
1
+ # Deprecation Comms Plan Skill
2
+
3
+ Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
4
+
5
+ ## Working from a brief
6
+
7
+ Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
13
+ - **Who depends on it** — rough usage, and which segments/contracts are exposed
14
+ - **The replacement / migration path** (or that there isn't one yet)
15
+ - **Hard constraints** — a forcing date (security, legal, contract), team capacity
16
+
17
+ ## Output Format
18
+
19
+ ### Deprecation policy in one line
20
+ The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
21
+
22
+ ### Timeline
23
+
24
+ | Phase | Date / window | What changes | What customers can still do |
25
+ |---|---|---|---|
26
+ | Announce | | nothing breaks; docs + warnings | full use, start migrating |
27
+ | Deprecated | | warnings, no new adoption | migrate |
28
+ | Sunset | | turned off | must have migrated |
29
+
30
+ Include grace periods and any extension policy for large accounts.
31
+
32
+ ### Tiered messaging
33
+ Segmented by dependence, not one blast:
34
+ - **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
35
+ - **Tier 2 — active users:** direct email + in-product warning + migration guide.
36
+ - **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
37
+
38
+ For each: the core message (what, when, why, what to do), the ask, and the escalation path.
39
+
40
+ ### Migration guide outline
41
+ The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
42
+
43
+ ### Channel plan
44
+ Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
45
+
46
+ ### Internal escalation playbook
47
+ The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
48
+
49
+ ## Quality Checks
50
+
51
+ - [ ] A migration path exists and is referenced everywhere before any customer message goes out
52
+ - [ ] Runway is sized to migration difficulty, with grace periods stated
53
+ - [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
54
+ - [ ] Every message says what, when, why, and the exact next step
55
+ - [ ] The channel cadence includes reminders and a final notice, not a single announcement
56
+ - [ ] High-risk accounts have a named owner and an escalation/extension path
57
+
58
+ ## Anti-Patterns
59
+
60
+ - Too little runway for the migration actually required
61
+ - A silent breaking change, or burying it in a changelog nobody reads
62
+ - Announcing before the migration path is live
63
+ - One-size messaging that treats a whale like a dormant free user
64
+ - No plan for the accounts that physically can't migrate in time
65
+ - "Why" that blames the customer or the old system instead of owning the change
@@ -0,0 +1,62 @@
1
+ # Reference Check Script Skill
2
+
3
+ A reference check fails when it's a formality — you call, they say "great to work with," you tick the box. This skill writes a call that actually de-risks the hire: questions that make it *safe and easy* for a referee to be honest, follow-ups that open the gap between polite and true, and a rubric that turns what you hear into a defensible signal.
4
+
5
+ ## Working from a brief
6
+
7
+ Given the role and what you need to validate, **write the full script** — tailor the questions to the specific concerns (the shaky interview signal, the seniority stretch, the manager-vs-IC question). Default to a ~20–25 minute call structure.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **Role** and level, and the **1–3 things to validate or de-risk** (the open questions from interviews)
13
+ - **Referee relationship** to the candidate (former manager / peer / report / client)
14
+ - **Reference type** — candidate-provided or back-channel (changes how candid you probe)
15
+
16
+ ## Output Format
17
+
18
+ ### Framing (how to open)
19
+ A 2–3 sentence opener that sets candor: confidential, no scripted "sales pitch" needed, you're calibrating not gatekeeping. The single most important move — referees mirror the tone you set.
20
+
21
+ ### Question set (in order)
22
+ Grouped, with the *intent* of each noted:
23
+ 1. **Relationship & context** — how they worked together, for how long, on what.
24
+ 2. **Scope & performance** — what the candidate actually owned; where they ranked among peers.
25
+ 3. **Strengths** — with a concrete example ("tell me about a time…").
26
+ 4. **Growth areas** — asked as _"where did they most need to grow / what coaching helped?"_ (not "weaknesses").
27
+ 5. **Working style** — how they handle conflict, feedback, ambiguity, pressure.
28
+ 6. **The rehire question** — _"Would you hire them again? For what kind of role?"_ — and listen to the hesitation.
29
+
30
+ ### Probing follow-ups
31
+ The second question that opens the gap: "Can you give me an example?" · "How did that compare to others at that level?" · "What would their harshest fair critic say?" · silence (let them fill it).
32
+
33
+ ### Scoring rubric
34
+
35
+ | Signal | 🟢 Green | 🟡 Yellow | 🔴 Red |
36
+ |---|---|---|---|
37
+ | Specificity | concrete examples | generic praise | evasive / can't recall |
38
+ | Rehire | enthusiastic, unprompted | qualified | hesitation or no |
39
+ | Growth honesty | candid, coachable | vague | defensive / dodged |
40
+
41
+ Plus a one-line **overall read** and any follow-up to run (e.g. a back-channel if listed refs are all glowing-but-generic).
42
+
43
+ ### Legal & fairness guardrails
44
+ Ask about job performance only. Do **not** ask about age, health/disability, family/pregnancy, religion, national origin, or other protected characteristics. Keep it consistent across candidates so it's comparable and defensible.
45
+
46
+ ## Quality Checks
47
+
48
+ - [ ] The opener explicitly invites candor (not a box-tick)
49
+ - [ ] Questions are open and non-leading — no "they were a great team player, right?"
50
+ - [ ] At least one question forces a concrete example and one comparative ranking
51
+ - [ ] The rehire question is included and its hesitation is scored, not just its answer
52
+ - [ ] The rubric converts what's heard into 🟢🟡🔴 with an overall read
53
+ - [ ] Protected-class questions are explicitly excluded; the script is consistent across candidates
54
+
55
+ ## Anti-Patterns
56
+
57
+ - Leading questions that hand the referee the answer
58
+ - Accepting "they were great" without a follow-up for a specific example
59
+ - Only calling candidate-selected references (all curated to be positive)
60
+ - Treating the call as confirmation, not investigation
61
+ - Asking anything about protected characteristics
62
+ - No rubric — a vibe instead of a comparable, documented signal
@@ -0,0 +1,59 @@
1
+ # Community Moderation Policy Skill
2
+
3
+ A moderation policy fails when it's vague ("be respectful") or applied inconsistently — members can't predict what's allowed, and mods burn out making judgment calls with no backing. This skill writes a policy that is *enforceable*: concrete rules with examples, a ladder that matches consequence to behavior, and the process that makes enforcement feel fair even to the person on the receiving end.
4
+
5
+ ## Working from a brief
6
+
7
+ Given the community (platform, size, purpose, audience), **write the full policy** — tune severity and tone to the space (a professional Slack ≠ a gaming Discord). Keep the public-facing rules short and human; put the operational detail in the moderator guidelines.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **The community** — platform, rough size, purpose, and audience norms
13
+ - **The values / what "good" looks like** here, and the behaviors you most want to prevent
14
+ - **Team** — how many moderators, volunteer or staff, tools available
15
+ - **Legal/brand constraints** — platform ToS, regulated topics, company brand line
16
+
17
+ ## Output Format
18
+
19
+ ### Code of conduct (public-facing)
20
+ Short, plain, and specific. The core rules stated positively where possible, each with a **one-line example of what crosses the line** so it's not ambiguous. Cover the usual: harassment, hate speech, spam/self-promo, off-topic, NSFW, illegal content — scoped to this community.
21
+
22
+ ### Enforcement ladder
23
+ Consequence matched to behavior and repetition:
24
+
25
+ | Level | Trigger | Action | Who can apply |
26
+ |---|---|---|---|
27
+ | 1 | first minor / borderline | friendly warning, edit/remove | any mod |
28
+ | 2 | repeat / clear violation | formal warning, temp mute | any mod |
29
+ | 3 | serious or repeated | temp ban (e.g. 7 days) | senior mod |
30
+ | 4 | severe / incorrigible | permanent ban | admin |
31
+ | **Zero-tolerance** | threats, doxxing, CSAM, targeted harassment | immediate ban + report | admin, no warning |
32
+
33
+ ### Appeals process
34
+ How a member contests an action: where to appeal, who reviews (not the acting mod), the timeline, and what can/can't be overturned. Appeals are what make the ladder feel legitimate.
35
+
36
+ ### Moderator guidelines (internal)
37
+ - **Consistency** — decide by the rule, not the person; document every Level 2+ action.
38
+ - **Conflicts** — don't moderate a thread you're personally in; hand off.
39
+ - **Edge cases** — borderline calls, sarcasm/context, brigading and coordinated behavior, when to lock vs remove.
40
+ - **Transparency** — what's communicated to the member vs. handled quietly; a mod log.
41
+ - **Mod wellbeing** — rotation for heavy content, escalation for threats to mods.
42
+
43
+ ## Quality Checks
44
+
45
+ - [ ] Every rule is concrete enough to predict a call, with an example of the line
46
+ - [ ] The ladder ties specific triggers to specific actions and who may apply them
47
+ - [ ] Severe cases (threats, doxxing, CSAM) are zero-tolerance and route to reporting
48
+ - [ ] An appeals path exists and is reviewed by someone other than the acting mod
49
+ - [ ] Mod guidelines cover consistency, conflicts of interest, and documentation
50
+ - [ ] Tone and severity fit this community; it aligns with the platform ToS
51
+
52
+ ## Anti-Patterns
53
+
54
+ - Vague rules ("don't be a jerk") with no examples — unenforceable and arbitrary-feeling
55
+ - A single "ban" hammer with no graduated steps for minor issues
56
+ - Inconsistent enforcement by mood or by who the member is
57
+ - No appeals process (every action feels final and unjust)
58
+ - Unwritten rules enforced as if everyone knew them
59
+ - Warning-laddering genuine threats or doxxing instead of acting immediately
@@ -3,7 +3,7 @@
3
3
  > Auto-generated from `skills/*/SKILL.md` by `scripts/build-exports.mjs`.
4
4
  > **Do not edit these files by hand** — edit the source skill and regenerate.
5
5
 
6
- 751 skills exported. Copy a `.md rule` into the tool to use it.
6
+ 754 skills exported. Copy a `.md rule` into the tool to use it.
7
7
 
8
8
  | Skill | Bundle | Path |
9
9
  |---|---|---|
@@ -126,6 +126,7 @@
126
126
  | College App Parent Guide | `pm-parents` | `pm-parents/college-app-parent-guide/college-app-parent-guide.md` |
127
127
  | College Cost | `pm-calculators` | `pm-calculators/college-cost/college-cost.md` |
128
128
  | Community Management Playbook | `pm-social` | `pm-social/community-management-playbook/community-management-playbook.md` |
129
+ | Community Moderation Policy | `pm-social` | `pm-social/community-moderation-policy/community-moderation-policy.md` |
129
130
  | Company Brief | `pm-jobsearch` | `pm-jobsearch/company-brief/company-brief.md` |
130
131
  | Company Event Ops | `pm-cowork` | `pm-cowork/company-event-ops/company-event-ops.md` |
131
132
  | Comparative Market Analysis | `pm-realestate` | `pm-realestate/comparative-market-analysis/comparative-market-analysis.md` |
@@ -203,6 +204,7 @@
203
204
  | Demo Script | `pm-cowork` | `pm-cowork/demo-script/demo-script.md` |
204
205
  | Dependency Audit | `pm-engineering` | `pm-engineering/dependency-audit/dependency-audit.md` |
205
206
  | Dependency Conflict Resolver | `pm-engineering` | `pm-engineering/dependency-conflict-resolver/dependency-conflict-resolver.md` |
207
+ | Deprecation Comms Plan | `pm-devrel` | `pm-devrel/deprecation-comms-plan/deprecation-comms-plan.md` |
206
208
  | Design Critique | `pm-design` | `pm-design/design-critique/design-critique.md` |
207
209
  | Design Handoff Brief | `pm-advanced` | `pm-advanced/design-handoff-brief/design-handoff-brief.md` |
208
210
  | Design System Audit | `pm-design` | `pm-design/design-system-audit/design-system-audit.md` |
@@ -541,6 +543,7 @@
541
543
  | Red-Team Review | `pm-cross` | `pm-cross/red-team-review/red-team-review.md` |
542
544
  | Redundancy Consultation | `pm-hr` | `pm-hr/redundancy-consultation/redundancy-consultation.md` |
543
545
  | Refactoring Plan | `pm-craft` | `pm-craft/refactoring-plan/refactoring-plan.md` |
546
+ | Reference Check Script | `pm-recruiting` | `pm-recruiting/reference-check-script/reference-check-script.md` |
544
547
  | Reference Letter | `pm-lifeadmin` | `pm-lifeadmin/reference-letter/reference-letter.md` |
545
548
  | Reference Request Kit | `pm-layoff` | `pm-layoff/reference-request-kit/reference-request-kit.md` |
546
549
  | Referral Program | `pm-growth` | `pm-growth/referral-program/referral-program.md` |
@@ -0,0 +1,65 @@
1
+ # Deprecation Comms Plan Skill
2
+
3
+ Deprecations go wrong in two ways: too fast (customers get broken and churn angry) or too quiet (they find out when it breaks). This skill plans the wind-down as a *communications program*, not an announcement — enough runway, messaging matched to how much each customer depends on the thing, a real migration path, and a plan for the accounts that will need a human.
4
+
5
+ ## Working from a brief
6
+
7
+ Given what's being deprecated and why, **produce the full plan** — infer the risk tiers from usage and contract exposure. Right-size the runway to how hard the migration is (an internal flag flip is weeks; a public API is many months). If there's no migration path yet, flag that as a blocker before any announcement.
8
+
9
+ ## Required Inputs
10
+
11
+ Ask for (if not provided, else infer and label the assumption):
12
+ - **What's being deprecated** and **why** (cost, security, strategy, replaced-by)
13
+ - **Who depends on it** — rough usage, and which segments/contracts are exposed
14
+ - **The replacement / migration path** (or that there isn't one yet)
15
+ - **Hard constraints** — a forcing date (security, legal, contract), team capacity
16
+
17
+ ## Output Format
18
+
19
+ ### Deprecation policy in one line
20
+ The principle you're committing to (e.g. _"announce → N months deprecated (works, warns) → sunset, with a migration path live before we announce"_).
21
+
22
+ ### Timeline
23
+
24
+ | Phase | Date / window | What changes | What customers can still do |
25
+ |---|---|---|---|
26
+ | Announce | | nothing breaks; docs + warnings | full use, start migrating |
27
+ | Deprecated | | warnings, no new adoption | migrate |
28
+ | Sunset | | turned off | must have migrated |
29
+
30
+ Include grace periods and any extension policy for large accounts.
31
+
32
+ ### Tiered messaging
33
+ Segmented by dependence, not one blast:
34
+ - **Tier 1 — heavy/contractual users:** proactive, human (CSM/AM), often a call + tailored plan.
35
+ - **Tier 2 — active users:** direct email + in-product warning + migration guide.
36
+ - **Tier 3 — light/dormant:** changelog, docs banner, deprecation headers.
37
+
38
+ For each: the core message (what, when, why, what to do), the ask, and the escalation path.
39
+
40
+ ### Migration guide outline
41
+ The structure of the how-to: before/after, step-by-step, code/config examples, a mapping table (old → new), FAQ, and where to get help.
42
+
43
+ ### Channel plan
44
+ Which channels fire at which phase — email, in-product, docs/changelog, API deprecation headers/`Sunset` header, status page, community/social — and the cadence (announce, reminders at intervals, final notice).
45
+
46
+ ### Internal escalation playbook
47
+ The at-risk account list, who owns each, the CSM talking points, the "customer can't migrate in time" decision tree, and the exception/extension approval path.
48
+
49
+ ## Quality Checks
50
+
51
+ - [ ] A migration path exists and is referenced everywhere before any customer message goes out
52
+ - [ ] Runway is sized to migration difficulty, with grace periods stated
53
+ - [ ] Messaging is tiered by dependence; Tier-1 accounts get a human, not a blast
54
+ - [ ] Every message says what, when, why, and the exact next step
55
+ - [ ] The channel cadence includes reminders and a final notice, not a single announcement
56
+ - [ ] High-risk accounts have a named owner and an escalation/extension path
57
+
58
+ ## Anti-Patterns
59
+
60
+ - Too little runway for the migration actually required
61
+ - A silent breaking change, or burying it in a changelog nobody reads
62
+ - Announcing before the migration path is live
63
+ - One-size messaging that treats a whale like a dormant free user
64
+ - No plan for the accounts that physically can't migrate in time
65
+ - "Why" that blames the customer or the old system instead of owning the change