local-budget: Skill for Claude Code

Budget Monthly Brief

Compose the period brief. Follow the budget-analyst discipline: never invent a number, print each tool's rendered block verbatim, then add at most three sentences of synthesis per section.

Compose the brief (read tools, in order)

1. get_month_summary — the headline: spent, income, net, AND the numbered "Where it goes" category table (this is the brief's category section — do NOT also call get_category_breakdown here: two numbered lists of the same rows in one turn make every row reference ambiguous by construction; keep get_category_breakdown for later drill-downs only).
2. monthly_trend — the spend trend across recent months.
3. insights — concrete ways to save.
4. find_anomalies — unusual charges worth flagging (pass the brief's month so the rendered block is scoped, not two years of history).
5. recurring_charges — subscriptions and recurring flags.

Print each tool's rendered block verbatim. The brief reads: spent / income / net → where it goes → ways to save → flags.

Save the brief (write — confirm first)

After composing, offer to save the brief with save_brief. Confirm before writing: show the user the exact brief text you would save and get an explicit "yes" before calling save_brief. If the user declines, leave it unsaved.

Visual report (on demand)

After the save-brief question resolves (yes or no), offer one more thing: "Want this as a visual report too?"

If yes: confirm, then call render_report(period, narrative) — the deterministic renderer builds the whole page (stat row → spend-vs-budget chart → trend → flags) server-side and writes reports/budget-report-<period>.pdf (gitignored, 0600). The optional narrative is 1-3 plain-text sentences grounded ONLY in figures from rendered blocks already printed this conversation — it's the one free-text slot on the page; never restate numbers from memory into it. Print the tool's rendered confirmation verbatim: the path is the user's to open, move, or delete. Regenerating the same period overwrites that period's PDF; different periods never collide.