Skip to main content
skill CX Codex

year-end-summary — Claude Code skill: what it does, how to install

Generates an annual financial summary with monthly trends and category aggregates. Useful for tax filing and budgeting.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add openaccountant/skills --skill year-end-summary -a claude-code
Open on GitHub

What year-end-summary does

The skill aggregates a full year of transactions into an annual report. Using spending_summary and transaction_search, it tallies gross income, expenses, and net savings. It also lists your top ten largest expenses, frequent vendors, and monthly totals.

Anomaly detection flags irregular monthly spending spikes and major category shifts compared to the prior year. Transfers between personal accounts must be categorized properly, or they will distort total savings figures. The completed review exports directly to Markdown or CSV.

What it helps with

  • aggregate income and expense totals for the full year
  • track monthly spending trends in a structured table
  • identify the top ten largest expenses and frequent vendors
  • detect anomalous spending spikes across spending categories
  • export an annual financial report to Markdown or CSV

Example prompts for the agent

  • Generate an annual financial summary for the previous calendar year
  • Show monthly income and expense trends with the top 10 expenses for 2024
  • Check for spending anomalies across categories and export the year-end review

How to install year-end-summary

1Skills CLI (Vercel)

npx skills add openaccountant/skills --skill year-end-summary -a claude-code

2Manually: put the files in place

~/.claude/skills/year-end-summary/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/year-end-summary/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about year-end-summary

How do I install year-end-summary in Claude Code?

Run npx skills add openaccountant/skills --skill year-end-summary -a claude-code. You can also place the definition directly into ~/.claude/skills/year-end-summary/SKILL.md.

What does the year-end-summary skill do?

It reviews 12 months of transactions, measures savings rates, builds monthly trend tables, and highlights major expense spikes.

How does it handle transfers between personal accounts?

Self-transfers are excluded from income and expense calculations if they are categorized appropriately in your transaction data.

Source text

SKILL.md · MIT
---
name: year-end-summary
description: >
  Generate an annual financial review with totals, trends, and highlights.
---

# Year-End Summary

## Overview
Comprehensive annual financial review covering full-year income and expenses, monthly trends, category breakdowns, year-over-year comparisons, and financial highlights. Useful for tax preparation, goal setting, and understanding your overall financial picture.

## Wilson Tools Used
- `spending_summary` — monthly and category-level aggregates for the full year
- `transaction_search` — find notable transactions, income sources, largest expenses
- `anomaly_detect` — identify year-level anomalies and trend shifts
- `export_transactions` — export the full report as Markdown or CSV

## Workflow
1. Determine the target year (default: previous calendar year).
2. Use `spending_summary` for each month of the year to build a monthly trend table.
3. Use `spending_summary` for the full year grouped by category.
4. If prior year data exists, pull the same data for year-over-year comparison.
5. Use `transaction_search` to identify:
   - Top 10 largest expenses
   - All income sources and totals
   - Most frequent vendors
   - First and last transactions of the year
6. Use `anomaly_detect` across the full year to find:
   - Months with unusually high or low spending
   - Categories with significant year-over-year changes
7. Compile the report with sections below.
8. Export as Markdown file.

## Report Sections
```
# Year-End Summary — [Year]

## Annual Overview
| Metric | [Year] | [Prior Year] | Change |
|--------|--------|--------------|--------|
| Total Income | $XX,XXX | $XX,XXX | +/-XX% |
| Total Expenses | $XX,XXX | $XX,XXX | +/-XX% |
| Net Savings | $XX,XXX | $XX,XXX | +/-XX% |
| Savings Rate | XX% | XX% | +/-X pts |

## Monthly Trend
| Month | Income | Expenses | Net |
|-------|--------|----------|-----|
| Jan | ... | ... | ... |
| ... | ... | ... | ... |

## Spending by Category (Full Year)
| Category | Amount | % of Total | vs. Prior Year |
|----------|--------|------------|----------------|
| ... | ... | ... | ... |

## Top 10 Expenses
1. ...

## Income Sources
| Source | Total | Frequency |
|--------|-------|-----------|
| ... | ... | ... |

## Year Highlights
- Highest spending month: [Month] ($X,XXX)
- Lowest spending month: [Month] ($X,XXX)
- Biggest single expense: [Description] ($X,XXX)
- Most frequent vendor: [Vendor] (XX transactions)
```

## Without Wilson
To build a year-end summary in a spreadsheet:

1. **Gather data**: Export 12 months of transactions from your bank(s) as CSV. Combine into one sheet.
2. **Monthly trend pivot table**:
   - Rows: Month (use `=TEXT(A2,"YYYY-MM")` to extract)
   - Columns: Income vs. Expense (use `=IF(C2>0,"Income","Expense")`)
   - Values: SUM of Amount
3. **Category pivot table**:
   - Rows: Category
   - Values: SUM of Amount, COUNT of transactions
4. **Year-over-year**:
   - Keep prior year data in a separate tab
   - Use `=VLOOKUP` to pull prior year category totals next to current year
   - Calculate change: `=(Current - Prior) / ABS(Prior) * 100`
5. **Key formulas**:
   ```
   Annual Income:      =SUMPRODUCT((YEAR(A:A)=2025)*(C:C>0)*C:C)
   Annual Expenses:    =ABS(SUMPRODUCT((YEAR(A:A)=2025)*(C:C<0)*C:C))
   Savings Rate:       =(Income-Expenses)/Income*100
   Highest Month:      Use MAX on monthly totals pivot
   Most Frequent:      =INDEX(B:B,MATCH(MAX(COUNTIF(B:B,B:B)),COUNTIF(B:B,B:B),0))
   ```
6. **Export**: Copy the summary tables into a Google Doc or Word document for your records.

## Important Notes
- Year-over-year comparison requires at least partial data from the prior year. If unavailable, that column is omitted.
- Savings rate uses gross income (before taxes) unless you've categorized tax payments separately.
- The report includes all transaction types. Transfers between your own accounts are excluded from income/expense totals if properly categorized.
- This report pairs well with the `tax-deduction-tracker` skill for tax season preparation.

© openaccountant · MIT · openaccountant/skills

Similar skills

All skills for Finance and business →

From the same set44

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor