Recap
BusinessrecapRecap is an Agent Skill for business published in the davepoon/buildwithclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Triggered by "monthly recap", "how did I do this month", "spending summary", "financial review", "weekly recap", "quarterly review", "year in review"
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/cashflow/skills/recap/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/recap, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Financial Recap
Generate a narrative financial review for any time period.
Workflow
-
Determine the period. Parse
$ARGUMENTSfor the time span:- "this week", "last week" → weekly
- "this month", "january", "jan 2025", "2025-01" → monthly (default if no argument)
- "this quarter", "Q1", "Q1 2025" → quarterly
- "this year", "2025", "year in review" → yearly
- Any explicit date range works too
-
Fetch summary data. Call the
queryMCP tool withcompare: "prior_period":{ "period": "<detected_period>", "compare": "prior_period", "include": ["ratios", "anomalies", "accounts"] }(Use
start/endif a specific date range was requested.) -
Fetch year-ago comparison. For anything other than year-over-year, also fetch the same period from a year ago to account for seasonality:
{ "start": "<same_period_last_year_start>", "end": "<same_period_last_year_end>", "include": ["ratios"] }For example, if reviewing February 2026, also fetch February 2025.
-
Fetch recurring bills. Call the
queryMCP tool:{ "recurring": true } -
Synthesize a narrative recap covering:
- Headline numbers: total income, total expenses, net cash flow, savings rate
- vs. prior period: changes from the immediately preceding period (last week, last month, etc.)
- vs. same period last year: seasonal context — note whether changes are normal for this time of year or unusual (skip this section for year-over-year recaps)
- Anomalies: unusual transactions or spending spikes
- Recurring bills: new, changed, or cancelled subscriptions/bills
- Key ratios: any ratios returned in the summary (e.g. expense-to-income)
- Account balances: current balances and changes
-
Tone: Stick to the facts. Report what happened without judgement — no "great job" or "you need to cut back." Just clear, plain-language observations. Skip categories with trivial amounts.