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.
| 1 | --- |
| 2 | name: us-tx-freelance-intake |
| 3 | description: ALWAYS USE THIS SKILL when a user asks for help preparing their US federal tax return AND mentions freelancing, self-employment, software development, contracting, sole proprietorship, or a single-member LLC in Texas. Trigger on phrases like "I'm a freelancer in Texas", "Texas self-employed taxes", "I have an LLC in TX", "Houston contractor tax return", "Austin freelance developer", or any similar phrasing where the user is a Texas-resident freelancer needing tax return preparation. This is the REQUIRED entry point for the Texas freelance developer tax workflow. Texas has no state income tax but has franchise tax and sales tax obligations. Uses upload-first workflow and ask_user_input_v0 for structured questions. Texas residents only. Sole proprietors and single-member LLCs disregarded for federal tax only. |
| 4 | version: 1.0 |
| 5 | jurisdiction: US-TX |
| 6 | category: orchestrator |
| 7 | --- |
| 8 | |
| 9 | # US-TX Freelance Developer Intake Skill v1.0 |
| 10 | |
| 11 | ## Section 1 — The opening |
| 12 | |
| 13 | When triggered, respond with ONE message that: |
| 14 | |
| 15 | 1. One-line greeting |
| 16 | 2. One-line summary of the flow (scope check → upload → gaps → handoff) |
| 17 | 3. One-line note: Texas has no income tax, so this focuses on federal + TX franchise tax + TX sales tax compliance |
| 18 | 4. One-line reviewer reminder |
| 19 | 5. Launch the refusal sweep immediately |
| 20 | |
| 21 | **Example first message:** |
| 22 | |
| 23 | > Let's get your 2025 federal return ready. Texas doesn't have a state income tax, so we'll focus on federal plus Texas franchise tax and sales tax compliance. Quick scope check, then documents, then gaps. Target: 10 minutes. |
| 24 | > |
| 25 | > Reminder: everything I produce needs signoff from a credentialed tax professional before filing. |
| 26 | > |
| 27 | > Scope check: |
| 28 | |
| 29 | Then immediately call `ask_user_input_v0`. |
| 30 | |
| 31 | --- |
| 32 | |
| 33 | ## Section 2 — Refusal sweep |
| 34 | |
| 35 | First batch: |
| 36 | |
| 37 | ``` |
| 38 | Q1: "Business structure?" |
| 39 | Options: ["Sole prop (no LLC)", "Single-member LLC", "Multi-member LLC", "S-corp", "C-corp", "Not sure"] |
| 40 | |
| 41 | Q2: "Revenue range for 2025?" |
| 42 | Options: ["Under $250K", "$250K–$1M", "$1M–$2.47M", "Over $2.47M"] |
| 43 | |
| 44 | Q3: "Filing status?" |
| 45 | Options: ["Single, no dependents", "Single with dependents (HoH)", "Married filing jointly", "Married filing separately", "Qualified surviving spouse"] |
| 46 | ``` |
| 47 | |
| 48 | **Evaluate:** |
| 49 | |
| 50 | - **Q1 = Sole prop or Single-member LLC** → continue |
| 51 | - **Q1 = Multi-member LLC** → stop. "Multi-member LLCs file Form 1065 as partnerships. Texas franchise tax for partnerships adds complexity. You need a CPA." |
| 52 | - **Q1 = S-corp or C-corp** → stop. "Corporate returns (1120-S, 1120) plus Texas franchise tax margin computation for entities require a CPA." |
| 53 | - **Q1 = Not sure** → follow-up: "Did you file Form 2553 or receive a W-2 from your own business?" |
| 54 | |
| 55 | - **Q2** → record for franchise tax analysis: |
| 56 | - Under $250K → almost certainly below no-tax-due threshold ($2.47M), minimal franchise tax concerns |
| 57 | - $250K–$1M → below threshold, no franchise tax but must still file Form 05-102 (No Tax Due Report) if the entity exists |
| 58 | - $1M–$2.47M → below threshold, still file Form 05-102 |
| 59 | - Over $2.47M → franchise tax applies, flag for detailed computation |
| 60 | |
| 61 | - **Q3** → record filing status |
| 62 | |
| 63 | **Second batch:** |
| 64 | |
| 65 | ``` |
| 66 | Q4: "Do you have a Texas sales tax permit?" |
| 67 | Options: ["Yes, active permit", "No permit", "Had one but closed it", "Not sure if I need one"] |
| 68 | |
| 69 | Q5: "Did you file a 2024 return normally?" |
| 70 | Options: ["Yes", "No (skipped year)", "Yes but amended / under audit"] |
| 71 | |
| 72 | Q6: "Any of these in 2025?" (multi-select) |
| 73 | Options: [ |
| 74 | "Rental property income", |
| 75 | "Active crypto/day trading", |
| 76 | "Foreign bank account over $10K", |
| 77 | "W-2 employees on payroll", |
| 78 | "Income from clients in other states where you traveled to perform work", |
| 79 | "None of the above" |
| 80 | ] |
| 81 | |
| 82 | Q7: "Federal estimated tax payments made in 2025?" |
| 83 | Options: ["Yes, all 4 quarters", "Yes, some quarters", "No", "Not sure"] |
| 84 | |
| 85 | Q8: "Texas franchise tax: does your total revenue exceed $2.47 million?" |
| 86 | Options: ["No, well under $2.47M", "Close to the threshold", "Yes, over $2.47M", "Not sure"] |
| 87 | ``` |
| 88 | |
| 89 | **Evaluate Q4:** |
| 90 | - Yes, active permit → flag for sales tax compliance review |
| 91 | - No permit → evaluate if one is needed (see Section 7 below) |
| 92 | - Had one but closed → confirm no outstanding returns |
| 93 | - Not sure → ask follow-up about whether taxpayer sells taxable goods/services |
| 94 | |
| 95 | **Evaluate Q5:** |
| 96 | - Yes → continue |
| 97 | - No or under audit → stop. Recommend CPA. |
| 98 | |
| 99 | **Evaluate Q6:** |
| 100 | - Any of first five selected → stop with appropriate refusal |
| 101 | - "None of the above" → continue |
| 102 | |
| 103 | **Evaluate Q7:** Record for federal estimated tax analysis. |
| 104 | |
| 105 | **Evaluate Q8:** |
| 106 | - No, well under → no franchise tax due, but may still need to file Form 05-102 |
| 107 | - Close to threshold → flag for careful revenue calculation |
| 108 | - Yes, over → franchise tax computation required, flag for detailed margin analysis |
| 109 | - Not sure → will determine from documents |
| 110 | |
| 111 | **Refusal for out-of-state income:** |
| 112 | > Stop — you performed work in other states. Even though Texas has no income tax, the other states may claim you owe income tax there (economic nexus for services). You need a CPA who handles multi-state filing obligations. |
| 113 | |
| 114 | --- |
| 115 | |
| 116 | ## Section 3 — The dump |
| 117 | |
| 118 | > Scope is good. Upload everything you have for 2025: |
| 119 | > |
| 120 | > - Business bank statement(s) for 2025 (CSV or PDF) |
| 121 | > - Tax forms received (1099-NEC, 1099-MISC, 1095-A/B/C) |
| 122 | > - Year-end retirement account statements |
| 123 | > - Federal estimated tax payment confirmations |
| 124 | > - Your 2024 federal tax return |
| 125 | > - Texas franchise tax correspondence or prior filings (Form 05-102 or 05-158/05-169) |
| 126 | > - Texas sales tax permits or returns (if applicable) |
| 127 | > - LLC Certificate of Formation (if applicable, filed with TX Secretary of State) |
| 128 | > - Texas Comptroller correspondence |
| 129 | > - Anything else tax-related |
| 130 | > |
| 131 | > Drop it all in — I'll sort it out. |
| 132 | |
| 133 | --- |
| 134 | |
| 135 | ## Section 4 — The inference pass |
| 136 | |
| 137 | Parse all documents and extract: |
| 138 | |
| 139 | **Bank statement:** |
| 140 | - Total deposits (gross receipts — critical for franchise tax threshold) |
| 141 | - Client payments with names |
| 142 | - IRS EFTPS payments (federal estimated tax) |
| 143 | - Retirement contributions |
| 144 | - Health insurance premiums |
| 145 | - Business expenses |
| 146 | - Contractor payments |
| 147 | - Texas Comptroller payments (franchise tax, sales tax) |
| 148 | - Texas Secretary of State fees ($300 LLC formation / $0 annual) |
| 149 | |
| 150 | **1099-NEC received:** |
| 151 | - Payer name, TIN, Box 1 amount |
| 152 | - Cross-check against deposits |
| 153 | |
| 154 | **Prior year federal return:** |
| 155 | - Federal total tax (1040 Line 24) |
| 156 | - Federal AGI (1040 Line 11) |
| 157 | |
| 158 | **Texas franchise tax prior filings:** |
| 159 | - Prior year filing type (No Tax Due, EZ Computation, Long Form) |
| 160 | - Prior year total revenue reported |
| 161 | - Entity type on file with Comptroller |
| 162 | |
| 163 | **Retirement account statement:** |
| 164 | - Plan type, contributions, dates |
| 165 | |
| 166 | --- |
| 167 | |
| 168 | ## Section 5 — The confirmation |
| 169 | |
| 170 | Present compact summary: |
| 171 | |
| 172 | > **Identity** |
| 173 | > - [Name], [filing status], [dependents] |
| 174 | > - Texas resident |
| 175 | > - [Business structure] |
| 176 | > |
| 177 | > **Income** |
| 178 | > - Gross receipts: $X |
| 179 | > - [Client breakdown] |
| 180 | > |
| 181 | > **Expenses** |
| 182 | > - [Category breakdown] |
| 183 | > |
| 184 | > **Texas-specific** |
| 185 | > - Total revenue for franchise tax: $X |
| 186 | > - Franchise tax threshold ($2.47M): [above/below] |
| 187 | > - Franchise tax filing obligation: [No Tax Due report / actual tax due] |
| 188 | > - Sales tax permit: [active/none/needed] |
| 189 | > - Sales tax collected: $X (if applicable) |
| 190 | > |
| 191 | > **Federal estimated taxes paid:** $X |
| 192 | > |
| 193 | > **Flags:** |
| 194 | > - [Any issues] |
| 195 | > |
| 196 | > **Is any of this wrong?** |
| 197 | |
| 198 | --- |
| 199 | |
| 200 | ## Section 6 — Gap filling |
| 201 | |
| 202 | Things that usually need asking: |
| 203 | |
| 204 | 1. **Home office** — exclusive use test, square footage |
| 205 | 2. **Sales tax nexus** — does the taxpayer sell taxable tangible personal property or taxable services in Texas? (most software consulting is NOT taxable for TX sales tax, but custom software vs. canned software distinction matters) |
| 206 | 3. **Franchise tax entity information** — confirm SOS file number, entity formation date, accounting period end date |
| 207 | 4. **Health insurance source** — marketplace (no state exchange in TX, uses healthcare.gov) vs employer vs COBRA vs health sharing ministry |
| 208 | 5. **Vehicle use** — if any business mileage |
| 209 | |
| 210 | --- |
| 211 | |
| 212 | ## Section 7 — Texas-specific tax framework |
| 213 | |
| 214 | ### Texas has no state income tax |
| 215 | |
| 216 | Article VIII, §24-a of the Texas Constitution prohibits a state personal income tax unless approved by voters in a statewide referendum. There is no state income tax return to file. |
| 217 | |
| 218 | ### Texas franchise tax (margin tax) |
| 219 | |
| 220 | **What it is:** A tax on entities (including LLCs and sole proprietorships with an LLC filing) doing business in Texas. Reported to the Texas Comptroller. |
| 221 | |
| 222 | **Who must file:** |
| 223 | - All taxable entities formed in Texas or doing business in Texas |
| 224 | - Includes LLCs, corporations, partnerships, LLPs |
| 225 | - Sole proprietors without an LLC are NOT subject to franchise tax |
| 226 | - Single-member LLCs ARE subject to franchise tax (even though disregarded for federal purposes) |
| 227 | |
| 228 | **No-tax-due threshold (2025):** $2,470,000 in annualized total revenue |
| 229 | - If total revenue is at or below this threshold: file Form 05-102 (Public Information Report / No Tax Due Report) — no tax owed |
| 230 | - If total revenue exceeds threshold: compute franchise tax |
| 231 | |
| 232 | **Tax rates (if above threshold):** |
| 233 | - 0.375%: Retail and wholesale businesses |
| 234 | - 0.75%: All other businesses (including tech consulting/software development) |
| 235 | |
| 236 | **Margin computation (if tax due):** |
| 237 | - Total revenue (gross receipts from TX operations) |
| 238 | - Subtract the greatest of: |
| 239 | - Cost of goods sold (COGS) |
| 240 | - Compensation (W-2 wages + benefits) |
| 241 | - 30% of total revenue (simplified method) |
| 242 | - $1 million (standard deduction equivalent) |
| 243 | - The result is "taxable margin" |
| 244 | - Tax = taxable margin × applicable rate |
| 245 | |
| 246 | **EZ Computation (Form 05-169):** |
| 247 | - Available if total revenue ≤ $20 million |
| 248 | - Rate: 0.331% of apportioned total revenue (no margin deductions) |
| 249 | - Simpler calculation, may result in higher or lower tax |
| 250 | |
| 251 | **Filing deadlines:** |
| 252 | - Annual report due May 15 (for accounting year ending December 31) |
| 253 | - Extension available to November 15 |
| 254 | - Public Information Report (PIR) filed with the franchise tax return |
| 255 | |
| 256 | **For most freelance developers with SMLLCs under $2.47M revenue:** |
| 257 | - File Form 05-102 (No Tax Due) + Public Information Report by May 15 |
| 258 | - No tax payment required |
| 259 | - Failure to file can result in forfeiture of LLC status by Texas Secretary of State |
| 260 | |
| 261 | ### Texas sales tax |
| 262 | |
| 263 | **State rate:** 6.25% |
| 264 | **Local additions:** Up to 2% (total max 8.25%) |
| 265 | |
| 266 | **Applicability to software/tech services:** |
| 267 | - Custom software (written for a single customer): NOT taxable in Texas |
| 268 | - Canned (prewritten) software delivered electronically: Taxable |
| 269 | - SaaS: Texas Comptroller Rule 3.330 — generally taxable as "data processing services" (20% of value taxable after statutory exemption) |
| 270 | - IT consulting/programming services (labor to create custom code): NOT taxable |
| 271 | - Hardware repair or maintenance contracts: Taxable |
| 272 | |
| 273 | **For most freelance software developers:** |
| 274 | - If providing custom development services to clients: NO sales tax obligation |
| 275 | - If selling a prewritten software product or SaaS: sales tax permit required, must collect and remit |
| 276 | |
| 277 | **Sales tax permit:** |
| 278 | - Free to obtain from Texas Comptroller |
| 279 | - If permit is active, returns must be filed even if no tax collected ($0 returns) |
| 280 | - Filing frequency: monthly, quarterly, or annually (Comptroller assigns based on volume) |
| 281 | - If no taxable sales: consider closing permit to avoid filing obligation |
| 282 | |
| 283 | ### Texas does NOT have: |
| 284 | - State income tax |
| 285 | - City/county income tax |
| 286 | - Gross receipts tax (other than franchise tax) |
| 287 | - Estate tax (no state-level estate tax) |
| 288 | - Inheritance tax |
| 289 | |
| 290 | --- |
| 291 | |
| 292 | ## Section 8 — Handoff |
| 293 | |
| 294 | > Intake complete. Handing off to the return assembly workflow. |
| 295 | > |
| 296 | > You'll receive: |
| 297 | > 1. Excel working paper (federal return lines + TX franchise tax computation) |
| 298 | > 2. Reviewer brief with positions, citations, and flags |
| 299 | > 3. Federal form package (1040 + supporting schedules) |
| 300 | > 4. TX franchise tax filing checklist (Form 05-102 or 05-158/05-169) |
| 301 | > 5. TX sales tax compliance summary (if applicable) |
| 302 | > 6. 2026 federal estimated tax vouchers |
| 303 | > 7. Action items with deadlines |
| 304 | > |
| 305 | > Starting now. |
| 306 | |
| 307 | --- |
| 308 | |
| 309 | ## Section 9 — Refusal handling |
| 310 | |
| 311 | **Sample refusals:** |
| 312 | |
| 313 | > Stop — your LLC revenue is above $2.47M. Texas franchise tax at this level requires detailed margin computation with COGS vs compensation analysis, apportionment calculations, and potentially the EZ Computation comparison. You need a CPA or franchise tax specialist. |
| 314 | |
| 315 | > Stop — you sell prewritten software products to customers. Texas sales tax compliance for software products requires analysis of delivery method, bundling, and local jurisdiction rates. You need a CPA familiar with Texas sales tax for technology companies. |
| 316 | |
| 317 | > Stop — you have income from work performed in California and New York while traveling. Those states will likely assert income tax nexus. You need a multi-state CPA even though Texas has no income tax. |
| 318 | |
| 319 | --- |
| 320 | |
| 321 | ## Section 10 — Self-checks |
| 322 | |
| 323 | **Check TX-IN1 — Refusal sweep used ask_user_input_v0.** |
| 324 | **Check TX-IN2 — Revenue range captured for franchise tax threshold analysis.** |
| 325 | **Check TX-IN3 — Sole prop vs SMLLC distinction made (sole prop without LLC = no franchise tax filing).** |
| 326 | **Check TX-IN4 — Sales tax applicability evaluated (custom software vs SaaS vs products).** |
| 327 | **Check TX-IN5 — Upload-first flow honored.** |
| 328 | **Check TX-IN6 — Documents parsed before gap-filling.** |
| 329 | **Check TX-IN7 — Federal estimated tax payments tracked (no state estimated tax in TX).** |
| 330 | **Check TX-IN8 — Franchise tax filing deadline (May 15) noted in action items.** |
| 331 | **Check TX-IN9 — Handoff to us-tx-return-assembly is explicit.** |
| 332 | |
| 333 | --- |
| 334 | |
| 335 | ## End of Skill |
| 336 | |
| 337 | --- |
| 338 | |
| 339 | ## Disclaimer |
| 340 | |
| 341 | 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. |
| 342 | |
| 343 | 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. |
| 344 |
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
About
ALWAYS USE THIS SKILL when a user asks for help preparing their US federal tax return AND mentions freelancing, self-employment, software development, contracting, sole proprietorship, or a single-member LLC in Texas. Trigger on phrases like "I'm a freelancer in Texas", "Texas self-employed taxes", "I have an LLC in TX", "Houston contractor tax return", "Austin freelance developer", or any similar phrasing where the user is a Texas-resident freelancer needing tax return preparation. This is the REQUIRED entry point for the Texas freelance developer tax workflow. Texas has no state income tax but has franchise tax and sales tax obligations. Uses upload-first workflow and ask_user_input_v0 for structured questions. Texas residents only. Sole proprietors and single-member LLCs disregarded for federal tax only.
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.