mohitagw15856/pm-claude-skills / plugins/pm-cowork/skills/async-update-format
async-update-format
VerifiedWrite status updates people actually read — the traffic-light-plus-narrative format (state first, story second), the blockers-are-asks rule, and the skimmable structure that respects a reader with thirty seconds. Use when asked write my weekly update, format our team's status posts, nobody reads my updates, or what goes in a good async check-in. Produces the update format with a filled example, the blockers-as-asks discipline, and the reader-time contract.
Async Update Format Skill
Status updates die of two diseases: the activity log ("attended meetings, worked on the project") that says nothing, and the essay that says everything to readers with thirty seconds. The format that survives: state first (on-track / at-risk / blocked, with the one-line why), then the delta (what changed since last time — not what exists), then blockers written as asks with names ("blocked on X — need [person] to approve Y by Friday"), then the next milestone with its date. Skimmable in thirty seconds, expandable for the reader who wants more.
What This Skill Produces
- The format — state → delta → asks → next, with length budgets per section
- A filled example — realistic, showing the delta-not-inventory discipline
- The blockers-as-asks rule — every blocker names a person and an action, or it's just weather
- The reader-time contract — the 30-second skim layer and the optional depth layer, separated
Required Inputs
Ask for these if not provided:
- The update's audience and altitude — the manager (risks and asks), the team (coordination detail), stakeholders (outcomes) — one update rarely serves all three; the format flexes or splits
- The cadence and the vehicle — weekly in a channel? Biweekly in a doc? The format compresses for chat, breathes in docs
- This period's raw material — what actually happened, honestly including the nothing-moved weeks (the format has an honest shape for those too)
Framework: The Format Rules
- State leads, unhedged: 🟢 on-track / 🟡 at-risk / 🔴 blocked — plus one line of why. Readers triage by state; burying "we're going to miss the date" in paragraph three is how misses become surprises. A 🟡 with a clear why builds more trust than a 🟢 streak that flips red overnight.
- Delta, not inventory: what changed since the last update — shipped, decided, learned, slipped. The inventory ("still working on X, Y continues") is noise wearing progress's clothes; a nothing-moved week says so in one line with the why, which is itself information.
- Blockers are asks with names and dates: "blocked on legal review" is weather; "need [name] to approve the DPA by Thu or the launch slips a week" is an ask that can be actioned — by the reader, which is the point of telling them. Every blocker that stays nameless stays blocked.
- Next is a milestone with a date: "next: ship the beta to 10 customers by the 28th" — the line that makes the following update verifiable, which is what makes the whole cadence honest. "Continue making progress" is the anti-milestone.
- Two layers, visibly separated: the skim layer (state/delta/asks/next — the 30-second contract) and below a divider, the depth (details, links, numbers) for the readers who want it. Respecting the skimmer is what keeps updates read; the depth layer is what keeps them useful.
Output Format
Update: [project] — [date]
State: 🟢/🟡/🔴 — [the one-line why] Since last time: [2–4 delta bullets — shipped/decided/learned/slipped] Asks: [each: what, from whom, by when — or "none"] Next: [milestone + date]
Depth (optional): [details, links, metrics for the interested]
Quality Checks
- The state is first and its why fits one line
- Every bullet is a delta — no inventory restatements
- Every blocker names a person, an action, and a date
- Next is a dated milestone, verifiable next update
- The skim layer stands alone in under 30 seconds
Anti-Patterns
- Do not log activity — attended, discussed, and continued are not deltas
- Do not hedge the state — 🟡 announced early is cheap; 🔴 discovered late is expensive
- Do not post nameless blockers — unaddressed asks are the sender's fault after the first update
- Do not write one essay for three audiences — flex the altitude or split the update
- Do not skip the nothing-happened weeks — silence reads as chaos; "no movement, because X" reads as control
Example Trigger Phrases
- "Write my weekly update."
- "Format our team's status posts."
- "What goes in a good async check-in?"
Run this skill in your browser: https://mohitagw15856.github.io/pm-claude-skills/skill/async-update-format.html
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |