mcpbeat Sign in

Retirement Decumulation Agent Skill

Turn a retirement portfolio into sustainable lifetime income: sequence-of-returns risk, the 4% rule and its assumptions, Guyton-Klinger-style guardrails, RMD calculation from the Uniform Lifetime Table, Social Security claiming math (early reduction, delayed credits, breakeven age, survivor benefits), gap-year bracket-filling with Roth conversions, bucket strategies vs total-return, and SPIA annuitization as longevity insurance. Use when the user asks about a 'safe withdrawal rate', 'when should I claim Social Security', a 'guardrails strategy', 'sequence of returns risk', or 'how much can I spend in retirement'. Also trigger on RMD amounts or missed-RMD penalties, Social Security breakeven analysis, '4% rule', 'bucket strategy', retirement paycheck design, drawdown or decumulation planning, and whether to buy an annuity. For accumulation-side savings math, see savings-goals; for asset location and tax mechanics, see tax-efficiency.

9k 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 retirement-decumulation

What comes with it

20 182 bytes besides the instruction
scripts/retirement_decumulation.py

The instruction itself

19 sections, as written by the author

Retirement Decumulation

Core Concepts

Sequence-of-Returns Risk

Two retirees earning identical average returns can finish with very different wealth if the returns arrive in a different order while money is being withdrawn. Without withdrawals, order is irrelevant — multiplication commutes. With withdrawals, dollars sold after a decline are gone permanently and never participate in the recovery, so poor early returns do disproportionate damage. The danger zone is roughly the five to ten years on either side of the retirement date. Mitigants: flexible spending rules (guardrails), a cash/short-bond buffer, reduced equity exposure near retirement (or a rising equity glide path), and part-time income that lowers the withdrawal rate in early years.

Safe Withdrawal Rate (SWR) Framework

Bengen's 1994 study (extended by the 1998 Trinity study) found that an initial withdrawal of 4% of the portfolio, adjusted for inflation each year thereafter, survived every rolling 30-year US historical period with 50-75% stocks — the "4% rule." Its assumptions are also its criticisms: it relies on US historical returns (an unusually strong market), a fixed 30-year horizon, rigid inflation-adjusted spending with zero flexibility, and it ignores fees and taxes. Longer retirements, high starting valuations, or lower expected returns argue for 3-3.5% initial rates; dynamic rules (guardrails, amortization-based, RMD-style percent-of-balance) support higher initial rates because spending flexes with the portfolio.

Guardrails (Guyton-Klinger-Style Decision Rules)

A concrete dynamic rule set:

  • Initial rate: withdraw, e.g., 5.0% of the starting portfolio in year one.
  • Inflation rule: each year, increase the prior dollar withdrawal by inflation.
  • Guardrails: compute the current withdrawal rate = this year's withdrawal / current portfolio. Set guardrails at plus or minus 20% of the initial rate (for 5.0%: upper 6.0%, lower 4.0%).
  • Capital-preservation rule: if the current rate rises above the upper guardrail, cut the withdrawal 10%.
  • Prosperity rule: if the current rate falls below the lower guardrail, raise the withdrawal 10%.

The full Guyton-Klinger rule set also skips the inflation increase after a negative-return year. The trade-off: a higher starting income than the 4% rule, paid for with variable spending — the retiree must actually take the cuts when triggered.

Required Minimum Distributions (RMDs)

RMDs from tax-deferred accounts begin at age 73 under SECURE 2.0, rising to 75 in 2033 for those born in 1960 or later. Mechanics:

  • RMD = prior December 31 balance / distribution period (divisor) from the IRS Uniform Lifetime Table (use the Joint Life table instead if the sole beneficiary is a spouse more than 10 years younger).
  • Uniform Lifetime Table excerpt (table effective 2022, current as of 2026): age 73 → 26.5, 75 → 24.6, 80 → 20.2, 85 → 16.0, 90 → 12.2.
  • Missed-RMD penalty: 25% excise tax on the shortfall, reduced to 10% if corrected within the correction window (SECURE 2.0; previously 50%).
  • The first RMD can be delayed until April 1 of the year after the first RMD year, but then two RMDs land in one tax year.
  • Roth IRAs have no lifetime RMDs; since 2024, designated Roth 401(k) accounts are also exempt.
  • An RMD is a distribution requirement, not a spending requirement — excess can be reinvested in taxable or given via qualified charitable distribution (QCD, available at age 70 1/2, limit indexed annually — verify the current figure).

Social Security Claiming

Full retirement age (FRA) is 67 for those born in 1960 or later. The adjustment factors are statutory:

  • Early claiming: benefit reduced 5/9 of 1% per month for the first 36 months before FRA, and 5/12 of 1% per month beyond 36. Claiming at 62 with FRA 67 (60 months early): 36 x 5/9% + 24 x 5/12% = 20% + 10% = 30% reduction — the retiree gets 70% of the Primary Insurance Amount (PIA).
  • Delayed retirement credits: 2/3 of 1% per month (8% per year) for each month past FRA, up to age 70. Claiming at 70 with FRA 67: 36 x 2/3% = 24% increase — 124% of PIA.
  • Breakeven: months after the later claim age = B_early x months_delayed / (B_late - B_early), ignoring COLAs and discounting (COLAs apply proportionally to both paths).
  • Survivor benefit: the survivor keeps the larger of the two benefits, so delaying the higher earner's claim is longevity insurance on the second-to-die — breakeven for that decision should use joint life expectancy, which typically favors delay.
  • Claiming before FRA while still working triggers the earnings test (threshold indexed annually — verify the current figure); withheld benefits are restored through recomputation at FRA.

Withdrawal Sequencing and Gap-Year Bracket-Filling

The conventional order — taxable first, then tax-deferred, then Roth — preserves tax-free growth longest (see tax-efficiency for the tax mechanics and asset-location foundations). The decumulation refinement is the gap years: after retiring but before Social Security and RMDs begin, taxable-only withdrawals can leave the ordinary brackets nearly empty. Filling low brackets with partial Roth conversions (or tax-deferred withdrawals) in those years shrinks future RMDs, reduces the survivor's single-filer bracket exposure, and smooths lifetime tax rates — while watching Medicare IRMAA surcharge thresholds (indexed annually) that behave as cliffs. Delaying Social Security to 70 both earns delayed credits and widens the conversion window.

Bucket Strategies vs Total-Return

A bucket strategy holds 1-2 years of spending in cash, several more years in bonds, and the remainder in equities; spending comes from cash, refilled from the growth buckets opportunistically. A total-return approach holds one target allocation and funds withdrawals by rebalancing. Mathematically a maintained bucket structure is close to a fixed allocation with rebalancing discipline; its real value is behavioral — retirees tolerate equity drawdowns better knowing near-term spending is secured. The main failure mode is leaving the refill rules undefined.

Annuitization as Longevity Insurance

A single premium immediate annuity (SPIA) converts an irrevocable premium into lifetime income. Because payments pool longevity risk across annuitants, mortality credits let a SPIA sustain a higher payout rate than a self-insured portfolio at the same confidence level — insurance, not an investment to benchmark against market returns. A floor-and-upside design annuitizes enough (with Social Security) to cover essential expenses and invests the rest for growth. Trade-offs: nominal SPIAs carry inflation risk, liquidity and bequest are surrendered, and payments depend on insurer solvency (state guaranty association limits vary). Deferred income annuities and QLACs push income to advanced ages as a tail-longevity hedge (QLAC premium cap: $200,000 statutory base under SECURE 2.0, indexed annually — verify the current limit).

Key Formulas

| Formula | Expression | Use Case |

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

| Balance recursion (start-of-year withdrawal) | B_t = (B_{t-1} - W_t) x (1 + r_t) | Simulate a withdrawal plan / sequence risk |

| Inflation-adjusted withdrawal | W_t = W_1 x (1 + i)^(t-1) | Fixed-real spending path |

| Current withdrawal rate | CWR = W / B | Guardrail test each year |

| Guardrail bands | upper = r_0 x 1.20; lower = r_0 x 0.80 | Trigger thresholds |

| Guardrail adjustment | W' = W x 0.90 (cut) or W x 1.10 (raise) | Capital-preservation / prosperity rules |

| RMD | RMD = balance_Dec31 / divisor | Required minimum distribution |

| SS early reduction | factor = 1 - [min(m,36) x 5/9 + max(m-36,0) x 5/12]/100 | Benefit if claimed m months before FRA |

| SS delayed credit | factor = 1 + m x (2/3)/100 | Benefit if claimed m months after FRA (to 70) |

| SS breakeven | months after late claim = B_e x Δm / (B_l - B_e) | Age where delaying pulls ahead |

Worked Examples

Example 1: Sequence-of-returns risk

Given: $1,000,000 portfolio, $50,000 withdrawn at the start of each year (no inflation adjustment for clarity). Sequence A returns: -20%, +10%, +25%. Sequence B: the same returns reversed (+25%, +10%, -20%).

Calculate: Ending balances.

Solution:

  • No withdrawals: both orderings end at $1,000,000 x 0.80 x 1.10 x 1.25 = $1,100,000 — order is irrelevant.
  • Sequence A (crash first): Y1: (1,000,000 - 50,000) x 0.80 = 760,000. Y2: (760,000 - 50,000) x 1.10 = 781,000. Y3: (781,000 - 50,000) x 1.25 = $913,750.
  • Sequence B (crash last): Y1: 950,000 x 1.25 = 1,187,500. Y2: 1,137,500 x 1.10 = 1,251,250. Y3: 1,201,250 x 0.80 = $961,000.
  • Identical returns, identical withdrawals — the early-crash retiree ends $47,250 poorer. Over a 30-year retirement the same effect determines success or failure.

Example 2: Guardrails adjustment

Given: Retiree starts with $1,000,000 and a 5.0% initial rate ($50,000). Guardrails at plus or minus 20% of 5.0%: upper 6.0%, lower 4.0%. Adjustments are 10%.

Calculate: The required action in a bad-market year and a strong-market year.

Solution:

  • Capital preservation: after a bad year the portfolio is $780,000; the inflation-adjusted plan (3% inflation) calls for $50,000 x 1.03 = $51,500. Current rate = 51,500 / 780,000 = 6.60% > 6.0% upper guardrail → cut 10%: new withdrawal = 51,500 x 0.90 = $46,350 (rate 5.94%, back inside the bands).
  • Prosperity: later the portfolio reaches $1,400,000 with a planned $52,000 withdrawal. Current rate = 52,000 / 1,400,000 = 3.71% < 4.0% lower guardrail → raise 10%: new withdrawal = 52,000 x 1.10 = $57,200 (rate 4.09%).

Example 3: RMD at age 73

Given: Retiree turns 73 in 2026; the Traditional IRA balance on December 31 of the prior year was $850,000. Uniform Lifetime Table divisor at 73 = 26.5.

Calculate: The RMD and the penalty if entirely missed.

Solution:

  • RMD = 850,000 / 26.5 = $32,075.47 (about 3.77% of the balance).
  • If entirely missed: 25% excise tax = 32,075.47 x 0.25 = $8,018.87; if corrected within the correction window, 10% = $3,207.55.

Example 4: Social Security claiming breakeven

Given: PIA = $2,000/month at FRA 67 (born 1960 or later).

Calculate: Benefits at 62 and 70, and the breakeven ages (ignoring COLA and discounting).

Solution:

  • Claim at 62 (60 months early): reduction = 36 x 5/9% + 24 x 5/12% = 30% → $1,400/month.
  • Claim at 70 (36 months delayed): credit = 36 x 2/3% = 24% → $2,480/month.
  • 62 vs 67: head start = 60 x 1,400 = $84,000; monthly gain from waiting = $600. Breakeven = 84,000 / 600 = 140 months after 67 → age 78.7.
  • 67 vs 70: head start = 36 x 2,000 = $72,000; monthly gain = $480. Breakeven = 72,000 / 480 = 150 months after 70 → age 82.5.
  • A single claimant expecting to live past roughly 80-82 gains from delaying; for couples, the higher earner's delay is evaluated on joint life expectancy because of the survivor benefit.

Common Pitfalls

  • Treating the 4% rule as a guarantee rather than a historical US backtest with rigid assumptions — and applying it to 40-year early retirements or high-fee portfolios unadjusted
  • Planning with average returns and ignoring sequence: a Monte Carlo mean hides the early-crash paths that deplete portfolios
  • Adopting guardrails but refusing the spending cut when the capital-preservation rule triggers — the higher initial rate is only safe because of the cuts
  • Treating the RMD as a spending rule: it forces a taxable distribution, not consumption, and it is a floor, not a plan
  • Missing the two-RMDs-in-one-year trap when delaying the first RMD to April 1
  • Claiming Social Security at 62 by default, ignoring the survivor benefit — the higher earner's early claim permanently reduces the widow(er)'s income
  • Running Roth conversions that trip IRMAA surcharge cliffs or push conversion income into the next bracket
  • Leaving bucket refill rules undefined, so the strategy silently drifts to an ad hoc allocation
  • Judging a SPIA as an investment by implied return instead of as longevity insurance priced with mortality credits — or annuitizing so much that liquidity and bequest goals fail

Cross-References

  • savings-goals (wealth-management plugin): the accumulation-side counterpart — the safe withdrawal rate sizes the nest egg target that savings plans aim for
  • tax-efficiency (wealth-management plugin): asset location, Roth conversion breakeven, and the tax mechanics behind withdrawal sequencing and RMDs
  • asset-allocation (wealth-management plugin): glide paths and the equity/bond mix that governs sequence-risk exposure in decumulation
  • historical-risk (wealth-management plugin): drawdown and volatility measures that quantify the return sequences retirees must survive
  • emergency-fund (wealth-management plugin): the cash-reserve discipline that becomes bucket one of a retirement bucket strategy
  • investment-policy (wealth-management plugin): the IPS documents the spending policy, guardrail rules, and rebalancing discipline for decumulation
  • financial-planning-workflow (advisory-practice plugin): decumulation strategy is a core deliverable of the retirement-income phase of a comprehensive plan

Running the script

Run the reference implementation directly:

uv run scripts/retirement_decumulation.py      # PEP 723 header resolves dependencies automatically
python3 scripts/retirement_decumulation.py     # standard library only — no installs needed

A bare run prints a demo covering sequence-of-returns comparison, guardrails adjustments, RMD calculation and penalties, Social Security claiming factors, and breakeven ages. 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 retirement_decumulation import RetirementDecumulation) rather than run standalone.

Other skills for the same job

different authors, same section of the catalogue
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
Market News Analyst
by BaggaT236
×1

This skill should be used when analyzing recent market-moving news events and their impact on equity markets and commodities. Use this skill when the user requests analysis of major financial news from the past 10 days, wants to understand market reactions to monetary policy decisions (FOMC, ECB, BOJ), needs assessment of geopolitical events' impact on commodities, or requires comprehensive review of earnings announcements from mega-cap stocks. The skill automatically collects news using WebSearch/WebFetch tools and produces impact-ranked analysis reports. All analysis thinking and output are conducted in English.

19k tokens
Pead Screener
by BaggaT236
×1

Screen post-earnings gap-up stocks for PEAD (Post-Earnings Announcement Drift) patterns. Analyzes weekly candle formation to detect red candle pullbacks and breakout signals. Supports two input modes - FMP earnings calendar (Mode A) or earnings-trade-analyzer JSON output (Mode B). Use when user asks about PEAD screening, post-earnings drift, earnings gap follow-through, red candle breakout patterns, or weekly earnings momentum setups.

35k tokens scripts
Sprint Planning
by anthropics
vendor

Plan a sprint — scope work, estimate capacity, set goals, and draft a sprint plan. Use when kicking off a new sprint, sizing a backlog against team availability (accounting for PTO and meetings), deciding what's P0 vs. stretch, or handling carryover from the last sprint.

1k tokens
Kanchi Dividend Us Tax Accounting
by tradermonty

Provide US dividend tax and account-location workflow for Kanchi-style income portfolios. Use when users ask about qualified vs ordinary dividends, 1099-DIV interpretation, REIT/BDC distribution treatment, holding-period checks, or taxable-vs-IRA account placement decisions for dividend assets.

5k tokens scripts
Indie Business
by rshankras

Business fundamentals for indie app developers — LLC/entity setup, taxes, Apple Small Business Program, revenue tracking, hiring contractors, and financial planning for sustainability. Use when user asks about business setup, tax implications, hiring, or financial planning for their app business.

5k tokens
Tiktok Shop Inventory
by nexscope-ai

Inventory management for TikTok Shop — demand forecasting, viral stock planning, FBT optimization

446 tokens

How to use it

Copy the folder

Take joellewis/retirement-decumulation 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.