Use this skill with your AI agent
Paste this skill into your AI agent's context, or save the file to your project. Works with any AI agent that reads markdown.
us-ny-return-assembly.md339 lines15.0 KB
v10New York
Not yet verified by an accountantContact accountant
| 1 | --- |
| 2 | name: us-ny-return-assembly |
| 3 | description: Final orchestrator skill that assembles the complete federal and New York State filing package for New York resident sole proprietors and single-member LLCs disregarded for federal tax. Consumes outputs from all federal content skills (bookkeeping, Schedule C/SE, QBI, retirement, SE health insurance, quarterly estimated tax, federal assembly, 1099-NEC) and all New York content skills (IT-201 individual return, NYC UBT Form NYC-202 where applicable, NY estimated tax IT-2105, MCTMT) to produce a single unified reviewer package. Handles reconciliation between federal AGI and NY AGI adjustments, NY itemized vs standard deduction election, NYC income tax surcharge, NYC UBT credit against personal income tax, and MCTMT computation. New York full-year residents only. |
| 4 | version: 1.0 |
| 5 | jurisdiction: US-NY |
| 6 | category: orchestrator |
| 7 | --- |
| 8 | |
| 9 | # US+NY Return Assembly Skill v1.0 |
| 10 | |
| 11 | ## CRITICAL EXECUTION DIRECTIVE — READ FIRST |
| 12 | |
| 13 | **When this skill is invoked, you have already passed through intake. The user has consented to the full workflow. Execute all steps without pausing for permission.** |
| 14 | |
| 15 | - Do NOT ask "how deep do you want me to go" or "do you want the full package." Produce it. |
| 16 | - Do NOT announce token counts or tool calls. |
| 17 | - Do NOT ask which deliverables to prioritize. Produce all deliverables listed in Section 6. |
| 18 | - Do NOT re-validate scope that intake already validated. |
| 19 | - Do NOT pause between content skills to check in. |
| 20 | - Self-checks are targets, not blockers. If one fails, flag it for reviewer and continue. |
| 21 | - If you feel the urge to ask "how should I proceed," pick the most defensible path and flag the decision in the reviewer brief. |
| 22 | |
| 23 | --- |
| 24 | |
| 25 | ## Section 1 — Scope |
| 26 | |
| 27 | Produces the complete federal + New York filing package for: |
| 28 | - Full-year New York State residents (including NYC residents) |
| 29 | - Sole proprietors or single-member LLCs disregarded for federal tax |
| 30 | - Tax year 2025 |
| 31 | - Filing Form 1040 (federal), IT-201 (NY State), NYC-202 (NYC UBT, if applicable) |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ## Section 2 — Execution order |
| 36 | |
| 37 | 1. `us-sole-prop-bookkeeping` |
| 38 | 2. `us-schedule-c-and-se-computation` |
| 39 | 3. `us-self-employed-retirement` |
| 40 | 4. `us-self-employed-health-insurance` |
| 41 | 5. `us-qbi-deduction` |
| 42 | 6. `us-federal-return-assembly` |
| 43 | 7. `us-quarterly-estimated-tax` (needs federal total tax) |
| 44 | 8. `us-1099-nec-issuance` (parallel, needs bookkeeping only) |
| 45 | 9. `ny-it-201-individual-return` (needs federal assembly) |
| 46 | 10. `nyc-ubt-form-202` (if NYC resident with business income; parallel with IT-201) |
| 47 | 11. `ny-estimated-tax-it-2105` (needs NY total tax) |
| 48 | 12. `ny-mctmt` (if MCTD area; parallel) |
| 49 | 13. **THIS SKILL** — final assembly and verification |
| 50 | |
| 51 | --- |
| 52 | |
| 53 | ## Section 3 — Verification matrix |
| 54 | |
| 55 | ### Federal internal consistency |
| 56 | |
| 57 | - Schedule C net profit → Schedule 1 Line 3 → Form 1040 Line 8 |
| 58 | - Schedule SE tax → Schedule 2 Line 4 → Form 1040 Line 23 |
| 59 | - Half of SE tax → Schedule 1 Line 15 → Form 1040 Line 10 |
| 60 | - SE retirement → Schedule 1 Line 16 → Form 1040 Line 10 |
| 61 | - SE health insurance → Schedule 1 Line 17 → Form 1040 Line 10 |
| 62 | - QBI deduction → Form 1040 Line 13 |
| 63 | - Total tax → Form 1040 Line 24 |
| 64 | - Form 2210 penalty (if applicable) |
| 65 | - Total payments → Form 1040 Line 33 |
| 66 | |
| 67 | ### New York internal consistency |
| 68 | |
| 69 | - Federal AGI → IT-201 Line 19 (starting point) |
| 70 | - NY additions (IT-201 Lines 20-23): interest income on non-NY state/local bonds, QBI deduction add-back (NY does not allow QBI deduction) |
| 71 | - NY subtractions (IT-201 Lines 24-32): interest on US government obligations, NY state/local pension exclusion |
| 72 | - NY AGI → IT-201 Line 33 |
| 73 | - NY standard deduction ($8,000 single / $16,050 MFJ) vs NY itemized deduction (IT-201 Line 34-35) |
| 74 | - NY itemized deduction limitations (for high-income taxpayers: 50% limitation on charitable contributions and other adjustments if NY AGI > $525,000) |
| 75 | - NY taxable income → IT-201 Line 38 |
| 76 | - NY tax → IT-201 Line 39 (from tax computation worksheet or tax table) |
| 77 | - NYC resident tax → IT-201 Lines 47-51 (if NYC resident) |
| 78 | - NYC UBT credit → IT-201 Line 51 (partial credit against NYC personal income tax) |
| 79 | - NY household credit → IT-201 Line 40 (if income below threshold) |
| 80 | - Total NY tax → IT-201 Line 62 |
| 81 | - NY estimated tax payments → IT-201 Line 67 |
| 82 | - NY refund or balance due → IT-201 Line 78 or 80 |
| 83 | |
| 84 | ### NYC UBT consistency (if applicable) |
| 85 | |
| 86 | - Gross income from NYC business → Form NYC-202 Line 1 |
| 87 | - NYC UBT deductions → Form NYC-202 Lines 2-12 |
| 88 | - NYC UBT taxable income → Form NYC-202 Line 13 |
| 89 | - Exemption calculation ($95,000, phaseout $95K-$150K) → Form NYC-202 Line 14-16 |
| 90 | - NYC UBT (4% rate) → Form NYC-202 Line 17 |
| 91 | - UBT credits available → NYC-202 Line 18+ |
| 92 | - UBT estimated payments → NYC-202 Schedule F |
| 93 | - UBT balance due or refund |
| 94 | |
| 95 | ### Federal-NY coordination |
| 96 | |
| 97 | - Federal AGI used correctly as NY starting point |
| 98 | - QBI deduction properly added back for NY (NY does not conform to §199A) |
| 99 | - Filing status consistent |
| 100 | - Dependents consistent |
| 101 | - NY itemized deductions use federal Schedule A as starting point but apply NY modifications: |
| 102 | - State/local tax deduction: included for NY purposes (no $10,000 SALT cap at state level) |
| 103 | - College tuition deduction (IT-201 Line 30): up to $10,000 per student |
| 104 | - Depreciation: NY generally conforms to federal MACRS but has modifications for bonus depreciation (NY decoupled from 100% bonus; add-back required, then NY allows its own depreciation deduction) |
| 105 | |
| 106 | ### MCTMT verification |
| 107 | |
| 108 | - Net self-employment earnings allocated to MCTD |
| 109 | - Threshold: $50,000 (only taxed if net SE earnings in MCTD exceed $50,000) |
| 110 | - Rate: 0.34% |
| 111 | - MCTMT amount → Form MTA-6 |
| 112 | |
| 113 | ### Estimated tax reconciliation |
| 114 | |
| 115 | - Federal: 4 quarterly payments cross-checked against safe harbor (100% prior year tax if AGI ≤ $150K, 110% if AGI > $150K) |
| 116 | - NY State: payments on IT-2105 cross-checked against NY safe harbor (100% prior year NY tax or 90% current year) |
| 117 | - NYC UBT: quarterly payments if UBT > $3,400 |
| 118 | - Form IT-2105.9 (NY underpayment penalty) if applicable |
| 119 | |
| 120 | --- |
| 121 | |
| 122 | ## Section 4 — NY-specific adjustments detail |
| 123 | |
| 124 | ### Additions to federal AGI (common for freelancers) |
| 125 | |
| 126 | 1. **QBI deduction add-back**: NY does not allow the §199A deduction. Full federal QBI deduction amount added back on IT-225 Line 1 (code A-201) |
| 127 | 2. **Bonus depreciation add-back**: If federal return claimed bonus depreciation, NY requires add-back of the federal bonus amount, then allows NY depreciation (generally MACRS without bonus). IT-225 code A-110. |
| 128 | 3. **Other states' municipal bond interest**: Interest from non-NY state/local bonds is added to NY income |
| 129 | |
| 130 | ### Subtractions from federal AGI (common for freelancers) |
| 131 | |
| 132 | 1. **US government obligation interest**: Interest on US Treasury securities subtracted from NY income (IT-225 code S-103) |
| 133 | 2. **College tuition**: Up to $10,000 per eligible student (IT-225 code S-106) |
| 134 | 3. **NY depreciation**: Replacement depreciation deduction for assets where bonus depreciation was added back (IT-225 code S-110) |
| 135 | |
| 136 | ### NYC UBT credit mechanism |
| 137 | |
| 138 | The taxpayer cannot deduct NYC UBT as a business expense on the federal Schedule C (it is a tax, not a deductible business expense). However: |
| 139 | - NYC UBT paid generates a partial credit against NYC personal income tax (IT-201 Line 51) |
| 140 | - The credit equals the lesser of: (a) the UBT tax, or (b) the NYC personal income tax before the credit |
| 141 | - Effectively prevents double-taxation of NYC business income at both UBT and personal income tax levels, but the credit is not always dollar-for-dollar |
| 142 | |
| 143 | --- |
| 144 | |
| 145 | ## Section 5 — Refusals |
| 146 | |
| 147 | **R-NY-1 — Upstream skill did not run.** Name the specific skill and refuse until it executes. |
| 148 | |
| 149 | **R-NY-2 — Multi-state allocation required.** If income sourced to states other than NY was not identified at intake and appears in documents, refuse. Multi-state allocation requires IT-203/credit for taxes paid analysis. |
| 150 | |
| 151 | **R-NY-3 — NYC UBT allocation dispute.** If the taxpayer performed significant business activity outside NYC but is a NYC resident, allocation percentage is complex. Flag for reviewer if allocation is not clearly 100%. |
| 152 | |
| 153 | **R-NY-4 — Partnership/S-corp income discovered.** K-1 income appearing in documents that was not disclosed at intake. Refuse and recommend CPA. |
| 154 | |
| 155 | **R-NY-5 — NY PTET (Pass-Through Entity Tax) election.** If the SMLLC elected into NY PTET, different treatment applies. Refuse unless PTET skill is available. |
| 156 | |
| 157 | --- |
| 158 | |
| 159 | ## Section 6 — Final reviewer package contents |
| 160 | |
| 161 | ### Documents |
| 162 | |
| 163 | 1. **Executive summary** — filing status, income, federal tax, NY tax, NYC tax, NYC UBT, MCTMT, total liability, refund/balance due |
| 164 | 2. **Federal Form 1040 worksheet** — line-by-line |
| 165 | 3. **Schedule C** — sole prop P&L |
| 166 | 4. **Schedule SE** — SE tax |
| 167 | 5. **Schedule 1, 2, 3** — adjustments, additional taxes, credits |
| 168 | 6. **Form 8995 or 8995-A** — QBI |
| 169 | 7. **Form 2210** — federal underpayment penalty (if applicable) |
| 170 | 8. **Form 1040-ES** — 2026 federal estimated tax schedule |
| 171 | 9. **NY IT-201 worksheet** — line-by-line state return |
| 172 | 10. **IT-225** — NY addition and subtraction modifications |
| 173 | 11. **NYC-202 worksheet** — UBT computation (if NYC resident) |
| 174 | 12. **IT-2105** — 2026 NY estimated tax schedule |
| 175 | 13. **IT-2105.9** — NY underpayment penalty (if applicable) |
| 176 | 14. **Form MTA-6** — MCTMT (if applicable) |
| 177 | 15. **1099-NEC batch** — contractor information returns (if applicable) |
| 178 | 16. **Reviewer brief** — comprehensive narrative |
| 179 | 17. **Taxpayer action list** — deadlines, amounts, payment methods |
| 180 | |
| 181 | ### Reviewer brief structure |
| 182 | |
| 183 | ```markdown |
| 184 | # Complete Return Package: [Taxpayer Name] — Tax Year 2025 |
| 185 | |
| 186 | ## Executive Summary |
| 187 | - Filing status: [X] |
| 188 | - Residence: New York ([NYC / rest of state]) |
| 189 | - Business: Sole proprietor / SMLLC disregarded |
| 190 | - Federal total tax: $X |
| 191 | - NY State tax: $X |
| 192 | - NYC personal income tax: $X |
| 193 | - NYC UBT: $X |
| 194 | - MCTMT: $X |
| 195 | - Total 2025 tax liability: $X |
| 196 | - Total payments (federal + NY + NYC): $X |
| 197 | - Net refund or balance due: $X |
| 198 | |
| 199 | ## Federal Return |
| 200 | [Federal assembly content] |
| 201 | |
| 202 | ## New York State Return (IT-201) |
| 203 | - Federal AGI: $X |
| 204 | - NY additions: $X (QBI add-back $X, bonus depreciation $X, other $X) |
| 205 | - NY subtractions: $X |
| 206 | - NY AGI: $X |
| 207 | - NY deduction (standard/itemized): $X |
| 208 | - NY taxable income: $X |
| 209 | - NY tax (from table/worksheet): $X |
| 210 | - NYC personal income tax: $X |
| 211 | - NYC UBT credit applied: $X |
| 212 | - NY household credit: $X (if applicable) |
| 213 | - Net NY/NYC tax: $X |
| 214 | - NY estimated payments applied: $X |
| 215 | - NY balance due or refund: $X |
| 216 | |
| 217 | ## NYC Unincorporated Business Tax (if applicable) |
| 218 | - Gross business income in NYC: $X |
| 219 | - Allocable deductions: $X |
| 220 | - NYC UBT taxable income: $X |
| 221 | - Exemption applied: $X |
| 222 | - UBT at 4%: $X |
| 223 | - UBT credits: $X |
| 224 | - Net UBT: $X |
| 225 | - UBT estimated payments: $X |
| 226 | - UBT balance due or refund: $X |
| 227 | |
| 228 | ## MCTMT (if applicable) |
| 229 | - Net SE earnings in MCTD: $X |
| 230 | - MCTMT (0.34%): $X |
| 231 | |
| 232 | ## Cross-jurisdiction reconciliation |
| 233 | - Federal AGI matches IT-201 starting point: [verified] |
| 234 | - QBI add-back computed correctly: [verified] |
| 235 | - NYC UBT credit does not exceed NYC personal income tax: [verified] |
| 236 | - All estimated payments allocated correctly: [verified] |
| 237 | |
| 238 | ## Reviewer attention flags |
| 239 | [Aggregated flags] |
| 240 | |
| 241 | ## Positions taken |
| 242 | [With citations to IRC, NY Tax Law, NYC Admin Code] |
| 243 | |
| 244 | ## Planning notes for 2026 |
| 245 | - NY PTET election consideration (if beneficial) |
| 246 | - NYC UBT estimated tax adjustment |
| 247 | - Federal/NY/NYC estimated tax coordination |
| 248 | - S-corp election analysis (potential NYC UBT savings) |
| 249 | ``` |
| 250 | |
| 251 | --- |
| 252 | |
| 253 | ## Section 7 — Taxpayer action list structure |
| 254 | |
| 255 | ```markdown |
| 256 | ## Taxpayer Action List |
| 257 | |
| 258 | ### Before April 15, 2026: |
| 259 | 1. Review and sign return package |
| 260 | 2. Pay federal balance due: $X via EFTPS / IRS Direct Pay |
| 261 | 3. Pay NY balance due: $X via NY DTF Online Services |
| 262 | 4. Pay NYC UBT balance due: $X via NYC DOF eFiling (if applicable) |
| 263 | 5. Pay 2026 Q1 federal estimated tax: $X |
| 264 | 6. Pay 2026 Q1 NY estimated tax: $X (25% of annual estimate) |
| 265 | 7. Pay 2026 Q1 NYC UBT estimated tax: $X (if applicable) |
| 266 | 8. File MCTMT annual return (if applicable) |
| 267 | |
| 268 | ### Before June 16, 2026: |
| 269 | 1. Pay 2026 Q2 federal estimated tax: $X |
| 270 | 2. Pay 2026 Q2 NY estimated tax: $X (25% of annual estimate) |
| 271 | 3. Pay 2026 Q2 NYC UBT estimated tax: $X (if applicable) |
| 272 | |
| 273 | ### Before September 15, 2026: |
| 274 | 1. Pay 2026 Q3 federal estimated tax: $X |
| 275 | 2. Pay 2026 Q3 NY estimated tax: $X (25% of annual estimate) |
| 276 | 3. Pay 2026 Q3 NYC UBT estimated tax: $X (if applicable) |
| 277 | |
| 278 | ### Before January 15, 2027: |
| 279 | 1. Pay 2026 Q4 federal estimated tax: $X |
| 280 | 2. Pay 2026 Q4 NY estimated tax: $X (25% of annual estimate) |
| 281 | 3. Pay 2026 Q4 NYC UBT estimated tax: $X (if applicable) |
| 282 | |
| 283 | ### Ongoing: |
| 284 | 1. Collect W-9 from new contractors before payment |
| 285 | 2. Track business expenses with receipts |
| 286 | 3. Monitor income for UBT exemption phaseout |
| 287 | 4. Consider S-corp election if net SE income exceeds $150K+ (reduces SE tax and eliminates UBT) |
| 288 | ``` |
| 289 | |
| 290 | --- |
| 291 | |
| 292 | ## Section 8 — Self-checks |
| 293 | |
| 294 | **Check NY-A1 — All upstream skills executed.** |
| 295 | **Check NY-A2 — Federal AGI correctly flows to IT-201 Line 19.** |
| 296 | **Check NY-A3 — QBI deduction added back on IT-225 (NY does not allow §199A).** |
| 297 | **Check NY-A4 — NYC UBT computed if NYC resident with business income.** |
| 298 | **Check NY-A5 — NYC UBT credit does not exceed NYC personal income tax.** |
| 299 | **Check NY-A6 — MCTMT computed for MCTD-area self-employed with earnings > $50K.** |
| 300 | **Check NY-A7 — NY estimated tax underpayment penalty evaluated (IT-2105.9).** |
| 301 | **Check NY-A8 — Bonus depreciation add-back and replacement NY depreciation computed.** |
| 302 | **Check NY-A9 — NY standard vs itemized deduction: correct election made (NY allows different election than federal).** |
| 303 | **Check NY-A10 — Payment instructions include all four jurisdictions where applicable (federal, NY, NYC personal, NYC UBT).** |
| 304 | |
| 305 | --- |
| 306 | |
| 307 | ## Section 9 — Output files |
| 308 | |
| 309 | Three files: |
| 310 | |
| 311 | 1. **`[taxpayer_slug]_2025_master.xlsx`** — Sheets: Cover, Income, Schedule C, Schedule SE, Retirement, SE Health, QBI, Schedule 1, Form 1040, Form 2210, IT-201, IT-225, NYC-202, IT-2105.9, MTA-6, 1099-NEC batch, 2026 Est Tax (Fed+NY+NYC). |
| 312 | |
| 313 | 2. **`reviewer_brief.md`** — Full narrative covering federal, NY State, NYC, MCTMT, cross-jurisdiction reconciliation, flags, citations, planning. |
| 314 | |
| 315 | 3. **`taxpayer_action_list.md`** — Step-by-step with dates, amounts, and payment URLs (EFTPS, NY DTF, NYC DOF). |
| 316 | |
| 317 | --- |
| 318 | |
| 319 | ## Section 10 — Known gaps |
| 320 | |
| 321 | 1. NY PTET election analysis not automated (requires entity-level election before filing deadline) |
| 322 | 2. NYC UBT allocation for taxpayers performing work both inside and outside NYC is complex and may require reviewer judgment |
| 323 | 3. NY bonus depreciation add-back computation requires detailed asset-by-asset tracking |
| 324 | 4. Form IT-2658 (group estimated tax for partnerships) not applicable but flagged to avoid confusion |
| 325 | 5. NYC-210 (Claim for NYC School Tax Credit) automatically claimed on IT-201 if eligible — verify $125 (single) or $250 (MFJ) credit |
| 326 | 6. NY Earned Income Credit (30% of federal EIC) — verify if applicable |
| 327 | |
| 328 | --- |
| 329 | |
| 330 | ## End of Skill |
| 331 | |
| 332 | --- |
| 333 | |
| 334 | ## Disclaimer |
| 335 | |
| 336 | This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a CPA, EA, tax attorney, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon. |
| 337 | |
| 338 | The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes. |
| 339 |
Run this skill, then get an accountant to check it
After running the full skill pack in your AI agent, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.
Verification status
Research-verified
Drafted from authoritative sources (tax authority sites, Big-4 summaries). Awaiting credentialed sign-off.
Needs section-by-section practitioner review to reach accountant-verified.
Section review progress
0/36
About
Final orchestrator skill that assembles the complete federal and New York State filing package for New York resident sole proprietors and single-member LLCs disregarded for federal tax. Consumes outputs from all federal content skills (bookkeeping, Schedule C/SE, QBI, retirement, SE health insurance, quarterly estimated tax, federal assembly, 1099-NEC) and all New York content skills (IT-201 individual return, NYC UBT Form NYC-202 where applicable, NY estimated tax IT-2105, MCTMT) to produce a single unified reviewer package. Handles reconciliation between federal AGI and NY AGI adjustments, NY itemized vs standard deduction election, NYC income tax surcharge, NYC UBT credit against personal income tax, and MCTMT computation. New York full-year residents only.
US-NYty-2025
Use this skill
This skill is open source and free to use in any AI agent. Copy it, download it, or clone the repo. If you find an error, report an issue — a licensed accountant will review.