Plan and track savings for specific financial goals including retirement, education, and home purchase. Use when the user asks about required savings rates, 529 plans, retirement accumulation targets, down payment planning, or goal prioritization. Also trigger when users mention 'how much do I need to save each month', 'am I on track for retirement', 'college savings', 'safe withdrawal rate', '4% rule', 'FIRE savings rate', 'catch-up contributions', 'employer match', or ask how to balance competing savings goals.
7k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
161
stars on the repo
on the repository, not the skill itself
Install
one command, takes just this skill from the repository
To accumulate a future value FV in n periods at rate r per period:
PMT = FV × r / [(1+r)^n - 1]
This is the sinking fund formula (future value of annuity solved for PMT).
Inflation-Adjusted Targets
Always compute goals in future (nominal) dollars:
FV_nominal = FV_today × (1 + inflation)^years
Then solve for the required savings using the nominal return, or use the real return with today's dollars.
Education Funding
529 plans: tax-free growth for qualified education expenses, state tax deductions in many states
Current costs (2025-26, total cost of attendance, College Board Trends in College Pricing): ~$30K/year (public four-year in-state) to ~$65K/year (private nonprofit), growing ~5%/year
Front-loading: maximize early contributions for compound growth
Superfunding: 5-year gift tax averaging (contribute 5× annual exclusion at once)
Financial aid impact: parent-owned 529 assets are assessed at a maximum of 5.64% in the federal Student Aid Index (SAI) formula — FAFSA has used the SAI in place of the Expected Family Contribution (EFC) since the 2024-25 award year
Retirement Accumulation
Target nest egg: annual spending need / safe withdrawal rate
retirement-decumulation (wealth-management plugin): the drawdown-side counterpart — safe withdrawal rates and spending rules for the nest egg accumulated here
Running the script
Run the reference implementation directly:
uv run scripts/savings_goals.py # PEP 723 header resolves dependencies automatically
python3 scripts/savings_goals.py # standard library only — no installs needed
A bare run prints a demo covering required monthly savings, retirement accumulation, time-to-goal, inflation adjustment, shortfall analysis, education funding, savings rate, and real returns. Use --verify to recompute the demo figures and assert they match this skill's worked examples (prints PASS/FAIL, exits nonzero on mismatch), and --help to list the available classes and functions. The file is primarily meant to be imported as a module (from savings_goals import SavingsGoals) rather than run standalone.
How to use it
Copy the folder
Take joellewis/savings-goals from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
Check the name does not clash
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.