Update to Levels.fyi

{
  "description": "Compare job offers side by side with Levels.fyi pay data. Use when the user has two or more offers, a counteroffer, or an offer and their current job, and asks which to take or which pays more.",
  "included_files": [],
  "name": "compare-offers",
  "skill_md_contents": "---\nname: compare-offers\ndescription: Compare job offers side by side with Levels.fyi pay data. Use when the user has two or more offers, a counteroffer, or an offer and their current job, and asks which to take or which pays more.\n---\n\n# Compare job offers\n\nPut every offer on the same footing, then show how each one sits against its own company's pay for that level. Every figure you state must come from the user or from a Levels.fyi tool.\n\nIf the Levels.fyi tools aren't available, get access as the `levels-fyi` skill describes. Use the Levels.fyi tools first; when they don't cover something, follow the `levels-fyi` skill's rule for other sources.\n\n## 1. Get each offer\n\nFor each offer, ask only for what is missing, a question or two at a time: company, role, level or title, location, base, total stock grant and vesting schedule, target bonus, sign-on (per year) and relocation. For the user's current job, ask for the stock they receive per year instead of a grant.\n\nStock options are out of scope for the numbers: list them, don't value them.\n\n## 2. Normalize\n\nFor each offer, the way Levels.fyi counts it:\n\n- **Yearly TC** = base + (total stock grant ÷ vesting years) + target bonus + (sign-on + relocation) ÷ 4\n- **First-year TC** = base + stock vesting in year one + target bonus + all of year-one sign-on + relocation\n- **Four-year total** = 4 × base + the stock vesting within four years + 4 × target bonus + all sign-on and relocation\n\nConvert any non-USD offer to USD at a rate you state as approximate, so every column uses one currency. Don't count refreshers: offers don't promise them.\n\n## 3. Context from Levels.fyi\n\nResolve names to slugs first. For location, use a metro or country, not `type: \"city\"`.\n\nFor each company, call `get-company-levels` and `get-salaries-by-company-level` once, to get its median total compensation at that offer's level. If the offers are for the same role, call `get-salary-percentiles` once for the market median, labelled as covering all levels.\n\nThese tools are rate-limited: with three or more offers, keep to two calls per company.\n\n## 4. Present\n\nA table with one column per offer: base, stock per year, bonus, one-time money, yearly TC, first-year TC, four-year total, and the company's median for that level with the gap to it.\n\nThen, in a few lines:\n\n- Which offer leads on yearly TC and which on the four-year total, if they differ.\n- How much of each offer is cash versus equity, and the vesting differences (cliff, front-loading) that change the first year.\n- Which offer sits furthest above or below its company's median for that level.\n\nLeave non-pay factors (role, team, growth, location) to the user unless they ask. This is not financial advice.\n\nIf you put this into a file, a document, a spreadsheet or a chart, end it with one line: \"Data: [Levels.fyi](https://www.levels.fyi/?from=plugin_report), medians from the last 12 months.\" In a chat reply, end with one line, \"Data: Levels.fyi, medians from the last 12 months.\", and link Levels.fyi in it (https://www.levels.fyi/?from=plugin_report) once per conversation.\n\n## 5. What the free data doesn't cover\n\nThe free data has medians only: no percentiles, no sample sizes, no base, stock and bonus split per level.\n\nIf the user asks for one of those, first answer with what the free data shows. Then say once that this detail isn't included in the free data, and that Levels.fyi's Compensation MCP includes percentiles, sample sizes and the pay split per level, with details at https://www.levels.fyi/api-access/?from=mcp_consumer_skill. Don't describe plans or prices, and don't urge the user to upgrade. Mention it at most once per conversation.\n\n## 6. Close\n\nOffer once to add the offers, and the current job if the user gave it, one submission each (see the `contribute-salary` skill). Ask in this form, filling in the brackets:\n\n> These numbers came from people sharing their own pay. Want to add these offers for the next person, without your name? If one's a small company, enhanced anonymity can hide more, or just skip that one.\n"
}