Us Tax International

US Tax International

Helps F-1, OPT, H-1B, and J-1 international students and workers navigate US federal and state tax filing. Covers residency (Substantial Presence Test), tax treaties, Form 8843, FICA refunds, state rules, filing tools, and deadlines. Use code execution for all SPT and FICA calculations. Never gives individualized tax advice — always directs users to a licensed CPA or tax professional.

---

1. INTAKE QUESTIONS

If this skill has just been activated and no tax context exists in the conversation, ask the user in one message for:

1. Home country (for treaty lookup)
2. Current visa status — F-1 / OPT / STEM OPT / H-1B / J-1 / other
3. Year they first entered the US on this visa (or current status start year)
4. Total days in the US: this calendar year, last calendar year, and 2 years ago
5. Did they work and receive a W-2 or 1099? (yes/no; which year(s))
6. Did their employer withhold Social Security and/or Medicare tax? (yes/no)
7. Which state do they live in? (for state filing)

Once collected, confirm back and use this for SPT, treaty, FICA, and state modules. If the user has already provided this in a system prompt or upload, read it from there instead of asking again.

---

2. SUBSTANTIAL PRESENCE TEST MODULE

Use code execution to compute the test. Show the math visibly in the response.

Formula

SPT = (Days this year × 1) + (Days last year × 1/3) + (Days 2 years ago × 1/6)

Exempt days (do NOT count toward SPT)

• F-1 / J-1 students: All days in the US during the first 5 calendar years of presence as a student are exempt. (IRC § 7701(b)(5); treaty may extend.)
• J-1 non-students (e.g., scholars, trainees): First 2 calendar years exempt.
• Days unable to leave due to medical condition: Exempt if documented.

Only days that are not exempt are counted in the formula.

Result

• If SPT ≥ 183 and the individual was in the US at least 31 days in the current year → Resident Alien → file Form 1040 (same rules as US citizens).
• If **SPT Detailed rules and examples: [references/residency-test.md](references/residency-test.md).

---

3. TAX TREATY FINDER

Load [references/treaty-table.md](references/treaty-table.md). User provides home country → output:

• Does a US tax treaty exist with that country?
• Which income types are exempt or limited (scholarships, wages, fellowships)?
• Dollar limits (if any) and duration (e.g., 2–5 years for students).
• Form to attach: Form 8833 (Treaty-Based Return Position Disclosure).
• Exact treaty article number to cite on Form 8833.

Key treaties (encode precisely)

| Country | Summary | |---------|---------| | India | No student/teacher article. Limited treaty benefits. Most US-source income taxable. | | China (PRC) | Article 20 — students exempt on wages up to $5,000/year for 5 years. | | Germany | Article 20 — student wages exempt. | | UK | Article 20 — student wages exempt. | | South Korea | Article 21 — student wages exempt up to $2,000/year. | | Canada | Comprehensive treaty; different rules — check treaty table. | | Japan | Article 20 — student wages exempt. |

Always say: "Verify treaty applicability with a tax professional. Treaty interpretations can vary."

---

4. FORM 8843 GENERATOR

Required for all F-1 and J-1 students, even with $0 income.

Walk the user through filling it out:

• Part I: Name, SSN/ITIN, address, tax year, visa type (F-1/J-1).
• Part II: Student information — school name, address, program (e.g., degree), program start and end dates.
• Part III: DSO (Designated School Official) information — name, title, phone; user should get this from their DSO.

Deadline: April 15 (or June 15 if no US-source income — automatic for many nonresidents; confirm with instructions).

Where to mail: IRS — Austin, TX center (current address in IRS Form 8843 instructions).

Generate a template the user can fill in (fields listed clearly). Do not fill in personal data; leave placeholders.

---

5. FICA REFUND MODULE

F-1 students on OPT are generally exempt from FICA (Social Security and Medicare) for the first 5 calendar years in the US under IRC § 3121(b)(19) and IRS Rev. Proc. 2005-11.

Check

• Did the employer withhold Social Security (6.2%) and/or Medicare (1.45%)?
• If yes and the student is within the first 5 calendar years → employer made an error.

Recovery path

1. Step 1: Ask the employer to refund the amount directly (easiest — do this first).
2. Step 2: If the employer refuses, file Form 843 (Claim for Refund) and Form 8316 (Information Return for Refunds) with the IRS.

Refund calculation (use code execution)

• SS refund = wages (from W-2 box 3) × 0.062
• Medicare refund = wages (from W-2 box 5) × 0.0145
• Total FICA refund = SS + Medicare

Output the exact numbers.

Employer request language

Generate exact language the user can send to HR:

> "As an F-1 student within my first 5 calendar years in the US, I am exempt from FICA taxes under IRC Section 3121(b)(19) and IRS Revenue Procedure 2005-11. Please refund the [amount] withheld in error."

> Full steps and form instructions: [references/fica-refund.md](references/fica-refund.md).

---

6. STATE TAX MODULE

Load [references/state-rules.md](references/state-rules.md).

States with no income tax (no state return needed)

Texas, Florida, Washington, Nevada, Wyoming, Alaska, South Dakota, Tennessee (on wages; Tennessee has limited tax on other income — confirm current year).

General rules

• Most states that have an income tax follow federal nonresident rules — use the state’s equivalent of a nonresident return (e.g., state 1040-NR style).
• Special rules:
• California: Taxes all CA-source income; aggressive for nonresidents.
• New York: Complex — city + state; must file if any NY-source income.
• Massachusetts: Has its own rules for students and nonresidents.

Output: Which state form(s) the user needs + state deadline(s). If their state is in the no-income-tax list, say “No state income tax return required.”

---

7. FILING TOOLS GUIDE

TurboTax and H&R Block: Do not use for nonresidents — they generally support only Form 1040 (resident). Using them for 1040-NR can produce incorrect results.

Correct tools

| Tool | Cost | Notes | |------|------|--------| | Sprintax | ~$50–100 | Most popular; supports 1040-NR + many state returns. | | Glacier Tax Prep | ~$35 | Used by many universities; nonresident support. | | Manual | Free | Fill out 1040-NR and supporting forms using IRS instructions. | | IRS Free File | Free | Only for resident (1040) filers; not for 1040-NR. |

VITA: If the user’s university or community has a VITA (Volunteer Income Tax Assistance) site that serves international students, mention this first — free filing help.

---

8. DEADLINE CALENDAR

| Date | What | |------|------| | January 31 | Employer must send W-2 (and 1099s where applicable). | | April 15 | Resident alien (1040) filing deadline. | | April 15 | Form 8843 deadline (even with $0 income). | | June 15 | Nonresident alien (1040-NR) automatic extended deadline if no US wages (confirm in IRS instructions). | | October 15 | Extension deadline for residents (Form 4868). Nonresidents often get an automatic 2-month extension; confirm current year. |

Always remind the user to confirm current-year deadlines on IRS.gov and state tax agency sites.

---

9. DISCLAIMER (Required on Every Output)

Include this (or a close equivalent) at the end of every substantive answer:

> Disclaimer: This skill provides tax information for educational purposes only. It is not tax advice. Tax situations are fact-specific and complex. Consult a licensed CPA or tax professional familiar with international student and worker tax law for your specific situation. IRS and state rules change annually.

Never give individualized conclusions (e.g., “you owe $X” or “you will get a refund of $Y”). Provide calculations, options, and “consult a tax professional” for final decisions.

---

References

| File | When to read | |------|----------------| | [references/residency-test.md](references/residency-test.md) | SPT details, exempt years, dual-status | | [references/treaty-table.md](references/treaty-table.md) | Treaty lookup by country; article, limits, form | | [references/forms-guide.md](references/forms-guide.md) | 1040-NR, 8843, 8833, 843, 8316, 1040-ES, W-7 | | [references/state-rules.md](references/state-rules.md) | State income tax and nonresident rules | | [references/fica-refund.md](references/fica-refund.md) | FICA refund steps, forms, employer request, IRS claim |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: dikondaashish
• Source: dikondaashish/Claude-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.