mcpbeat Sign in

Savings Goals Agent Skill

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
npx skills add https://github.com/JoelLewis/finance_skills --skill savings-goals

What comes with it

19 004 bytes besides the instruction
scripts/savings_goals.py

The instruction itself

17 sections, as written by the author

Savings Goals

Core Concepts

Required Monthly Savings

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
  • Example: $80K/year spending / 0.04 = $2,000,000
  • Safe withdrawal rate: traditionally 4% (Bengen rule), adjusted for fees, taxes, longevity
  • Required savings rate: depends on starting age, current savings, expected returns
  • Employer match: always capture full match — it's an immediate 50-100% return
  • Catch-up contributions: additional 401(k)/IRA contributions allowed after age 50

Down Payment Saving

  • Typical target: 20% of home price (avoids PMI)
  • Timeline: typically 2-7 years → conservative allocation (HYSA, short-term bonds)
  • Include closing costs (2-5% of purchase price) in savings target

Goal Priority Framework

Recommended priority order:

  • Emergency fund (3-6 months expenses)
  • Employer 401(k) match (free money)
  • High-interest debt payoff (>6-8% rate)
  • HSA (triple tax advantage if eligible)
  • Max retirement accounts (401k, IRA, Roth)
  • Education funding (529)
  • Other goals (home, vacation, etc.)

Multiple Goal Balancing

  • Allocate savings across goals based on priority, timeline, and flexibility
  • Non-negotiable goals (retirement) take precedence over flexible goals
  • Shorter timelines need more conservative investment allocation
  • Use goal-based investing: separate sub-portfolios per goal with appropriate risk

Savings Rate Benchmarks

  • Minimum: 15% of gross income for retirement (including employer match)
  • Aggressive: 25-50%+ for early retirement / FIRE
  • Savings rate = total savings / gross income

Key Formulas

| Formula | Expression | Use Case |

|---------|-----------|----------|

| Required savings (PMT) | PMT = FV × r / [(1+r)^n - 1] | Monthly savings for a goal |

| Future value with savings | FV = PV(1+r)^n + PMT×[(1+r)^n - 1]/r | Project goal balance |

| Inflation adjustment | FV_real = FV_today × (1+π)^t | Convert today's dollars to future |

| Retirement target | Nest egg = annual spend / SWR | Size the retirement goal |

| Years to goal | n = ln(FV×r/PMT + 1) / ln(1+r) | How long until goal is funded |

| Savings rate | SR = total savings / gross income | Track savings discipline |

Worked Examples

Example 1: College Savings (529)

Given: Need $200,000 in 18 years, expect 7% annual return, starting from $0

Calculate: Required monthly savings

Solution:

  • Monthly rate: r = 0.07/12 = 0.005833
  • Months: n = 18 × 12 = 216
  • PMT = $200,000 × 0.005833 / [(1.005833)^216 - 1]
  • PMT = $1,166.67 / [3.5125 - 1]
  • PMT = $1,166.67 / 2.5125 = $464.34/month

Example 2: Retirement Accumulation

Given: Age 30, $50,000 currently saved, wants $2,000,000 by age 65, expects 8% annual return

Calculate: Required monthly savings

Solution:

  • Monthly rate: r = 0.08/12 = 0.006667; months: n = 35 × 12 = 420
  • FV of current savings (monthly compounding): $50,000 × (1.006667)^420 = $50,000 × 16.2925 = $814,627
  • Remaining needed: $2,000,000 - $814,627 = $1,185,373
  • PMT = $1,185,373 × 0.006667 / [(1.006667)^420 - 1]
  • PMT = $7,902.49 / [16.2925 - 1]
  • PMT = $7,902.49 / 15.2925 = $517/month
  • With employer match of $200/mo: personal contribution = $317/month

Common Pitfalls

  • Not inflation-adjusting future goals (college in 18 years costs much more than today)
  • Neglecting employer match — it's the highest guaranteed return available
  • Too conservative allocation for long-horizon goals (20+ years can tolerate equity risk)
  • Saving for college before adequately funding retirement (retirement has no financial aid)
  • Not revisiting savings rate as income grows (lifestyle creep absorbs raises)
  • Using average returns without considering sequence risk near goal date

Cross-References

  • time-value-of-money (core plugin): FV/PV calculations, annuity formulas
  • emergency-fund (wealth-management plugin): must be funded before other goals
  • debt-management (wealth-management plugin): high-interest debt payoff competes with savings
  • tax-efficiency (wealth-management plugin): 529 tax benefits, Roth vs traditional, HSA
  • investment-policy (wealth-management plugin): goal-based allocation aligns with IPS constraints
  • asset-allocation (wealth-management plugin): glide paths for target-date retirement savings
  • finance-psychology (wealth-management plugin): mental accounting, present bias, commitment devices
  • financial-planning-workflow (advisory-practice plugin): savings goals are key inputs to the comprehensive financial planning process
  • insurance-planning (wealth-management plugin): education and survivor-income goals feed the capital-needs calculation for life insurance sizing
  • estate-gifting (wealth-management plugin): 529 superfunding (5-year gift-tax election) lets grandparents front-load education goals within annual exclusions
  • 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.

Other skills for the same job

different authors, same section of the catalogue
Invoice Organizer
by frostant
×5

Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders. Turns hours of manual bookkeeping into minutes of automated organization.

3k tokens
Backtest Expert
by BaggaT236
×3

Expert guidance for systematic backtesting of trading strategies. Use when developing, testing, stress-testing, or validating quantitative trading strategies. Covers "beating ideas to death" methodology, parameter robustness testing, slippage modeling, bias prevention, and interpreting backtest results. Applicable when user asks about backtesting, strategy validation, robustness testing, avoiding overfitting, or systematic trading development.

15k tokens scripts
Analyzing Financial Statements
by anthropics
vendor ×2

This skill calculates key financial ratios and metrics from financial statement data for investment analysis

8k tokens scripts
Creating Financial Models
by anthropics
vendor ×2

This skill provides an advanced financial modeling suite with DCF analysis, sensitivity testing, Monte Carlo simulations, and scenario planning for investment decisions

8k tokens scripts
Earnings Calendar
by nicepkg
×2

This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings in the upcoming week, or needs a weekly earnings review. The skill focuses on mid-cap and above companies (over $2B market cap) that have significant market impact, organizing the data by date and timing in a clean markdown table format. Supports multiple environments (CLI, Desktop, Web) with flexible API key management.

17k tokens scripts
Agentic Wallet
by coinbase
vendor ×2

Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API calls, monetize an API, or query onchain data. Use whenever the user mentions signing in, login, authentication, wallet status, balance, address, sending money, paying someone, transferring tokens, ENS names, swapping/trading/converting tokens, funding/topping up/onramp, USDC, ETH, POL, SOL, the x402 bazaar, paid APIs, monetizing an endpoint, or querying onchain data on Base.

14k tokens
Alpha Vantage
by christophacham
×2

Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API. Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Requires a free API key from alphavantage.co.

13k tokens
Braintree Automation
by christophacham
×2

Braintree Automation: manage payment processing via Stripe-compatible tools for customers, subscriptions, payment methods, and transactions

2k tokens needs MCP

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.