Work out W-4 withholding elections (new job, job change, mid-year income jump, or an annual check-up) using the official IRS Tax Withholding Estimator, and translate the result into concrete W-4 form entries.
Scanned 9/20/2026
Install to Claude Code
npx -y skills add tstapler/dotfiles --skill w4-tax-withholding --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of W4 Tax Withholding?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/tstapler-w4-tax-withholding)More formats (shields.io, HTML) on the badges page.
---
name: w4-tax-withholding
description: Work out W-4 withholding elections (new job, job change, mid-year income jump, or an annual check-up) using the official IRS Tax Withholding Estimator, and translate the result into concrete W-4 form entries.
---
# W-4 Tax Withholding
Figure out what to put on a Form W-4 by running the numbers through the IRS's own
calculator rather than hand-deriving tax brackets. Hand math is fast but error-prone
(progressive brackets, phase-outs, and multi-job interactions are easy to get wrong by
a few thousand dollars) — the live tool is authoritative and free.
## When to use this
- Starting a new job (especially mid-year)
- A large raise, bonus, or income jump
- Getting married, having a kid, spouse starting/stopping work
- Annual January withholding check-up
- Suspecting under- or over-withholding from a paystub review
## Required inputs — gather these first
Pull from the most recent paystub(s) for every job held this year:
- **Gross YTD income** and **federal tax withheld YTD** (per job, if more than one this year)
- **Pay frequency** (weekly / biweekly / semi-monthly / monthly) — for a job that hasn't
started paying yet, this has to come from the offer letter or payroll onboarding docs,
not a guess. Flag it explicitly as unconfirmed if it's an assumption.
- **Pre-tax contributions**: retirement (401k/403b), health insurance, HSA/FSA
- Filing status, dependents, other income (interest/dividends/capital gains/rental),
itemized deduction candidates (mortgage interest, property tax, charitable giving)
Don't guess these when they matter — a wrong pay-frequency assumption or a placeholder
SALT figure changes the Step 4(c)/Step 3 dollar amount materially. Say clearly which
inputs are real (from a paystub) vs. estimated, and flag what to re-verify once real
numbers land (e.g., "rerun once the first paycheck from the new job arrives").
## Running the estimator
Use the browser to drive **https://apps.irs.gov/app/tax-withholding-estimator** —
no login required, free, official. It's a 7-step wizard:
1. **About you** — age/blind/dependents/filing status (+ spouse questions if MFJ)
2. **Income & tax payments** — add each W-2 job. A job that's already ended this year
("part of the year," dates in the past) asks for YTD gross + YTD federal withheld +
pre-tax contributions. A job that hasn't started paying yet still requires a first
pay-period date/amount — use the salary ÷ pay-periods-per-year as the per-check
estimate, and enter **$0** for "gross income so far" and "federal taxes withheld so
far" since nothing's been paid yet.
3. **Adjustments** — IRA/HSA/educator expenses/alimony (usually blank)
4. **Deduction choice** — standard vs. itemized. The tool tells you the *current-year*
standard deduction and SALT cap live — don't assume last year's numbers here, they
change (e.g., the SALT cap jumped from $10,000 to $40,000+ starting with the 2025
OBBBA changes). Enter state/local tax and mortgage interest estimates if itemizing.
5. **Additional deductions** — QBI, car loan interest (rare for W-2-only households)
6. **Credits** — child tax credit, education credits, etc.
7. **Results** — shows estimated amount owed/refunded, and a **per-job W-4
recommendation table** (Steps 1–4c) with a downloadable pre-filled PDF.
Tip: this form has a UI quirk where certain field interactions scroll the page back to
the top before the next click lands — take a screenshot before every click that follows
a dropdown/radio selection rather than blind-batching several in a row.
## Reading the results — the "Step 3 credits" trick
When someone changes jobs mid-year (or has widely different-paying jobs), each
employer's payroll withholds **as if its own salary were the only income for the full
year** — reapplying the 10/12/22/24% brackets that the *other* job's income already used
up. Depending on which job pays more, this can go either direction:
- Old job paid less, new job pays much more → new job's default withholding often
**over-withholds** relative to the true combined liability (it's stacking brackets
that are already spoken for).
- Old job significantly under-withheld (e.g., a bonus taxed at the flat 22%
supplemental rate when the true marginal rate is higher) → can go the other way.
The IRS estimator handles this correctly and will sometimes recommend a **Step 3
("Credits") entry that isn't a real dependent or tax credit** — it's the only field on
the W-4 that reduces withholding by a flat dollar amount beyond deductions (Step 4b).
If the recommendation table shows a large Step 3 number with no dependents/credits to
justify it, that's expected — it's the tool's way of correcting the bracket-double-count
described above. Don't second-guess it or "fix" it to zero; enter it as shown.
Conversely, Step 4(c) ("Extra withholding") is a flat *addition* per paycheck — used
when withholding is genuinely too low (e.g., investment income, self-employment income,
or a spouse's job not fully accounted for).
## After running it
1. Report the concrete field-by-field entries (Steps 1(c), 2(c), 3, 4a, 4b, 4c) for
each job, quoting the exact dollar amounts and which job they apply to.
2. Note which inputs were assumptions (pay frequency, SALT/property tax placeholder,
etc.) and what to re-verify once real data lands — flag this prominently, don't bury
it.
3. If the estimated shortfall/overpayment is large, mention the underpayment penalty
threshold (owing ≥$1,000 and paying <90% of current-year tax or <110% of prior-year
tax triggers a penalty) so the recommendation's urgency is clear.
4. At income levels where itemized deductions get large (big mortgage, high SALT even
under the new cap), consider AMT exposure rather than assuming it away — AMT
disallows the SALT deduction (mortgage interest on acquisition debt is still allowed).
Under OBBBA, the 2026 AMT exemption is $140,200 MFJ / $90,100 single, and it only
phases out (50 cents per dollar) once AMTI exceeds $1,000,000 MFJ / $500,000 single —
fully gone at $1,280,400 MFJ / $680,200 single. This is a much higher, more forgiving
phase-out threshold than the pre-2018 rules, so most households well under $1M AMTI
are fine even with a large SALT addback, as long as the SALT addback doesn't exceed
the exemption. Rough check: AMTI ≈ regular taxable income + SALT deducted; if
(AMTI − $140,200) taxed at 26%/28% is still less than the regular tax liability, no
AMT is owed. Don't compute this from memory beyond a rough sanity check — verify the
current year's exemption/phase-out numbers (they're inflation-indexed and law can
change them) and defer precision to a CPA or the IRS estimator's own handling.
5. If this is a recurring subject (ongoing job/income situation being tracked across
sessions), save the concrete figures and recommendation to project memory — not the
general methodology (that's this skill), just the person's specific numbers, dates,
and what's still unconfirmed.
## Key resources
- [IRS Tax Withholding Estimator](https://apps.irs.gov/app/tax-withholding-estimator) — the live tool, run it, don't hand-calculate
- [Form W-4 (current year, IRS.gov)](https://www.irs.gov/forms-pubs/about-form-w-4) — official form + instructions
- [IRS Publication 505 — Tax Withholding and Estimated Tax](https://www.irs.gov/publications/p505) — underpayment penalty rules, safe harbor thresholds
- [Topic no. 306, Penalty for underpayment of estimated tax](https://www.irs.gov/taxtopics/tc306) — the $1,000 / 90% / 110% safe-harbor rule
- Annual inflation-adjusted figures (standard deduction, SS wage base, tax brackets, AMT
exemption/phase-out) change every year — always pull the current year's numbers from
the estimator itself or IRS.gov, never reuse last year's figures from memory.
## What this skill does NOT do
- Doesn't replace a CPA for AMT exposure, NIIT, QBI, multi-state, or genuinely complex
situations — flag those, don't compute them by hand.
- Doesn't guess pay frequency, SALT amounts, or other job-specific facts — get them from
a real paystub/document or clearly label them as placeholders.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!