financial-goals — Claude Code skill: savings goals and progress
This skill sets savings goals with target dates, works out the monthly amount each one needs, and tracks whether you are ahead or behind.
npx skills add openaccountant/skills --skill financial-goals -a claude-codeWhat financial-goals does
You name your goals — a vacation, a down payment, a car — and give each one a target amount, a date, and a dedicated account or label. The skill then calculates the months left and the monthly savings required, and estimates progress from your transaction history.
Two Wilson tools do the work. spending_summary pulls income and expenses for the last 3 months to derive your current savings rate. transaction_search looks for deposits and earmarked transfers tied to a goal name or account over 6 months. The result is a dashboard with progress bars and an on-track flag. When the total required per month exceeds what you can actually put aside, the skill flags the shortfall and suggests pushing dates out, trimming targets, or raising income.
One catch worth knowing before you start: Wilson sees transaction activity, not account balances, so you have to supply the starting balance for every goal yourself. Run several goals through a single savings account and the skill cannot tell contributions apart unless your transfers carry descriptive memos. Separate accounts, or at least clear memo fields, save you a lot of guessing.
What it helps with
- work out the monthly amount each goal needs
- see which goals are on track and which are slipping
- find deposits tied to one account over six months
- compare total goal obligations against your real savings rate
- order goals by deadline when some are fixed and some are flexible
Example prompts for the agent
- Set up savings goals for a vacation and a down payment, and calculate the monthly amount for each
- Check my transactions to see how much I have saved toward the car
- Show the goals dashboard and tell me where I am behind schedule
How to install financial-goals
1Skills CLI (Vercel)
npx skills add openaccountant/skills --skill financial-goals -a claude-code2Manually: put the files in place
~/.claude/skills/financial-goals/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/financial-goals/
1Skills CLI (Vercel)
npx skills add openaccountant/skills --skill financial-goals -a codex2Manually: put the files in place
.agents/skills/financial-goals/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openaccountant/skills --skill financial-goals -a cursor2Manually: put the files in place
.cursor/skills/financial-goals/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openaccountant/skills financial-goals2Manually: put the files in place
.github/skills/financial-goals/SKILL.md1Skills CLI (Vercel)
npx skills add openaccountant/skills --skill financial-goals -a gemini-cli2Platform CLI
gemini skills install https://github.com/openaccountant/skills --path personal/financial-goalsManually: put the files in place
.devin/skills/financial-goals/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openaccountant/skills --skill financial-goals -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 financial-goals
How do I install financial-goals in Claude?
Run npx skills add openaccountant/skills --skill financial-goals -a claude-code. The skill lands in ~/.claude/skills/financial-goals/SKILL.md.
What does financial-goals do?
It calculates the months remaining and the monthly savings required for each goal, then estimates progress from your transaction history. It also checks whether your total obligations fit your savings rate.
Why can't the skill see how much I have saved?
Wilson tracks transactions but not account balances, so you enter the starting balance for each goal. If one savings account covers several goals, descriptive memos on transfers are what let the skill tell them apart.
Source text
SKILL.md · MIT
---
name: financial-goals
description: >
Set savings goals with timelines and track monthly progress toward them.
---
# Financial Goals Tracker
## Overview
Helps you define specific savings goals (vacation, down payment, new car, etc.), calculates the required monthly savings for each, tracks progress from your transaction history, and alerts you when you are ahead or behind schedule.
## Wilson Tools Used
- `spending_summary` — determine current savings rate and available capacity for goals
- `transaction_search` — find deposits and transfers related to specific goals
## Workflow
1. Ask the user to define their goals. For each goal, collect: name, target amount, target date, and any dedicated savings account or label.
2. Run `spending_summary` for the last 3 months to calculate average monthly income and average monthly expenses. Derive the current monthly savings rate: `income - expenses`.
3. For each goal, calculate:
- Months remaining: difference between today and target date
- Required monthly savings: `(target amount - current progress) / months remaining`
4. Run `transaction_search` with `query: "<goal name> OR <account name>"` and `months: 6` for each goal to find related deposits or earmarked transfers.
5. Sum the deposits found to estimate current progress toward each goal.
6. Present a goals dashboard:
```
FINANCIAL GOALS
═══════════════════════════════════════════════════════
Vacation Fund
Target: $3,000 by Dec 2026 | Saved: $1,200 (40%)
Required: $300/mo | On track: YES
[████████░░░░░░░░░░░░] 40%
Down Payment
Target: $40,000 by Jun 2028 | Saved: $12,000 (30%)
Required: $1,120/mo | On track: NO (-$220/mo)
[██████░░░░░░░░░░░░░░] 30%
═══════════════════════════════════════════════════════
Total required: $1,420/mo | Available: $1,200/mo
```
7. If total required monthly savings exceeds available savings rate, flag the shortfall and suggest either extending timelines, reducing targets, or increasing income.
8. Prioritize goals by deadline and suggest an allocation order.
## Without Wilson
1. Open a spreadsheet and create columns: Goal Name, Target Amount, Target Date, Current Balance, Monthly Required.
2. For current balance, check the account(s) designated for each goal. If you use a single savings account for everything, you will need to track allocations manually (one row per goal with a running tally).
3. Calculate months remaining: in Google Sheets, `=DATEDIF(TODAY(), C2, "M")` where C2 is the target date.
4. Monthly required: `=(B2-D2)/E2` where B2 is target, D2 is current balance, E2 is months remaining.
5. Sum the "Monthly Required" column to see your total goal obligations.
6. Check your monthly savings capacity: review last month's bank statement, note total deposits minus total non-savings expenses.
7. If total required exceeds your capacity, either push target dates out or reduce amounts.
8. Apps that help: Ally Bank has built-in "Buckets" for goal tracking. Capital One 360 allows multiple savings accounts. YNAB has explicit goal tracking.
9. Set up automatic transfers for each goal amount on payday to avoid relying on willpower.
## Important Notes
- Wilson tracks transaction activity but does not know your account balances. You must provide starting balances for each goal.
- If you use a single savings account for multiple goals, Wilson cannot distinguish between goal contributions without descriptive memo fields on transfers.
- Reassess goals quarterly. Life changes, and rigid goals that no longer matter will drain motivation.
- Consider prioritizing goals with fixed deadlines (tax payments, tuition) over flexible ones (vacation, new car).
© openaccountant · MIT · openaccountant/skills