BD
Benefits Decoder
🔵 Stable🕐 updated 2026-07-14
🔷 SkillSpec L3
pm-decoders
Decode an employment benefits package into what it's actually worth and where the fine print bites. Use when someone asks 'is this offer good', 'decode my benefits package', 'what does my equity actually mean', or 'what should I ask HR before signing'. Produces a benefit-by-benefit decode with real dollar values, ranked red flags (vesting cliffs, clawbacks, 'discretionary' bonuses, unlimited-PTO economics), and the questions to ask HR before signing.
What to give it
▸The benefits documents — offer letter, benefits summary, equity grant terms, plan excerpts. Decode what's provided; list what's still needed (equity plan, insurance summary of benefits, bonus plan terms).
▸Base salary and equity grant details — if not in the text — needed for the math.
▸Their situation — dependents/health needs, how long they realistically expect to stay.
✅ 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 valuation is shown as arithmetic with stated assumptions, not asserted
✓"Discretionary" and "employed on payment date" language is quoted and decoded bluntly
✓Cliff/clawback flags are tied to the user's stated expected tenure
✓Missing documents and unverifiable numbers are listed as `[to confirm]`
✓Genuinely standard terms are marked 🟢 — not everything is a trap
✓The disclaimer line appears verbatim in the artifact
⚠️ What it refuses to do
Do not invent benefits or terms that aren't in the documents
Do not soften a red flag to seem balanced — "discretionary" means no bonus is owed; say it
Do not present jurisdiction-dependent rules (PTO payout, clawbacks) as universal
Do not take equity at face value without flagging the valuation assumption
Do not let the "total comp" headline stand — rebuild it from the plan language
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-mcpRelated skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="benefits-decoder"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>💬 Discussion
Benefits 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