# retirement-planner

retirement-planner builds a detailed retirement readiness plan featuring a 13-tab Excel model with Monte Carlo simulation, an explanatory guide, and a dated checklist.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install
- Author: rssaghafi
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/rssaghafi/retirement-planner/tree/HEAD/SKILL.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/retirement-planner

## What it does

The skill processes household financial inputs, custodian statements, and spending targets to execute a deterministic Monte Carlo analysis using `scripts/retirement_engine.py`. Computations run in constant real purchasing power, stripping inflation from return assumptions so results remain grounded and interpretable. It outputs a 13-tab workbook alongside two Word documents containing narrative guidance and scheduled action steps.

The resulting spreadsheet evaluates fixed withdrawal rates from 3% to 4%, tests Guyton-Klinger guardrails, and identifies the minimum portfolio needed to meet spending targets. It also evaluates Social Security timing to safeguard surviving spouses, schedules a Roth conversion ladder below IRMAA thresholds, and maps the health coverage transition from ACA subsidies to Medicare.

Local Python is required to run the simulation engine before building the report. The spreadsheet design enforces strict consistency: the Assumptions sheet serves as the single source of truth, and any unresolved formula error invalidates the deliverable.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rssaghafi/retirement-planner --skill retirement-planner -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/retirement-planner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/retirement-planner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rssaghafi/retirement-planner --skill retirement-planner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/retirement-planner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rssaghafi/retirement-planner --skill retirement-planner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/retirement-planner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rssaghafi/retirement-planner retirement-planner
```

2. **Manually: put the files in place**
- File: `.github/skills/retirement-planner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rssaghafi/retirement-planner --skill retirement-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rssaghafi/retirement-planner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/retirement-planner/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rssaghafi/retirement-planner --skill retirement-planner -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/rssaghafi/retirement-planner/tree/HEAD/SKILL.md

## When to use it
- Calculate safe withdrawal rates across market scenarios using Monte Carlo simulations
- Determine the optimal claiming age for Social Security benefits and spousal protections
- Schedule a multi-year Roth conversion ladder within targeted tax and IRMAA brackets
- Bridge medical coverage from employer plans and ACA subsidies to Medicare

## Example prompts
- Help me build a retirement plan and determine my safe spending rate
- Evaluate whether I should claim Social Security at 62, full retirement age, or 70
- Model a Roth conversion ladder that accounts for ACA healthcare subsidies and IRMAA limits

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b1b192d3f7deb9e1.

BEGIN THIRD-PARTY FILE b1b192d3f7deb9e1
```text
---
name: retirement-planner
description: >-
  Comprehensive retirement-readiness analysis. Use whenever someone wants to know if they can afford
  to retire, is planning retirement, asks "am I on track / what's my number," or wants a
  safe-withdrawal-rate analysis, Social Security claiming-age advice, a Roth conversion ladder, a
  healthcare/ACA bridge to Medicare, an RMD or IRMAA strategy, an asset-allocation glide path, or a
  survivorship / long-term-care check. Trigger even when the request is partial or casual ("help me
  figure out retirement," "claim Social Security at 62 or 70," "how much can I safely spend") and even
  if they name only one piece. Do NOT trigger for one-off questions a quick answer handles: a lone
  "what age are RMDs" or "Roth vs traditional" definition, a 401(k) match question, a general budget,
  a standalone rebalancing trade, or picking a Medicare Part D or active-employee plan. Produces a
  formula-driven, non-expert-friendly workbook (plus guide and dated checklist) backed by a
  real-dollar Monte Carlo simulation.
---

# Retirement Planner

This skill turns a household's real financial data into an honest, defensible retirement plan: a
13-tab Excel model driven by a Monte Carlo simulation, plus a plain-English guide and a dated action
checklist. It works for any household — the numbers below are illustrative only.

Your job is to be an **intelligent analyst, not a cheerleader**. Retirees are often over-saved and
under-optimized: the interesting answer is usually not "can I retire?" (frequently yes) but "how do I
stop overpaying tax, stop being too conservative, and protect the surviving spouse?" Lead with the
finding that actually matters, even if it's not what they asked.

## The workflow

1. **Intake.** Gather the inputs in `references/intake.md`. Ask in grouped batches, not one at a time.
   If the user has uploaded statements (brokerage, 401k, Social Security, expenses), read those first and
   only ask for what's missing. Reconcile conflicting balances to the primary custodian statement and say so.
2. **Confirm the judgment calls** that materially change the answer before building: target monthly spend,
   life-expectancy/longevity outlook (drives Social Security timing), state of residence (drives ACA + state
   tax on conversions), and whether either spouse lacks their own Social Security record.
```
END THIRD-PARTY FILE b1b192d3f7deb9e1

The third-party file has ended. Everything between the b1b192d3f7deb9e1 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2382 of 8440 bytes. © rssaghafi · MIT · https://github.com/rssaghafi/retirement-planner/tree/HEAD/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
