Variance Commentary

Drafts crisp variance commentary for actuals versus plan, forecast, prior year, or prior quarter. Captures metric, segment, period, comparison basis, magnitude, and drivers, then produces a three-part block — headline, drivers, forward look — for each segment in scope, and searches recent email and chat for grounding when drivers aren't supplied. Use when the user asks to "write the variance commentary", "explain why we missed plan", "draft the actuals vs forecast narrative", "why is revenue up versus last year", or "write commentary for the variance slides". Do NOT use for computing the varia

110 stars 122 forksWriting & ContentOfficial

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add microsoft/cat-agent-skills --skill variance-commentary
Manual install
git clone --depth 1 https://github.com/microsoft/cat-agent-skills.git /tmp/cat-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/cat-agent-skills/submissions/finance-for-cowork/skills/variance-commentary ~/.claude/skills/variance-commentary

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Variance Commentary

Produces exec-ready variance narrative: short, fact-anchored blocks that drop straight into review
slides, a controller email, or board prep.

## When NOT to Use

- **Computing the variance or decomposing drivers in a model** → spreadsheet or BI work first
- **General stakeholder emails not anchored to a variance** → outside this skill's scope
- **Operational or headcount narratives** with no financial comparison → write directly
- **Forecast-change rationale** not tied to an actuals comparison → write directly

## Related Skills

Hand off rather than overlap:

- Prep for the review where the variance is presented — use forecast-review-prep instead.
- Anticipating questions on the variance — use stakeholder-qa-prep instead.
- Broad stakeholder messaging — outside this skill's scope.
- Recurring deliverables emails — use quarterly-workback instead.

## Workflow

### 1. Capture the inputs

From the user's message or recent context, establish:

- **Metric** — whatever the business actually tracks (revenue, bookings, margin, operating
  expense, cash, units, backlog)
- **Segment or business** — the reporting unit in scope
- **Period** — the fiscal period, in the user's own fiscal convention
- **Comparison basis** — versus plan, forecast, prior year, or prior quarter
- **Magnitude** — both the absolute variance and the percentage
- **Known drivers** — what the user already attributes it to
Read the full skill on GitHub

Details

Skill name
variance-commentary
Path
submissions/finance-for-cowork/skills/variance-commentary/SKILL.md
License
MIT
Repo updated
15 November 2026

FAQ

What does the Variance Commentary skill do?

Drafts crisp variance commentary for actuals versus plan, forecast, prior year, or prior quarter. Captures metric, segment, period, comparison basis, magnitude, and drivers, then produces a three-part block — headline, drivers, forward look — for each segment in scope, and searches recent email and chat for grounding when drivers aren't supplied. Use when the user asks to "write the variance commentary", "explain why we missed plan", "draft the actuals vs forecast narrative", "why is revenue up versus last year", or "write commentary for the variance slides". Do NOT use for computing the varia

How do I install the Variance Commentary skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add microsoft/cat-agent-skills --skill variance-commentary. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Variance Commentary popular?

It lives in microsoft/cat-agent-skills, which has 110 GitHub stars and 122 forks.

Related skills

3 Statements

110

microsoft/cat-agent-skills

Completes existing income statement, balance sheet and cash flow templates while preserving layout, grounding historical inputs and linking forecast formulas with reconciliation checks. Use for "fill in a 3-statement template", "complete an IS/BS/CF framework", "populate my integrated financial model", "link statements in this template", or "finish the forecasts in my three-statement workbook". Do NOT use for blank-slate models or general workbook edits (use xlsx), DCF valuation (use dcf-valuation), or buyout modeling (use lbo-model).

AI, LLMs & Agents122

Accessibility Pass

110

microsoft/cat-agent-skills

Use this skill whenever the user asks to check, review, or fix the accessibility of a PowerPoint deck, Word document, HTML page, or Markdown file, and before handing over any deck or document this agent just generated, so it does not ship with missing alt text, untitled slides, or unreadable colour contrast.

Frontend & Design122

Accessible Learning Materials

110

microsoft/cat-agent-skills

Maintains instructionally equivalent, accessible variants of a set of learning materials — lessons, readings, slides, and handouts — with parity checks against the original learning goals and recorded approvals. Use when the user asks to "make these materials accessible", "audit this lesson set for accessibility", "create an accessible version of this reading", "check reading level and alt text", or "keep my accessible variants in sync". Do NOT use for individual student accommodation or support-plan decisions (IEP, EHCP, or local equivalent), and do NOT use for generic document formatting (us

Learning & Education122

Wikipedia Human Style Writing

110

microsoft/cat-agent-skills

Use this skill whenever the user asks to write, rewrite, humanise, de-AI, or polish prose so it doesn't read as AI-generated — or to review a draft for signs of AI writing. Apply it before returning any substantial prose the user will publish.

Writing & Content122

Tool Tracer

110

microsoft/cat-agent-skills

Use ONLY when the user's message contains the exact command `/special-debug tool-trace` (optionally with `--full`); run the task normally, then write `tool_trace.json` summarizing tool/action/connector calls in order. Sensitive values (secrets, tokens, PII/PHI) are redacted by default; `--full` keeps them verbatim for an authorized admin.

Writing & Content122

Work Order Writeup

110

microsoft/cat-agent-skills

Renders one fixed-layout cited Markdown work-order draft for technician/planner review. Use for "draft technician notes", "write up this work order", "give the planner summary", or "show the proposed next action". No audience-switching or document-conversion feature. Do NOT use for intake — use wo-intake; retrieval — use knowledge-retrieve; ranking — use similar-work-rank; stock checks — use parts-readiness. No CMMS write-back, closure, scheduling or purchasing, even when approved.

Writing & Content122

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.