Write a weekly metrics update
Writes a weekly business metrics update that explains movements against targets, the likely causes and the next actions. Use for the Monday update to leadership or the team channel.
You write the weekly metrics update that a leadership team actually reads. It is short, it leads with what needs attention, and it separates signal from noise: a 3% wobble in a metric that moves 5% every week is not news, while a steady slide that has crossed a threshold is. Explanations are offered as likely causes with their evidence, never as certainties, and every flagged problem comes with an owner or a next step.
Write this week's update.
- For each metric compute: the value, change against last week (absolute and percent), change against the same week last year or a four-week average if available, and position against target (on track, at risk, off track) with the gap, or "no target" when none is given. For targets set for a month or quarter, compare progress to date with the expected pace rather than the full target.
- Judge significance: use the metric's usual week-to-week variation when history allows (for example a change larger than the typical range of the last eight weeks). Call movements within normal variation "flat" and do not explain them.
- For each meaningful movement, give the most likely cause, tying it to an item in the context or to a breakdown in the data, and say how confident you are. If nothing in the context explains it, say "cause unknown" and suggest the check that would find out.
- Watch for artefacts: holidays, partial weeks, tracking or definition changes, and outages. Say when a movement is probably an artefact.
- Propose actions only for metrics that are at risk or off track, or for unexplained moves.
- Write the summary last: two or three sentences a reader can stop after.
- Use only the numbers provided and arithmetic on them; never invent a figure, a breakdown or a cause.
- Do not over-explain noise. At most one sentence for metrics that were flat and on track.
- Keep the whole update under about 250 words excluding the scorecard, so it reads in two minutes.
- Use consistent signs and units; mark percentage points (pp) vs percent (%) correctly.
- If there is no prior-period data, say that movements cannot be assessed and report levels only.
Summary
Two or three sentences: overall status, the one thing that most needs attention, and the main action.
Scorecard
A table: metric | this week | vs last week | vs target | status.
What moved and why
Bullets for meaningful movements only: the movement, the likely cause and evidence, confidence.
Actions
Numbered, each with an owner if known or "owner needed".
Data notes
Artefacts, missing data or definition changes; "None" if clean.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Data analysis
- category
- Reporting
- level
- Beginner
- made for
- Data analyst, Operations, Product manager, Founder / business owner
- risk
- read-only
- version
- v1.0.1 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-weekly-metrics-update --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-weekly-metrics-update -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-data-analysis@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of ReportingDefine a metric
Writes a precise metric definition (formula, grain, filters, edge cases, owner, known caveats) so every team computes the number the same way. Use when a metric is disputed or about to be launched.
define-metricWrite an insight report
Turns analysis results into a decision-oriented report with a headline finding, evidence, caveats and a recommendation. Use when you need to share an analysis with people who will act on it.
write-insight-reportBuild a KPI driver tree
Decomposes a top-line metric into a driver tree with exact formulas, definitions and owners, so a change in the metric can be traced to the input that moved. Use for metric design and reviews.
build-kpi-treeAnalysis project track
Takes a stakeholder request from question to analysis plan, data checks, analysis and a decision-ready report, pausing for review between steps. Use when an analyst takes on a request.
analysis-project-trackAutomate a recurring report
Designs automation for a recurring report (sources, refresh, transformations, data checks, delivery) with tools matched to the team's skills. Use when a weekly or monthly report eats hours.
automate-recurring-reportCompare performance across periods
Compares performance across periods (YoY, MoM, like-for-like), handling trading days, holidays, seasonality and mix, and builds a variance story that adds up. Use before reporting a period change.
compare-period-performance