benefits-decoder
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.
npx skills add mohitagw15856/pm-claude-skills --skill benefits-decoder --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Benefits Decoder Skill "Total compensation" decks are marketing. This skill reads the plan language like a friend who's been burned before: what each benefit is really worth, which promises have escape hatches, and what to get in writing before you sign. ## What This Skill Produces - A benefit-by-benefit decode with real annual values where computable - Ranked red flags: vesting cliffs, clawbacks, "discretionary" everything, coverage gaps - The 401k/pension match math and the equity math, arithmetic shown - Questions to ask HR before signing — and which answers to get in writing ## Required Inputs Ask for these only if they aren't already provided: - **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. ## Framework: Severity Scale - 🔴 **Can cost you real money** — vesting cliffs vs. their expected tenure, clawbacks (signing bonus, relocation, tuition,
- What This Skill Produces
- Required Inputs
- Framework: Severity Scale
- Output Format
- Benefits Decode: [company / offer]
- Quality Checks
- Anti-Patterns
- Based On
What does the benefits-decoder skill do?
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.
How do I install it?
Run `npx skills add mohitagw15856/pm-claude-skills --skill benefits-decoder --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From mohitagw15856/pm-claude-skills, a repository with 1,255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.