au-freelance-intake.md620 lines25.6 KB
v1Orchestrator
| 1 | --- |
| 2 | name: au-freelance-intake |
| 3 | description: ALWAYS USE THIS SKILL when a user asks for help preparing their Australian tax returns AND mentions freelancing, self-employment, contracting, sole trading, or ABN-based work. Trigger on phrases like "help me do my taxes", "prepare my ITR", "I'm a sole trader in Australia", "I'm a freelancer in Australia", "do my taxes as a contractor", "prepare my BAS and income tax", or any similar phrasing where the user is an Australian-resident self-employed individual needing tax return preparation. This is the REQUIRED entry point for the Australian self-employed tax workflow -- every other skill in the stack (australia-gst, au-individual-return, au-super-guarantee, au-medicare-levy, au-payg-instalments, au-return-assembly) depends on this skill running first to produce a structured intake package. Uses upload-first workflow -- the user dumps all their documents and the skill infers as much as possible before asking questions. Uses ask_user_input_v0 for structured questions instead of one-at-a-time prose. Built for speed. Australian full-year residents only; sole traders only. |
| 4 | version: 0.1 |
| 5 | --- |
| 6 | |
| 7 | # Australia Sole Trader Intake Skill v0.1 |
| 8 | |
| 9 | ## What this file is |
| 10 | |
| 11 | The intake orchestrator for Australian-resident sole traders. Every downstream Australian content skill (australia-gst, au-individual-return, au-super-guarantee, au-medicare-levy, au-payg-instalments) and the assembly orchestrator (au-return-assembly) depend on this skill running first to produce a structured intake package. |
| 12 | |
| 13 | This skill does not compute any tax figures. Its job is to collect all the facts, parse all the documents, confirm everything with the user, and hand off a clean intake package to `au-return-assembly`. |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | ## Design principles |
| 18 | |
| 19 | v0.1 follows the same upload-first, inference-then-confirm pattern as mt-freelance-intake v0.1: |
| 20 | |
| 21 | 1. **Compact refusal sweep** using `ask_user_input_v0` -- 3 interactive questions, ~30 seconds. |
| 22 | 2. **Upload-first workflow** -- after the refusal check, the user dumps everything they have. |
| 23 | 3. **Inference pass** -- Claude parses every document and extracts as much as possible. |
| 24 | 4. **Gap-filling only** -- Claude asks the user ONLY about what is missing, ambiguous, or needs confirmation. |
| 25 | 5. **Single confirmation pass** at the end -- show the full picture, let the user correct anything wrong, hand off to downstream skills. |
| 26 | |
| 27 | Target: intake completes in 5 minutes for a prepared user, 15 minutes for a user who has to go fetch documents. |
| 28 | |
| 29 | ## Critical operating principles |
| 30 | |
| 31 | **Do not narrate the workflow.** Do not say "Phase 1," "Phase 2," "Now I'll ask you about deductions." Just do the work. |
| 32 | |
| 33 | **Do not ask questions that have already been answered.** If the refusal check established the user is GST registered, do not later ask about GST status. Track what is known. |
| 34 | |
| 35 | **Do not ask about things visible in uploaded documents.** If the bank statement shows quarterly BAS payments to the ATO, do not ask "did you lodge BAS." Confirm what you see, do not re-ask. |
| 36 | |
| 37 | **Use `ask_user_input_v0` for any multiple-choice question.** Text input is only for genuinely open-ended data (names, addresses, specific amounts when they cannot be inferred). |
| 38 | |
| 39 | **Prefer batching.** Ask 3 related questions in a single message when they do not depend on each other's answers. |
| 40 | |
| 41 | **Be terse but complete.** No hedging, no "let me know if you have questions," no "I hope this helps." |
| 42 | |
| 43 | **Exception for blocking decisions.** If a single question determines whether the user is in-scope or out-of-scope, ask it standalone. |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## Section 1 -- The opening |
| 48 | |
| 49 | When triggered, respond with ONE message that: |
| 50 | |
| 51 | 1. One-line greeting (no paragraph of expectation-setting) |
| 52 | 2. One-line summary of the flow (scope check -> upload -> gaps -> handoff to return assembly) |
| 53 | 3. One-line reviewer reminder (must be reviewed by registered tax agent before filing) |
| 54 | 4. Launch the refusal sweep immediately using `ask_user_input_v0` |
| 55 | |
| 56 | **Example first message:** |
| 57 | |
| 58 | > Let's get your 2025 Australian returns ready. Quick scope check, then you upload your documents, then I fill in the gaps. Target time: 10 minutes. |
| 59 | > |
| 60 | > Reminder: everything I produce needs to be reviewed and signed off by a registered tax agent before you lodge anything with the ATO. I'm not a substitute for review. |
| 61 | > |
| 62 | > Scope check: |
| 63 | |
| 64 | Then immediately call `ask_user_input_v0` with the refusal questions. |
| 65 | |
| 66 | **Do NOT:** |
| 67 | - Write a welcome paragraph |
| 68 | - Explain the phases |
| 69 | - Ask "are you ready to start" |
| 70 | - List what documents you will eventually need |
| 71 | - Give a disclaimer beyond the one reviewer line |
| 72 | |
| 73 | --- |
| 74 | |
| 75 | ## Section 2 -- Refusal sweep (compact) |
| 76 | |
| 77 | Present the refusal sweep as a single `ask_user_input_v0` call with 3 questions, all single-select. |
| 78 | |
| 79 | **The 3 questions to ask first:** |
| 80 | |
| 81 | ``` |
| 82 | Q1: "Australian residency in 2024-25?" |
| 83 | Options: ["Full year", "Part year", "Did not live in Australia"] |
| 84 | |
| 85 | Q2: "Business structure?" |
| 86 | Options: ["Sole trader (ABN in your name)", "Partnership", "Company (Pty Ltd)", "Trust", "Not sure"] |
| 87 | |
| 88 | Q3: "Do you have an ABN?" |
| 89 | Options: ["Yes", "No", "Applied but not yet received"] |
| 90 | ``` |
| 91 | |
| 92 | **After the response, evaluate:** |
| 93 | |
| 94 | - **Q1 = Full year** -> continue |
| 95 | - **Q1 = Part year or did not live in Australia** -> stop. "I'm set up for full-year Australian residents only. Part-year or non-residents have different rules around foreign income and dual residency. You need a registered tax agent who handles non-resident returns." |
| 96 | |
| 97 | - **Q2 = Sole trader** -> continue |
| 98 | - **Q2 = Partnership** -> stop. "Partnerships lodge a separate partnership return and distribute income to partners. You need a registered tax agent familiar with partnership returns." |
| 99 | - **Q2 = Company (Pty Ltd)** -> stop. "I don't cover company returns. Companies lodge a separate company tax return with different rules. You need a registered tax agent." |
| 100 | - **Q2 = Trust** -> stop. "Trust returns have separate distribution and reporting requirements. You need a registered tax agent familiar with trust returns." |
| 101 | - **Q2 = Not sure** -> ask one follow-up: "Do you operate under your own name (or a registered business name) with an individual ABN? Or do you have a registered company with ASIC? If you invoice under your own ABN, you're a sole trader. If you have an ACN and Pty Ltd, you're a company." |
| 102 | |
| 103 | - **Q3 = Yes** -> continue |
| 104 | - **Q3 = No** -> stop. "You need an ABN to operate as a sole trader. Apply at abr.gov.au. Once you have your ABN, come back and we can prepare your returns." |
| 105 | - **Q3 = Applied but not yet received** -> continue with a flag: ABN pending, will need to confirm before lodging. |
| 106 | |
| 107 | **After Q1-Q3 pass, ask the second batch of scope questions (also batched):** |
| 108 | |
| 109 | ``` |
| 110 | Q4: "GST registered?" |
| 111 | Options: ["Yes (turnover above $75K or voluntarily registered)", "No (turnover under $75K)", "Not sure"] |
| 112 | |
| 113 | Q5: "Marital / dependant status?" |
| 114 | Options: ["Single no dependants", "Single with dependants", "Married / de facto no dependants", "Married / de facto with dependants"] |
| 115 | |
| 116 | Q6: "Industry?" |
| 117 | Options: ["Software / tech / IT services", "Professional services (accounting, legal, consulting)", "Trades (construction, electrical, plumbing)", "Creative (design, media, photography)", "Other"] |
| 118 | ``` |
| 119 | |
| 120 | **Evaluate Q4:** |
| 121 | - **Yes** -> continue. Standard quarterly BAS lodgement. |
| 122 | - **No** -> continue. No BAS required unless turnover crosses $75K threshold. Will check after inference. |
| 123 | - **Not sure** -> ask one follow-up: "Do you charge GST on your invoices (i.e., your prices include a 10% GST component)? If yes, you're registered. If your invoices say 'no GST' or you've never dealt with BAS, you're likely not registered. Check your ABN registration at abr.gov.au." |
| 124 | |
| 125 | **Evaluate Q5:** |
| 126 | - All options -> note for Medicare levy surcharge and tax offset calculations. Continue. |
| 127 | |
| 128 | **Evaluate Q6:** |
| 129 | - All options -> note for expense classification context. Continue. |
| 130 | |
| 131 | **Total time:** ~45 seconds if the user taps through. |
| 132 | |
| 133 | --- |
| 134 | |
| 135 | ## Section 3 -- The dump |
| 136 | |
| 137 | Once the refusal sweep passes, immediately ask for the document dump. Single message. No preamble. |
| 138 | |
| 139 | **Example:** |
| 140 | |
| 141 | > Scope is good. Now upload everything you have for 2024-25 -- drop it all in at once: |
| 142 | > |
| 143 | > - Business bank statement(s) for all of 2024-25 (1 July 2024 - 30 June 2025) (CSV or PDF) |
| 144 | > - Sales invoices issued in 2024-25 |
| 145 | > - Purchase invoices / receipts for business expenses |
| 146 | > - Prior year tax return (2023-24 ITR, or at least last year's notice of assessment) |
| 147 | > - PAYG payment summary / income statement from any employer (if also employed) |
| 148 | > - Private health insurance statement (from your insurer) |
| 149 | > - HELP/HECS statement (if applicable) |
| 150 | > - BAS lodgements for 2024-25 (if GST registered) |
| 151 | > - Superannuation statements (personal contributions) |
| 152 | > - Motor vehicle logbook (if claiming vehicle expenses) |
| 153 | > - Any ATO correspondence or notices |
| 154 | > - Anything else tax-related you have |
| 155 | > |
| 156 | > Don't worry about labeling or organizing -- I'll figure out what each file is. Drag and drop when ready. |
| 157 | |
| 158 | Then wait. Do not ask any other questions while waiting. |
| 159 | |
| 160 | **If the user uploads a partial dump and says "that's what I have":** move to inference. Do not demand more. Request specific missing items during gap-filling. |
| 161 | |
| 162 | **If the user says "I don't know what I have":** Switch to guided mode: |
| 163 | > Check these places: |
| 164 | > - Business bank: download 2024-25 statements as PDF or CSV (1 July 2024 - 30 June 2025) |
| 165 | > - myGov / ATO online: download income statement, prior returns, NOA |
| 166 | > - Email: search for "invoice", "BAS", "ATO", "super", "health insurance" |
| 167 | > - Your health insurer's portal: download the annual tax statement |
| 168 | > - Your super fund's portal: download the annual statement |
| 169 | > - Your accountant from last year, if you had one |
| 170 | > - Dropbox / Google Drive for saved invoices |
| 171 | > |
| 172 | > Come back when you have something to upload. I'll work with whatever you bring. |
| 173 | |
| 174 | --- |
| 175 | |
| 176 | ## Section 4 -- The inference pass |
| 177 | |
| 178 | When documents arrive, parse each one. For each document, extract: |
| 179 | |
| 180 | **Bank statement:** |
| 181 | - Total deposits (candidate gross receipts) |
| 182 | - Recurring inflows (client payments with names) |
| 183 | - Outflows to ATO (PAYG instalment payments with dates) |
| 184 | - Outflows to ATO (BAS/GST payments with dates) |
| 185 | - Outflows to super funds (personal super contributions with dates and amounts) |
| 186 | - Outflows to suppliers (business expenses by category) |
| 187 | - Equipment purchases (potential instant asset write-off or depreciation items) |
| 188 | - Transfers to personal account (owner draws) |
| 189 | - Any rent payments (potential home office or business premises) |
| 190 | - SaaS / software subscriptions |
| 191 | - Professional memberships |
| 192 | - Insurance payments (PI, motor, income protection) |
| 193 | |
| 194 | **Sales invoices:** |
| 195 | - Client names and amounts |
| 196 | - Whether GST was charged (registered indicator) |
| 197 | - Whether invoices say "no GST" (unregistered indicator) |
| 198 | - Total turnover reconciliation against bank deposits |
| 199 | - Any foreign clients (withholding tax implications) |
| 200 | |
| 201 | **Purchase invoices / receipts:** |
| 202 | - Expense category (revenue, capital) |
| 203 | - GST amount on each (claimable input tax credit for GST registered) |
| 204 | - Any items eligible for instant asset write-off (under $20,000 threshold for 2024-25) |
| 205 | - Any items that must be depreciated (above threshold or excluded assets) |
| 206 | - Any blocked categories (entertainment, personal, non-deductible fines/penalties) |
| 207 | |
| 208 | **Prior year ITR / Notice of Assessment:** |
| 209 | - Prior year taxable income (drives PAYG instalment calculation) |
| 210 | - Prior year tax liability |
| 211 | - Prior year capital allowances / depreciation schedule |
| 212 | - Any carried-forward losses |
| 213 | - PAYG instalment rate or amount from NOA |
| 214 | |
| 215 | **PAYG payment summary / income statement:** |
| 216 | - Gross salary/wages from employment (if also employed) |
| 217 | - Tax withheld by employer |
| 218 | - Reportable fringe benefits |
| 219 | - Reportable super contributions |
| 220 | |
| 221 | **Private health insurance statement:** |
| 222 | - Insurer name |
| 223 | - Level of cover (hospital, extras, combined) |
| 224 | - Days covered |
| 225 | - PHI rebate tier (age-based) |
| 226 | - Whether rebate was claimed as a premium reduction or will be claimed on the return |
| 227 | |
| 228 | **HELP/HECS statement:** |
| 229 | - Outstanding HELP debt balance |
| 230 | - Compulsory repayment income threshold |
| 231 | |
| 232 | **BAS lodgements:** |
| 233 | - Quarterly GST collected (1A) |
| 234 | - Quarterly GST paid (1B) |
| 235 | - PAYG instalment amounts |
| 236 | - Net GST position per quarter |
| 237 | |
| 238 | **Super statements:** |
| 239 | - Concessional contributions (employer + salary sacrifice + personal deductible) |
| 240 | - Non-concessional contributions |
| 241 | - Total super balance (for Division 293 check if income + super > $250K) |
| 242 | |
| 243 | **After parsing everything, build an internal inference object.** Do not show the raw inference yet -- transform it into a compact summary for the user in Section 5. |
| 244 | |
| 245 | --- |
| 246 | |
| 247 | ## Section 5 -- The confirmation |
| 248 | |
| 249 | After inference, present a single compact summary message. Use a structured format that is fast to scan. Invite the user to correct anything wrong. |
| 250 | |
| 251 | **Example summary message:** |
| 252 | |
| 253 | > Here's what I pulled from your documents. Skim and tell me what's wrong. |
| 254 | > |
| 255 | > **Identity** |
| 256 | > - Jane Smith, single no dependants |
| 257 | > - Full-year Australian resident (Sydney, NSW) |
| 258 | > - Sole trader, ABN 12 345 678 901 |
| 259 | > - GST registered |
| 260 | > |
| 261 | > **Business Income (from bank statement + invoices)** |
| 262 | > - Gross business income (ex-GST): ~$95,000 |
| 263 | > - TechCorp Pty Ltd: $48,000 (monthly retainer) |
| 264 | > - DesignHub: $30,000 (project work) |
| 265 | > - Various smaller clients: $17,000 |
| 266 | > - GST collected (10%): ~$9,500 |
| 267 | > |
| 268 | > **Employment Income (from PAYG summary)** |
| 269 | > - None (fully self-employed) |
| 270 | > |
| 271 | > **Expenses (from bank statement + purchase invoices)** |
| 272 | > - Software / SaaS subscriptions: $2,400 |
| 273 | > - Professional insurance: $1,200 |
| 274 | > - Accounting fees: $1,500 |
| 275 | > - Phone / internet: $1,800 (TBD -- need business use %) |
| 276 | > - Motor vehicle: $4,200 fuel + maintenance (TBD -- method and business use %) |
| 277 | > - Equipment: MacBook Pro $3,200 (Nov 2024) -- instant asset write-off eligible (under $20K) |
| 278 | > - GST credits on purchases: ~$1,100 (claimable) |
| 279 | > |
| 280 | > **Super Contributions (from super statement)** |
| 281 | > - Personal deductible contributions: $8,000 |
| 282 | > - Concessional cap remaining: $22,000 (of $30,000 cap) |
| 283 | > |
| 284 | > **PAYG Instalments (from BAS)** |
| 285 | > - Q1 instalment: $1,200 |
| 286 | > - Q2 instalment: $1,200 |
| 287 | > - Q3 instalment: $1,200 |
| 288 | > - Q4 instalment: $1,200 |
| 289 | > - Total PAYG instalments paid: $4,800 |
| 290 | > |
| 291 | > **Private Health Insurance (from insurer statement)** |
| 292 | > - Combined hospital + extras, full year cover |
| 293 | > - Rebate tier: Base tier (under 65, income under $97K single -- TBD after final taxable income) |
| 294 | > - Rebate claimed as premium reduction |
| 295 | > |
| 296 | > **HELP Debt** |
| 297 | > - Outstanding balance: $18,500 |
| 298 | > - Compulsory repayment will depend on repayment income |
| 299 | > |
| 300 | > **Flags I already see:** |
| 301 | > 1. Phone / internet -- need business use percentage |
| 302 | > 2. Motor vehicle -- need method (cents-per-km or logbook) and business use % |
| 303 | > 3. MacBook Pro $3,200 -- eligible for instant asset write-off under $20K threshold |
| 304 | > 4. Super contributions well within $30K concessional cap -- no excess issue |
| 305 | > 5. PHI rebate tier may shift depending on final taxable income |
| 306 | > 6. HELP compulsory repayment to be calculated from repayment income |
| 307 | > |
| 308 | > **Is any of this wrong? Reply "looks good" or tell me what to fix.** |
| 309 | |
| 310 | --- |
| 311 | |
| 312 | ## Section 6 -- Gap filling |
| 313 | |
| 314 | After the user confirms the summary (or corrects it), ask about things that cannot be inferred from documents. Use `ask_user_input_v0` where possible. |
| 315 | |
| 316 | **Things that usually cannot be inferred:** |
| 317 | |
| 318 | 1. **Home office** -- Cannot tell from documents whether a dedicated workspace exists and which method is used. |
| 319 | 2. **Private use percentage** -- Phone, internet, motor vehicle business-use split. |
| 320 | 3. **Motor vehicle method** -- Cents-per-km (max 5,000 km) or logbook method. |
| 321 | 4. **Instant asset write-off items** -- Confirm any assets purchased are used for business and eligible. |
| 322 | 5. **PHI tier** -- May need confirmation if income is near a tier boundary. |
| 323 | 6. **HELP repayment plan** -- Confirm outstanding balance. |
| 324 | 7. **Other income** -- Interest, dividends, rental, capital gains. |
| 325 | |
| 326 | **Home office gap-filling example:** |
| 327 | |
| 328 | Call `ask_user_input_v0` with: |
| 329 | |
| 330 | ``` |
| 331 | Q: "Home office claim method?" |
| 332 | Options: [ |
| 333 | "Fixed rate method (67c/hr) -- I track hours worked from home", |
| 334 | "Actual cost method -- I have records of running expenses and floor area", |
| 335 | "I work from a separate business premises (not home)", |
| 336 | "I don't work from home", |
| 337 | "Not sure which method" |
| 338 | ] |
| 339 | ``` |
| 340 | |
| 341 | If option 1 -> ask for total hours worked from home during 2024-25 (text input). |
| 342 | If option 2 -> flag as complex: actual cost method requires detailed records of electricity, gas, internet, phone, depreciation of furniture. Ask for floor area percentage of dedicated workspace. |
| 343 | If option 3 -> rent is already captured in expenses. No home office calculation needed. |
| 344 | If option 4 -> skip home office entirely. |
| 345 | If option 5 -> recommend fixed rate method (67c/hr) as simpler. Ask for hours. |
| 346 | |
| 347 | Note: The 2024-25 rate is 67 cents per hour (revised rate effective 1 July 2022). This replaces the old 52c/hr method. |
| 348 | |
| 349 | **Motor vehicle gap-filling example:** |
| 350 | |
| 351 | Call `ask_user_input_v0` with: |
| 352 | |
| 353 | ``` |
| 354 | Q: "Motor vehicle method?" |
| 355 | Options: [ |
| 356 | "Cents-per-km (85c/km, max 5,000 business km)", |
| 357 | "Logbook method (I kept a logbook for 12+ weeks)", |
| 358 | "No vehicle used for business" |
| 359 | ] |
| 360 | ``` |
| 361 | |
| 362 | If option 1 -> ask for estimated business kilometres driven in 2024-25 (max 5,000). Rate is 85 cents/km for 2024-25. |
| 363 | If option 2 -> ask for logbook business-use percentage and total car expenses. |
| 364 | If option 3 -> skip vehicle entirely. |
| 365 | |
| 366 | Flag all private-use percentages as T2 -- registered tax agent must confirm the percentage is reasonable and documented. |
| 367 | |
| 368 | **Other income:** |
| 369 | |
| 370 | Call `ask_user_input_v0` with: |
| 371 | |
| 372 | ``` |
| 373 | Q: "Any other income in 2024-25?" |
| 374 | Options: [ |
| 375 | "Interest income (bank accounts)", |
| 376 | "Dividend income (shares)", |
| 377 | "Rental income (investment property)", |
| 378 | "Capital gains (sold shares, crypto, property)", |
| 379 | "None of the above", |
| 380 | "Multiple of the above" |
| 381 | ] |
| 382 | ``` |
| 383 | |
| 384 | If any selected -> ask for amounts as text input. Flag rental income and capital gains as potentially out of scope for this workflow (complex supplementary schedules). |
| 385 | |
| 386 | --- |
| 387 | |
| 388 | ## Section 7 -- The final handoff |
| 389 | |
| 390 | Once gap-filling is done, produce a final handoff message and hand off to `au-return-assembly`. |
| 391 | |
| 392 | **Example handoff message:** |
| 393 | |
| 394 | > Intake complete. Here's what's going to the return assembly: |
| 395 | > |
| 396 | > Sole trader, single, GST registered, full-year Australian resident. Gross business income $95,000 (ex-GST), estimated net ~$78,000 before super deduction. |
| 397 | > |
| 398 | > I'm now going to run the full Australian return preparation. This covers: |
| 399 | > 1. BAS reconciliation (Q4 if outstanding, or full-year summary) |
| 400 | > 2. Individual tax return (ITR) |
| 401 | > 3. Super guarantee / voluntary contribution reconciliation |
| 402 | > 4. Medicare levy and surcharge calculation |
| 403 | > 5. PAYG instalment reconciliation and next-year schedule |
| 404 | > |
| 405 | > You'll get back: |
| 406 | > 1. An Excel working paper with all forms and live formulas |
| 407 | > 2. A reviewer brief with positions, citations, and flags for your tax agent |
| 408 | > 3. A filing calendar with all upcoming deadlines |
| 409 | > |
| 410 | > Starting now. |
| 411 | |
| 412 | Then internally invoke `au-return-assembly` with the structured intake package. |
| 413 | |
| 414 | --- |
| 415 | |
| 416 | ## Section 8 -- Structured intake package (internal format) |
| 417 | |
| 418 | The downstream skill (`au-return-assembly`) consumes a JSON structure. It is internal and not shown to the user unless they ask. Key fields: |
| 419 | |
| 420 | ```json |
| 421 | { |
| 422 | "jurisdiction": "AU", |
| 423 | "tax_year": "2024-25", |
| 424 | "taxpayer": { |
| 425 | "name": "", |
| 426 | "date_of_birth": "", |
| 427 | "marital_status": "single | single_dependants | married | married_dependants", |
| 428 | "residency": "full_year", |
| 429 | "abn": "", |
| 430 | "tfn": "", |
| 431 | "gst_registered": true, |
| 432 | "employment_status": "self_employed | employed_plus_side", |
| 433 | "industry": "", |
| 434 | "entity_type": "sole_trader", |
| 435 | "state": "" |
| 436 | }, |
| 437 | "business_income": { |
| 438 | "gross_income_ex_gst": 0, |
| 439 | "gst_collected": 0, |
| 440 | "client_breakdown": [] |
| 441 | }, |
| 442 | "employment_income": { |
| 443 | "gross_salary": 0, |
| 444 | "tax_withheld": 0, |
| 445 | "reportable_fringe_benefits": 0, |
| 446 | "reportable_super": 0 |
| 447 | }, |
| 448 | "other_income": { |
| 449 | "interest": 0, |
| 450 | "dividends": 0, |
| 451 | "franking_credits": 0, |
| 452 | "rental": 0, |
| 453 | "capital_gains": 0 |
| 454 | }, |
| 455 | "expenses": { |
| 456 | "fully_deductible": [], |
| 457 | "mixed_use": [], |
| 458 | "blocked": [], |
| 459 | "instant_asset_writeoff": [], |
| 460 | "depreciating_assets": [] |
| 461 | }, |
| 462 | "gst": { |
| 463 | "quarterly_bas_lodged": [], |
| 464 | "gst_collected_total": 0, |
| 465 | "gst_credits_total": 0, |
| 466 | "net_gst_position": 0 |
| 467 | }, |
| 468 | "super": { |
| 469 | "personal_deductible_contributions": 0, |
| 470 | "employer_contributions": 0, |
| 471 | "salary_sacrifice": 0, |
| 472 | "total_concessional": 0, |
| 473 | "concessional_cap": 30000, |
| 474 | "non_concessional": 0, |
| 475 | "total_super_balance": 0 |
| 476 | }, |
| 477 | "payg_instalments": { |
| 478 | "instalment_rate": 0, |
| 479 | "quarterly_amounts": [], |
| 480 | "total_paid": 0, |
| 481 | "prior_year_noa_rate": 0 |
| 482 | }, |
| 483 | "phi": { |
| 484 | "has_phi": false, |
| 485 | "cover_type": "", |
| 486 | "days_covered": 0, |
| 487 | "rebate_tier": "", |
| 488 | "rebate_claimed_as_reduction": false |
| 489 | }, |
| 490 | "help": { |
| 491 | "has_help_debt": false, |
| 492 | "outstanding_balance": 0 |
| 493 | }, |
| 494 | "home_office": { |
| 495 | "method": "fixed_rate | actual_cost | none", |
| 496 | "hours_worked_from_home": 0, |
| 497 | "rate_per_hour": 0.67, |
| 498 | "floor_area_pct": 0 |
| 499 | }, |
| 500 | "motor_vehicle": { |
| 501 | "method": "cents_per_km | logbook | none", |
| 502 | "business_km": 0, |
| 503 | "rate_per_km": 0.85, |
| 504 | "logbook_business_pct": 0, |
| 505 | "total_car_expenses": 0 |
| 506 | }, |
| 507 | "prior_year": { |
| 508 | "taxable_income": 0, |
| 509 | "tax_liability": 0, |
| 510 | "carried_forward_losses": 0, |
| 511 | "depreciation_schedule": [] |
| 512 | }, |
| 513 | "open_flags": [], |
| 514 | "refusals_triggered": [], |
| 515 | "documents_received": [] |
| 516 | } |
| 517 | ``` |
| 518 | |
| 519 | --- |
| 520 | |
| 521 | ## Section 9 -- Refusal handling |
| 522 | |
| 523 | Refusals fire from either the refusal sweep (Section 2) or during inference (e.g., company structure discovered in documents). |
| 524 | |
| 525 | When a refusal fires: |
| 526 | 1. Stop the workflow |
| 527 | 2. State the specific reason in one sentence |
| 528 | 3. Recommend the path forward (specific practitioner type) |
| 529 | 4. Offer to continue with partial help ONLY if the out-of-scope item is cleanly separable (rare) |
| 530 | |
| 531 | **Do not:** |
| 532 | - Apologise profusely |
| 533 | - Try to work around the refusal |
| 534 | - Suggest the user "might be able to" fit into scope if they answer differently |
| 535 | - Continue silently |
| 536 | |
| 537 | **Sample refusal:** |
| 538 | |
| 539 | > Stop -- you have a registered Pty Ltd company. I'm set up for sole traders only. Companies lodge company tax returns with different rules for franking, dividends, and corporate tax rates. You need a registered tax agent familiar with company returns. |
| 540 | > |
| 541 | > I can't help with this one. |
| 542 | |
| 543 | --- |
| 544 | |
| 545 | ## Section 10 -- Self-checks |
| 546 | |
| 547 | **Check IN1 -- No one-question-at-a-time prose in the refusal sweep.** If the skill asked "Question 1 of 10" or walked through questions as separate messages, check fails. |
| 548 | |
| 549 | **Check IN2 -- Refusal sweep used ask_user_input_v0.** The first substantive interaction used the interactive tool, not prose questions. |
| 550 | |
| 551 | **Check IN3 -- Upload-first flow honoured.** After refusal sweep, the skill asked for a document dump before asking any content questions. |
| 552 | |
| 553 | **Check IN4 -- Documents were parsed and inferred before asking questions.** The inference summary (Section 5) was shown before gap-filling questions (Section 6). |
| 554 | |
| 555 | **Check IN5 -- Gap-filling only asked about things NOT visible in documents.** If the skill asked "did you pay super" after the bank statement showed super fund payments, check fails. |
| 556 | |
| 557 | **Check IN6 -- Open flags captured.** Anything ambiguous, risky, or attention-worthy during inference is in the `open_flags` list in the handoff package. |
| 558 | |
| 559 | **Check IN7 -- Handoff to `au-return-assembly` is explicit.** The user was told "I'm now going to run the return preparation," and the downstream orchestrator was explicitly invoked with the intake package. |
| 560 | |
| 561 | **Check IN8 -- Reviewer step was stated upfront and reiterated before handoff.** The opening message mentioned registered tax agent signoff. |
| 562 | |
| 563 | **Check IN9 -- Refusals were clean.** No hedging. Stop means stop. |
| 564 | |
| 565 | **Check IN10 -- No meta-commentary about workflow phases.** The skill did not say "Phase 1," "Phase 2," etc. |
| 566 | |
| 567 | **Check IN11 -- Total user-facing turn count is low.** Target: 8 turns or fewer from start to handoff for a prepared user (1 refusal batch + 1 upload + 1 confirmation + 1-3 gap fills + 1 handoff). More than 12 turns for a normal intake is a check failure. |
| 568 | |
| 569 | **Check IN12 -- GST registration status was established.** GST registered vs unregistered was confirmed before inference, as it changes how every transaction is classified. |
| 570 | |
| 571 | --- |
| 572 | |
| 573 | ## Section 11 -- Performance targets |
| 574 | |
| 575 | For a prepared user (documents in a folder, ready to upload): |
| 576 | - **Refusal sweep**: 45 seconds (1-2 interactive turns) |
| 577 | - **Document upload**: 2 minutes (1 upload turn) |
| 578 | - **Inference and confirmation display**: 1 minute Claude processing + 1 turn for user confirmation |
| 579 | - **Gap filling**: 2 minutes (2-3 interactive turns) |
| 580 | - **Handoff**: immediate |
| 581 | - **Total**: ~6 minutes |
| 582 | |
| 583 | For an unprepared user (has to go fetch documents): |
| 584 | - Refusal sweep: same |
| 585 | - Document discovery: 10-20 minutes offline |
| 586 | - Rest: same |
| 587 | - **Total**: 15-25 minutes |
| 588 | |
| 589 | --- |
| 590 | |
| 591 | ## Section 12 -- Cross-skill references |
| 592 | |
| 593 | **Inputs:** User-provided documents and answers. |
| 594 | |
| 595 | **Outputs:** Structured intake package consumed by `au-return-assembly`. |
| 596 | |
| 597 | **Downstream skills triggered (via au-return-assembly):** |
| 598 | - `australia-gst` -- BAS quarterly GST return |
| 599 | - `au-individual-return` -- Individual tax return (ITR) |
| 600 | - `au-super-guarantee` -- Super contributions reconciliation |
| 601 | - `au-medicare-levy` -- Medicare levy and surcharge |
| 602 | - `au-payg-instalments` -- PAYG instalment schedule |
| 603 | |
| 604 | --- |
| 605 | |
| 606 | ### Change log |
| 607 | |
| 608 | - **v0.1 (April 2026):** Initial draft. Upload-first, inference-then-confirm pattern modelled on mt-freelance-intake v0.1. |
| 609 | |
| 610 | ## End of Intake Skill v0.1 |
| 611 | |
| 612 | |
| 613 | --- |
| 614 | |
| 615 | ## Disclaimer |
| 616 | |
| 617 | 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. |
| 618 | |
| 619 | 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. |
| 620 |
Run this skill, then get an accountant to check it
After running the full skill pack in Claude, 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.
Depends on
Quality
Q2: Research-verified
Deep research against tax authority sources. Not yet tested on real data.
Needs real client data + practitioner sign-off to reach Q1.
Accountant Review
Unverified
0/19
About
ALWAYS USE THIS SKILL when a user asks for help preparing their Australian tax returns AND mentions freelancing, self-employment, contracting, sole trading, or ABN-based work. Trigger on phrases like "help me do my taxes", "prepare my ITR", "I'm a sole trader in Australia", "I'm a freelancer in Australia", "do my taxes as a contractor", "prepare my BAS and income tax", or any similar phrasing where the user is an Australian-resident self-employed individual needing tax return preparation. This is the REQUIRED entry point for the Australian self-employed tax workflow -- every other skill in the stack (australia-gst, au-individual-return, au-super-guarantee, au-medicare-levy, au-payg-instalments, au-return-assembly) depends on this skill running first to produce a structured intake package. Uses upload-first workflow -- the user dumps all their documents and the skill infers as much as possible before asking questions. Uses ask_user_input_v0 for structured questions instead of one-at-a-time prose. Built for speed. Australian full-year residents only; sole traders only.
AUty-2025