recap · davepoon — Claude Code skill: what it does, how to install
The recap skill for Claude Code and Cursor generates a narrative financial review for any time period using MCP tools.
MIT 105 installs ★ 3,785 updated 2026-10-25
npx skills add davepoon/buildwithclaude --skill recap -a claude-codeWhat recap does
Triggered by phrases like monthly recap or financial review, the skill parses time spans and queries summary data. It compares current metrics against prior periods and the same timeframe last year to factor in seasonality. The output covers headline numbers, spending anomalies, recurring bills, and account balances.
The skill relies on the query MCP tool to fetch financial data and requires that server to be active. It reports observations objectively without adding judgements or unnecessary commentary.
What it helps with
- generate a monthly financial recap
- compare spending with prior periods
- analyze seasonal budget changes
- review recurring bills and subscriptions
Example prompts for the agent
- monthly recap
- spending summary for january
- financial review for Q1
How to install recap
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill recap -a claude-code2Manually: put the files in place
~/.claude/skills/recap/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recap/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill recap -a codex2Manually: put the files in place
.agents/skills/recap/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill recap -a cursor2Manually: put the files in place
.cursor/skills/recap/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davepoon/buildwithclaude plugins/cashflow/skills/recap2Manually: put the files in place
.github/skills/recap/SKILL.md1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill recap -a gemini-cli2Platform CLI
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/cashflow/skills/recapManually: put the files in place
.devin/skills/recap/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill recap -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about recap
How to install recap in Claude Code?
Run npx skills add davepoon/buildwithclaude --skill recap -a claude-code in your terminal and check ~/.claude/skills/recap/SKILL.md.
What does recap do?
It fetches financial data and generates a plain-language narrative review covering income, expenses, anomalies, and recurring bills.
What is needed to run recap?
It requires a configured MCP server that provides the query tool to fetch financial records and account balances.
Source text
SKILL.md · MIT
---
name: recap
description: Triggered by "monthly recap", "how did I do this month", "spending summary", "financial review", "weekly recap", "quarterly review", "year in review"
---
# Financial Recap
Generate a narrative financial review for any time period.
## Workflow
1. **Determine the period.** Parse `$ARGUMENTS` for 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
2. **Fetch summary data.** Call the `query` MCP tool with `compare: "prior_period"`:
```json
{ "period": "<detected_period>", "compare": "prior_period", "include": ["ratios", "anomalies", "accounts"] }
```
(Use `start`/`end` if a specific date range was requested.)
3. **Fetch year-ago comparison.** For anything other than year-over-year, also fetch the same period from a year ago to account for seasonality:
```json
{ "start": "<same_period_last_year_start>", "end": "<same_period_last_year_end>", "include": ["ratios"] }
```
For example, if reviewing February 2026, also fetch February 2025.
4. **Fetch recurring bills.** Call the `query` MCP tool:
```json
{ "recurring": true }
```
5. **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
6. **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.
© davepoon · MIT · davepoon/buildwithclaude
Similar skills
All skills for Finance and business →recap by other authors comes first.