recap

Triggered by "monthly recap", "how did I do this month", "spending summary", "financial review", "weekly recap", "quarterly review", "year in review"

2,707 stars

Best use case

recap is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Triggered by "monthly recap", "how did I do this month", "spending summary", "financial review", "weekly recap", "quarterly review", "year in review"

Teams using recap should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/recap/SKILL.md --create-dirs "https://raw.githubusercontent.com/davepoon/buildwithclaude/main/plugins/cashflow/skills/recap/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/recap/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How recap Compares

Feature / AgentrecapStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Triggered by "monthly recap", "how did I do this month", "spending summary", "financial review", "weekly recap", "quarterly review", "year in review"

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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.

Related Skills

pagerduty-automation

2707
from davepoon/buildwithclaude

Automate PagerDuty tasks via Rube MCP (Composio): manage incidents, services, schedules, escalation policies, and on-call rotations. Always search tools first for current schemas.

outlook-calendar-automation

2707
from davepoon/buildwithclaude

Automate Outlook Calendar tasks via Rube MCP (Composio): create events, manage attendees, find meeting times, and handle invitations. Always search tools first for current schemas.

outlook-automation

2707
from davepoon/buildwithclaude

Automate Outlook tasks via Rube MCP (Composio): emails, calendar, contacts, folders, attachments. Always search tools first for current schemas.

one-drive-automation

2707
from davepoon/buildwithclaude

Automate OneDrive file management, search, uploads, downloads, sharing, permissions, and folder operations via Rube MCP (Composio). Always search tools first for current schemas.

oiloil-ui-ux-guide

2707
from davepoon/buildwithclaude

Modern, clean UI/UX guidance + review skill. Use when you need actionable UX/UI recommendations, design principles, or a design review checklist for new features or existing systems (web/app). Focus on CRAP (Contrast/Repetition/Alignment/Proximity) plus task-first UX, information architecture, feedback & system status, consistency, affordances, error prevention/recovery, and cognitive load. Enforce a modern minimal style (clean, spacious, typography-led), reduce unnecessary copy, forbid emoji as icons, and recommend intuitive refined icons from a consistent icon set.

obsidian-markdown

2707
from davepoon/buildwithclaude

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

obsidian-bases

2707
from davepoon/buildwithclaude

Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.

notion-automation

2707
from davepoon/buildwithclaude

Automate Notion tasks via Rube MCP (Composio): pages, databases, blocks, comments, users. Always search tools first for current schemas.

monday-automation

2707
from davepoon/buildwithclaude

Automate Monday.com work management including boards, items, columns, groups, subitems, and updates via Rube MCP (Composio). Always search tools first for current schemas.

mixpanel-automation

2707
from davepoon/buildwithclaude

Automate Mixpanel tasks via Rube MCP (Composio): events, segmentation, funnels, cohorts, user profiles, JQL queries. Always search tools first for current schemas.

miro-automation

2707
from davepoon/buildwithclaude

Automate Miro tasks via Rube MCP (Composio): boards, items, sticky notes, frames, sharing, connectors. Always search tools first for current schemas.

microsoft-teams-automation

2707
from davepoon/buildwithclaude

Automate Microsoft Teams tasks via Rube MCP (Composio): send messages, manage channels, create meetings, handle chats, and search messages. Always search tools first for current schemas.