Agent Skills
› mohitagw15856/pm-claude-skills
› async-update-format
async-update-format
GitHub用于生成高效异步状态更新。遵循“红绿灯+叙述”格式，强调先展示状态再讲故事，将阻塞项转化为具体行动请求，并提供30秒速览层与详情层，确保信息清晰易读。
Trigger Scenarios
撰写周报
格式化团队状态更新
提升更新可读性
编写异步检查点
Install
npx skills add mohitagw15856/pm-claude-skills --skill async-update-format -g -y
SKILL.md
Frontmatter
{
"name": "async-update-format",
"description": "Write 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
Version History
- 471c606 Current 2026-07-22 14:01
