From super-tax-agent
RSU and ESPP income tax rules. Invoked by core skills when W2 box 14 contains RSU codes, 1099-B contains ESPP/RSU lots, or user mentions stock compensation during interview.
npx claudepluginhub fangyi-chen/tax-marketplace --plugin super-tax-agentThis skill is limited to using the following tools:
Core skills invoke this domain skill when:
Advises on US taxes for W-2, 1099, S-Corp filers: identifies deductions, logs expenses to JSON, assesses audit risk, optimizes brackets, plans estimated payments, handles multi-state filing and life events.
Interactively assesses required Japanese tax filings (確定申告, 消費税, 住民税) by interviewing on income, business status, prior returns, stocks/FX/crypto details.
Start the interactive tax filing process. Use when the user wants to begin filing taxes, start a tax return, or says "do my taxes".
Share bugs, ideas, or general feedback.
Core skills invoke this domain skill when:
tax-start: User mentions RSU vesting, ESPP, stock compensation, equity awards, or "company stock"tax-import: W2 box 14 contains codes such as RSU, RSUS, ISO, NQ, NQSO, ESPP, or dollar amounts labeled as stock income; or 1099-B lots include "RSU", "ESPP", or "supplemental" in the description fieldtax-calculate: domains.rsu in tax-profile.json is non-nullAsk these questions when triggered. Ask 2-3 at a time; do not overwhelm.
Add under domains.rsu in data/tax-profile.json:
{
"domains": {
"rsu": {
"hasRSU": true,
"hasESPP": false,
"rsuLots": [
{
"vestDate": "2025-03-15",
"sharesVested": 100,
"fmvAtVest": 42.50,
"sharesWithheldForTax": 30,
"saleType": "sell-to-cover",
"saleDate": "2025-03-15",
"salePricePerShare": 42.48,
"w2IncomeReported": 4250.00,
"federalWithheld": 935.00,
"supplementalRateUsed": 0.22
}
],
"esppLots": [
{
"offeringDate": "2025-01-01",
"purchaseDate": "2025-06-30",
"offeringDateFMV": 38.00,
"purchaseDateFMV": 44.00,
"purchasePriceActual": 32.30,
"sharesPurchased": 50,
"sharesSold": 50,
"saleDate": "2025-09-10",
"salePricePerShare": 46.00,
"dispositionType": "disqualifying",
"w2IncomeReported": 580.00
}
],
"isoExercises": [],
"nsoExercises": []
}
}
}
Field notes:
saleType: one of same-day, sell-to-cover, hold, no-saledispositionType for ESPP: qualifying (held >2yr from offering + >1yr from purchase) or disqualifyingw2IncomeReported: the dollar amount already included in W2 box 1 for this lot (prevents double-counting)Requirements: held >2 years from offering date AND >1 year from purchase date.
Requirements: sold before meeting qualifying disposition holding periods.
Read skills/tax-domain-rsu/references/rsu-tax-rules.md for detailed IRS citations, Publication 525 rules, and Form 8949 instructions.