Files
pm-claude-skills/exports/cursor/pm-rituals/pm-weekly-review/pm-weekly-review.mdc
mohitagw15856 05b6d799f0 SkillCheck validator, Cursor exports, and per-agent installers (#27)
Three more learnings from alirezarezvani/claude-skills, applied:

1. SkillCheck validator (scripts/skillcheck.mjs) — validates every SKILL.md
   against the authoring standard (frontmatter, name/folder match, trigger +
   produces clauses, required headings) plus tier referential integrity.
   Errors fail CI; --strict fails on warnings too. New skillcheck.yml workflow
   and a SkillCheck status badge in the README. Current: 0 errors / 14 advisory
   warnings across 172 skills.

2. Cursor export platform — build-exports.mjs now generates
   exports/cursor/<bundle>/<skill>/<skill>.mdc rule files. The PLATFORMS
   registry now supports per-skill filenames (file as a function).

3. Per-agent installers — scripts/install.sh unifies install for
   claude/hermes/codex/openclaw/cursor (--link, --target, --dry-run, --list).
   Curl-able one-liners codex-install.sh, openclaw-install.sh, and
   cursor-install.sh clone the library and install in a single command.

README documents the one-line installs and Cursor exports; CHANGELOG and the
authoring standard updated.


Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 13:38:31 +01:00

134 lines
4.5 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
description: "Structure a PM's weekly review and planning session. Use when doing a weekly PM review, writing a weekly update, preparing for Monday planning, or reviewing sprint health. Produces a shareable weekly update covering metrics movement, shipping progress, blockers, insights, and next week's top 3 priorities."
globs:
alwaysApply: false
---
# PM Weekly Review Skill
Turn the chaotic end-of-week brain dump into a structured 20-minute ritual that keeps you, your team, and your stakeholders aligned — without a meeting.
## The Weekly Review Structure (20 minutes)
**5 min — Metrics check:** What moved? What didn't? What's surprising?
**5 min — Ship progress:** What shipped? What slipped? What's blocked?
**5 min — Insights:** Any customer feedback, support tickets, or research findings?
**5 min — Next week priorities:** What are the 3 things that matter most?
---
## Output Format
### PM Weekly Review — Week of [Date]
**Product Area:** [What you own]
**Written by:** [PM Name]
**Time to read:** ~3 minutes
---
### 📊 Metrics This Week
| Metric | This Week | Last Week | Target | Trend |
|---|---|---|---|---|
| [Primary metric] | [Value] | [Value] | [Target] | ↑ / ↓ / → |
| [Secondary metric] | [Value] | [Value] | [Target] | ↑ / ↓ / → |
| [Health metric] | [Value] | [Value] | [Target] | ↑ / ↓ / → |
**Notable movement:**
- [What changed and why — 1 sentence each]
**Concern to watch:**
- [Anything trending in the wrong direction]
---
### 🚢 This Week's Progress
**Shipped:**
- ✅ [What went live] — [1-line impact or observation]
**In Progress:**
- 🔄 [Feature/initiative] — [% complete or current status]
**Slipped / Blocked:**
- ⚠️ [What didn't happen] — Reason: [brief] — Action: [who's unblocking it]
**Carry-forward to next week:**
- [Item + why it's carrying over]
---
### 💡 Insights & Signals
**Customer feedback:**
- "[Quote or paraphrase]" — Source: [user/channel] — Theme: [tag]
**Support signals:**
- [Top ticket category this week + volume]
- [Anything that signals a product gap]
**Research / data:**
- [Any discovery from user interviews, analytics, or experiments]
---
### 🎯 Next Week — Top 3 Priorities
| # | Priority | Why This Week | Owner | Done = |
|---|---|---|---|---|
| 1 | [Most important thing] | [Reason it can't wait] | [Name] | [Clear definition of done] |
| 2 | [Second priority] | [Why] | [Name] | [Done criteria] |
| 3 | [Third priority] | [Why] | [Name] | [Done criteria] |
**Decisions needed:**
- [Any decision that's blocking progress — who needs to make it]
**Asks / dependencies:**
- [What you need from engineering / design / data / leadership]
---
### 🧠 Reflection (Optional but powerful)
> What's one thing from this week I'd do differently?
> [Your honest answer — 12 sentences]
> What's the biggest unknown I'm carrying into next week?
> [Name the uncertainty explicitly]
---
## Required Inputs
Ask the user for these if not provided:
- **Product area or team** you own
- **Key metrics this week** (with values and prior week comparison)
- **What shipped, slipped, or is blocked**
- **Top 3 priorities for next week**
- **Any customer insights or signals** (optional)
## Quality Checks
- [ ] Metrics include period-over-period comparison (not just raw numbers)
- [ ] Every blocked item has an owner and a specific unblocking action
- [ ] Next week's priorities have a "why this week" rationale
- [ ] Total length is under 400 words (skimmable in 3 minutes)
- [ ] Reflection section is honest, not aspirational
## Anti-Patterns
- [ ] Do not report metrics without comparing to target or the prior week — absolute numbers without context are not useful
- [ ] Do not list blockers without a named owner and proposed resolution — unowned blockers stay blocked
- [ ] Do not write a weekly review that is longer than one page — it must be scannable in under 2 minutes
- [ ] Do not include more than 3 priorities for next week — a list of 8 "top priorities" means nothing is prioritised
- [ ] Do not skip the insights section — observations that inform future decisions are a PM's key value add
## Guidelines
- Keep the whole document under 400 words — if stakeholders won't read it, it doesn't exist
- The reflection section is for you, not your stakeholders — keep it honest
- Always name a clear owner for every blocked item — "the team will figure it out" is a blocker in disguise
- Recommend sending this by end of Friday — Monday morning is too late to course-correct
- If three weeks of weekly reviews show the same blocked item, escalate immediately