Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Productivity

status-update-writer

Use when the user asks to write a status update, weekly or monthly update, stakeholder update, project update, standup, status report, or QBR. Do NOT use for writing a PRD or a retro doc — those need different structures.

aakashg · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add aakashg/pm-claude-skills --skill status-update-writer

About this skill


name: status-update-writer description: Use when the user asks to write a status update, weekly or monthly update, stakeholder update, project update, standup, status report, or QBR. Do NOT use for writing a PRD or a retro doc — those need different structures.

Status Update Writer

Turn messy notes into a precise stakeholder update that stands alone without a follow-up meeting.

Step 0 — Read first

SourcePathWhat to extract
User's raw noteswhatever they pastedWhat actually shipped, real numbers, real dates, real names
Project contextCLAUDE.mdNorth star metrics, OKRs, company terminology, audience norms
Cadence formatsreferences/cadences.mdDaily / monthly / QBR variants of the base format
Last updateany prior update they nameWhat was promised last week — the delta is the story
Metrics sourcedashboard link or data they provideCurrent values only. Never estimate a metric.

If the user gave you no numbers, the update stays qualitative and you say so. Do not fill the gap.

Constraints

Mandatory.

  • Total update under 200 words for the weekly default.
  • Never fabricate progress. If the notes are thin, the update is thin.
  • Never hide bad news. It goes in the TL;DR, never at the bottom.
  • Never report activity as progress. "Had 6 meetings about the migration" is activity. "Migrated 40% of users at 0.3% error rate" is progress.
  • Every risk gets a mitigation. An unmitigated risk is just anxiety.
  • Every blocker gets a named owner and a date.
  • Every decision request gets a recommendation with reasoning.
  • Active voice only. "Team shipped the migration," not "The migration was completed."
  • No weasel words: roughly on track, mostly done, some concerns, making good progress.
  • Every line passes the "so what?" test for this specific audience. If cutting it changes nothing, cut it.
  • Never invent metrics. If the user did not give you a number, write [NEED: X].

Existence check

Before writing, verify:

  1. The work — what actually happened, in specifics.
  2. The audience — who reads this and at what altitude.
  3. The status — On Track, At Risk, or Blocked, and the evidence for it.

If two of three are missing, do not write. Ask for exactly those. An update written without knowing the audience gets the depth wrong in both directions — too technical for the board, too vague for the eng lead.

Step 1 — Gather

Ask:

  1. What project or initiative is this for?
  2. What happened this week? Paste notes, Slack threads, whatever you have — the messier the better.
  3. Who is the audience — CEO, VP Eng, cross-functional, skip-level, board?
  4. Is there bad news? If so, I will help frame it with a mitigation plan.

Never ask the user to organize their notes first. Extracting structure from mess is the job.

Step 2 — Calibrate to the audience

AudienceFocus onLeave out
CEO / C-suiteOutcomes, metrics, strategic implicationsImplementation details, technical decisions
VP / DirectorProgress against milestones, risks, resource needsCode-level detail, day-to-day tasks
Cross-functionalDependencies, timeline impacts, what they must knowInternal team dynamics, tech debt
Engineering leadTechnical blockers, architecture decisions, velocityBusiness context they already have
Skip-levelTeam impact, growth, winsMinutiae the direct manager handles
BoardMetrics, trajectory, market contextEverything operational

Default cadence is weekly. If the user says daily, monthly, quarterly, or QBR, switch to that format in references/cadences.md.

Output template

Exact fields, exact order. Omit only the sections marked optional.

**TL;DR** (2 sentences max)
[The whole update if they read nothing else. Most important thing first.
Bad news goes HERE, not below.]

**Status:** On Track | At Risk | Blocked

**Progress This Week**
- [What shipped or completed — never what was "worked on". Specific numbers.
  Links to PRs, docs, demos, dashboards where provided. Milestones called out.]

**Next Week**
- [What's planned, with owner. Dependencies on other teams flagged.
  Hard deadlines made visible.]

**Risks & Blockers**
- RISK: [description]. Likelihood: [H/M/L]. Impact: [what it costs].
  Mitigation: [the plan].
- BLOCKER: [what's blocked]. Owner: [who unblocks it]. Need by: [date].
[If none: "None currently." Never invent risks to fill the section.]

**Decisions Needed** (omit if none)
[What must be decided, who decides, by when, enough context to decide
without a meeting, and a recommendation with reasoning.]

**Metrics** (omit if the user provided no data)
- [Metric]: [current] (target: [target]) — [trend] — [one-line interpretation]

Status definitions: On Track = shipping on schedule, no blockers. At Risk = potential issues needing visibility, with a mitigation plan. Blocked = cannot proceed without a specific decision or action from a specific person.

Example

Input notes: "auth migration, we're at 40% web rollout now up from 10%, error rate 0.3%, load tests done handles 5x peak. mobile has a session bug hitting ~12% of users, jake's on it thinks thursday. launch was march 7, probably march 14 now. waiting on maria for QA signoff before we go past 40%. need to know if we ship web only."

Output:

TL;DR: Auth migration is at risk. We found a session handling bug
that affects 12% of users on mobile. Fix is in progress — ETA Thursday.
Launch pushed from March 7 to March 14.

Status: AT RISK

Progress This Week:
- Shipped auth migration to 40% of web users (up from 10% last week)
- Error rate holding at 0.3% — within our 1% threshold
- Completed load testing: system handles 5x current peak traffic

Next Week:
- Fix mobile session bug (owner: Jake, ETA Thursday)
- Expand to 100% of web users if mobile fix validates (owner: Sarah)
- Begin mobile rollout at 10% by Fr
Read the complete source ↗