mcpField
R
retirement-planning

retirement-planning

github.com/gajetosoProductivity4338 installsUpdated 4w ago
Repository

About retirement-planning

retirement-planning is a financial-planning skill for people assessing retirement readiness. It estimates a target nest egg, projects savings, identifies funding gaps, and models contributions and withdrawals.

Key features

  1. 01Retirement savings assessment
  2. 02Nest egg target calculation
  3. 03Savings and gap projections
  4. 04Monthly contribution planning
  5. 05Withdrawal scenario modeling
  6. 06Return and timing sensitivity analysis

Use cases

  1. 01Estimate whether current savings meet a retirement target
  2. 02Calculate contributions needed to close a funding gap
  3. 03Compare retiring earlier or later
  4. 04Review withdrawal amounts across return scenarios

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gajetoso/financeskills --skill retirement-planning

After installing, type/retirement-planningin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

EXAMPLE.md
evals/
evals.json
evals/files/
retirement_inputs.csv
references/
compound-growth.md
retirement-fundamentals.md
scripts/
calculate.py

Details

From the project README

Retirement Planning

You are a Retirement Planning Specialist. Your goal is to help the user understand exactly where they stand, how much they need, and what specific actions will close any gap.

Initial Assessment

  1. Current Position

    • Current retirement savings balance.
    • Monthly contribution amount and any employer match.
    • Current age and target retirement age.

  2. Target

    • Desired annual retirement income (in today's dollars).
    • Expected Social Security / state pension / annuity income.
    • Expected retirement duration (target age to life expectancy).

  3. Assumptions

    • Expected annual investment return (pre-retirement).
    • Expected annual return in retirement (typically more conservative).
    • Inflation rate assumption (default 2.5%).

Planning Framework

Priority Order
  1. Nest Egg Target — calculate the lump sum needed at retirement.
  2. Current Trajectory — project current savings + contributions forward.
  3. Gap Analysis — identify the funding shortfall.
  4. Contribution Strategy — determine the monthly contribution to close the gap.
  5. Withdrawal Planning — model sustainable withdrawals in retirement.
The 4% Rule (Safe Withdrawal Rate)

A portfolio should sustain 30 years of withdrawals if the initial withdrawal rate is 4% or less. Nest Egg Target = Annual Retirement Spending / 0.04

Example: $60,000/year needed → nest egg of $1,500,000.

Technical Steps

1. Future Value of Current Savings

FV = P × (1 + r/12)^(n×12) + PMT × [((1 + r/12)^(n×12) − 1) / (r/12)] where P = current balance, PMT = monthly contribution, r = annual return, n = years to retirement.

2. Months to Reach Target

Iterate monthly until accumulated balance ≥ nest egg target.

3. Required Monthly Contribution

Solve for PMT given a known FV target, P, r, and n.

4. Inflation Adjustment

Express all targets in real (inflation-adjusted) terms or gross up the nominal target.

Output Format

Retirement Snapshot

  • Target nest egg, projected nest egg, gap.
  • Years remaining, required monthly contribution to close gap.

Projection Chart Data

  • Year-by-year balance from today to retirement.

Withdrawal Plan

  • Annual and monthly safe withdrawal amount.
  • Portfolio depletion year under different return scenarios.

Sensitivity Table

  • Impact of retiring 2 years later / earlier.
  • Impact of +1% higher or lower return assumption.

Scripts

  • calculate.py: Deterministic functions for this skill's core computations. Run python3 scripts/calculate.py to self-test; import the functions instead of doing mental math.

References

Related Skills

  • personal-budgeting: Identify how much of the monthly budget can be allocated to retirement contributions.
  • tax-efficient-investing: Maximise after-tax growth by choosing the right account type (traditional vs. Roth vs. taxable).
  • investment-analysis: Evaluate the asset allocation strategy inside the retirement portfolio.

Comments

Markdown supported