4P
401k Plan Decoder
🔵 Stable🕐 updated 2026-07-18
🔷 SkillSpec L3
pm-decoders
Decode a 401k or workplace retirement plan — the real cost of its funds, the match's fine print, vesting math, and the plan features worth using or avoiding. Use when someone asks 'is my 401k any good', 'decode my 401k plan', 'which funds should I look at', or 'what fees am I paying'. Produces a fee decode in dollars-over-time, match and vesting math, a fund-lineup triage by cost, and the questions for HR or the plan administrator.
What to give it
▸The plan documents — fund lineup with expense ratios (the fee disclosure / 404a-5 notice is the gold source), match formula, vesting schedule, summary plan description excerpts. Decode what's provided; list what's missing by name.
▸Their numbers — salary, current contribution %, balance, and age band — needed to make fees and match concrete.
▸Tenure expectation — vesting math is meaningless without it.
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓Every fee is converted to dollars-over-time with assumptions labeled, never left as a percentage
✓The per-paycheck vs. true-up distinction is checked and quoted from the documents
✓Vesting forfeiture is computed at the user's stated tenure
✓Cost-tier triage compares funds *within this lineup*, not against the whole market
✓Missing documents are listed by name, and silent features are `[to confirm]`
✓The disclaimer line appears verbatim in the artifact
⚠️ What it refuses to do
Do not recommend specific funds or allocations — decode cost and structure; the picking is the user's (or their advisor's)
Do not invent fees or plan terms that aren't in the documents
Do not present the fee-drag projection as a prediction — it's an illustration with labeled assumptions
Do not soften the below-the-match finding — declining free money is the headline, say it plainly
Do not treat jurisdiction- and plan-specific rules (loans, withdrawals, protections) as universal
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
Related skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="401k-plan-decoder"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>
💬 Discussion
401k Plan Decoder is one of 599 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog