Not tax advice. Computation tools only. Have a professional review before filing.
openaccountants/skills/au-return-assembly.md
au-return-assembly.md410 lines23.7 KB
v1Orchestrator
1---
2name: au-return-assembly
3description: Final orchestrator skill that assembles the complete Australian filing package for Australian-resident sole traders. Consumes outputs from all Australian content skills (australia-gst for BAS, au-individual-return for ITR, au-super-guarantee for voluntary contributions, au-medicare-levy for levy and surcharge, au-payg-instalments for instalment schedule) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all Australian content skills listed above. Australian full-year residents only. Sole traders only.
4version: 0.1
5---
6 
7# Australia Return Assembly Skill v0.1
8 
9## CRITICAL EXECUTION DIRECTIVE -- READ FIRST
10 
11**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.**
12 
13Specifically:
14 
15- **Do NOT ask the user "how deep do you want me to go"** or "do you want the full package" or any variant. The user asked for their tax returns. They want their tax returns. Produce them.
16- **Do NOT announce how many tokens or tool calls this will take.** Execute.
17- **Do NOT ask which deliverables to prioritise.** Produce all deliverables listed in Section 4. If you run out of context mid-execution, finish the computation work first (numbers, positions, flags) then produce whatever formatted outputs you can, and at the very end state clearly which deliverables were not produced and why.
18- **Do NOT re-validate scope that intake already validated.** If `au-freelance-intake` produced an intake package, trust it. You can cross-check specific numbers during reconciliation but do not re-interrogate the user about residency, business structure, or anything else intake already captured.
19- **Do NOT pause between content skills to check in.** Run them in dependency order (Section 2) without prose status updates between each one. A single status message at the end is fine.
20- **Self-checks are targets, not blockers.** If a self-check fails, note it in the reviewer brief's open flags section and continue. Do NOT halt the entire workflow because one self-check had an ambiguous answer.
21- **Primary source citations go in the final reviewer brief, not in intermediate computation steps.**
22 
23**The user has already been told (by the intake skill) that the final package requires registered tax agent signoff before lodging. State it once in the final output and move on.**
24 
25**Failure mode to avoid:** The skill halts mid-execution and asks the user a meta-question about workflow pacing. If you feel the urge to ask "how should I proceed," the correct action is to pick the most defensible path and proceed, flagging the decision in the reviewer brief so the reviewer can challenge it.
26 
27---
28 
29## What this file is
30 
31The final capstone skill for Australian sole trader returns. Every Australian content skill feeds into this one. The output is the complete reviewer package that a registered tax agent can review, sign off on, and deliver to the client along with lodgement instructions.
32 
33This skill coordinates execution of the content skills, verifies cross-skill consistency, and assembles the final deliverable.
34 
35---
36 
37## Section 1 -- Scope
38 
39Produces the complete Australian filing package for:
40- Full-year Australian residents
41- Sole traders
42- Tax year 2024-25 (1 July 2024 - 30 June 2025)
43- Lodging BAS (if GST registered), individual tax return (ITR), super reconciliation, Medicare levy calculation, PAYG instalment schedule
44 
45---
46 
47## Section 2 -- Execution order and dependency chain
48 
49The skill enforces the following execution order:
50 
511. **`australia-gst`** -- BAS return (quarterly, if GST registered)
52 - Runs first because GST turnover figures feed into the ITR
53 - For GST-registered: prepare any outstanding quarterly BAS; verify previously lodged quarters
54 - Output: BAS box values (1A GST on sales, 1B GST on purchases), net GST position, turnover (ex-GST)
55 - **Status check:** australia-gst is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute BAS figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available.
56 
572. **`au-individual-return`** -- Individual tax return (ITR)
58 - Depends on BAS output: business income must use ex-GST turnover for GST-registered traders
59 - Depends on BAS output: GST credits are excluded from deductible expenses (net amounts only)
60 - Output: ITR label values, taxable income, tax on taxable income, tax offsets, tax liability
61 - **Status check:** au-individual-return is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute ITR figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available.
62 
633. **`au-super-guarantee`** -- Voluntary super contributions reconciliation
64 - Depends on ITR: personal deductible contributions reduce taxable income
65 - Verifies contributions are within the $30,000 concessional cap
66 - Output: contribution amounts, cap utilisation, any excess contributions
67 - **Status check:** au-super-guarantee is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute super figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available.
68 
694. **`au-medicare-levy`** -- Medicare levy and surcharge
70 - Depends on ITR: levy is 2% of taxable income; surcharge applies if no PHI and income above threshold
71 - Checks PHI status from intake package
72 - Output: Medicare levy amount, surcharge amount (if applicable), PHI rebate adjustment
73 - **Status check:** au-medicare-levy is currently a Q2 skill. If it has substantive computation content, use it. If it is still a placeholder, compute Medicare figures from the intake package data and flag in the reviewer brief that the dedicated skill was not available.
74 
755. **`au-payg-instalments`** -- PAYG instalment schedule (next year)
76 - Depends on ITR: instalment income and rate for 2025-26 based on 2024-25 return
77 - Reconciles instalments paid during 2024-25 against final tax liability
78 - Output: instalment credit for current year, next-year instalment schedule
79 - **Status check:** au-payg-instalments is currently a Q4 stub. If the stub has substantive computation content, use it. If it is still a placeholder, compute PAYG instalment figures using the ATO's instalment rate method and flag in the reviewer brief that the dedicated skill was not available.
80 
81If any upstream content skill fails to produce validated output, the assembly skill notes the failure in the reviewer brief and continues with available data rather than halting entirely.
82 
83---
84 
85## Section 3 -- Cross-skill reconciliation
86 
87### Cross-check 1: BAS G1 taxable sales = ITR business income (ex-GST)
88 
89| BAS Output | ITR Input | Rule |
90|-----------|-----------|------|
91| BAS 1A total GST on sales (annual) | Implied from ITR business income x 10% | Must reconcile |
92| BAS G1 total sales (ex-GST, annual sum) | ITR business income label | Must match within $1 |
93| Non-GST registered: gross receipts | ITR business income label | Direct match (no GST separation) |
94 
95**If mismatch:** Flag for reviewer. Common causes: timing differences (cash vs accrual), private sales included in bank deposits, GST-free supplies, input-taxed supplies.
96 
97### Cross-check 2: Super contributions within concessional cap ($30,000)
98 
99| Super Input | Source | Rule |
100|------------|--------|------|
101| Employer contributions (if also employed) | PAYG summary / income statement | Counted toward cap |
102| Salary sacrifice (if any) | PAYG summary | Counted toward cap |
103| Personal deductible contributions | Super fund statement + s290-170 notice | Counted toward cap |
104| Total concessional | Sum of above | Must not exceed $30,000 |
105 
106**If excess:** Flag for reviewer. Excess concessional contributions are included in assessable income and taxed at marginal rate (plus excess concessional contributions charge). Division 293 tax applies if income + super > $250,000.
107 
108### Cross-check 3: Medicare levy surcharge only if no PHI and income above threshold
109 
110| MLS Input | Source | Rule |
111|----------|--------|------|
112| Income for MLS purposes | ITR taxable income + reportable fringe benefits + total net investment loss + reportable super | Combined figure |
113| PHI status | Insurer statement | If adequate hospital cover for full year, no MLS |
114| MLS thresholds (2024-25) | Single: $93,000; Family: $186,000 | Below threshold = no MLS regardless of PHI |
115| MLS rates | Tier 1: 1%; Tier 2: 1.25%; Tier 3: 1.5% | Applied to taxable income |
116 
117**If MLS applies:** Calculate and include in tax liability. Flag for reviewer with income calculation breakdown.
118 
119### Cross-check 4: PAYG instalments credit against final tax
120 
121| PAYG Input | Source | Rule |
122|-----------|--------|------|
123| Instalments paid during 2024-25 | BAS PAYG instalment labels (T7/T8) or ATO records | Credit against final tax |
124| Tax withheld by employer (if any) | PAYG summary | Additional credit |
125| Final tax liability | ITR computation | Total tax - credits = balance due or refund |
126 
127**If mismatch:** Common cause is varied instalments (taxpayer requested variation), or first year with no prior instalment history.
128 
129### Cross-check 5: Instant asset write-off consistency
130 
131| System | Threshold (2024-25) | Treatment |
132|--------|---------------------|-----------|
133| GST-registered | Asset cost ex-GST < $20,000 | Immediate deduction; GST credit claimed separately |
134| Non-GST-registered | Asset cost inc-GST < $20,000 | Immediate deduction on gross cost |
135| Above threshold | Depreciate using effective life | ITR depreciation schedule |
136 
137**If inconsistency:** An asset claimed as instant write-off but costing above the threshold (on the correct GST basis) must be moved to depreciation schedule. Flag for reviewer.
138 
139---
140 
141## Section 4 -- Final reviewer package contents
142 
143### Documents
144 
1451. **Executive summary** -- one-page overview: filing status, business income, taxable income, tax liability, Medicare levy, super position, PAYG credits, refund/balance due
1462. **BAS worksheet** -- quarterly box-by-box with formulas (GST on sales, GST on purchases, PAYG instalments)
1473. **ITR worksheet** -- label-by-label with formulas and supporting schedules (business income, deductions, taxable income, tax rates, offsets)
1484. **Depreciation schedule** -- asset register with cost, date, effective life, method, annual deduction, written-down value
1495. **Super reconciliation** -- concessional cap tracking, contribution breakdown, excess check
1506. **Medicare levy worksheet** -- levy calculation, MLS assessment, PHI rebate adjustment
1517. **PAYG instalment reconciliation** -- instalments paid vs final tax, next-year schedule
1528. **Cross-skill reconciliation summary** -- all five cross-checks with pass/fail and notes
1539. **Reviewer brief** -- comprehensive narrative with positions, citations, flags, self-check results
15410. **Client action list** -- what the client needs to do, with dates and amounts
155 
156### Reviewer brief contents
157 
158```markdown
159# Complete Return Package: [Client Name] -- Tax Year 2024-25
160 
161## Executive Summary
162- Filing status: [Single / Married / etc.]
163- Residence: Australia (full-year), [State]
164- Business: Sole trader, ABN [number]
165- GST registration: Yes / No
166- Business income (ex-GST): $X
167- Total deductions: $X
168- Taxable income: $X
169- Tax on taxable income: $X
170- Medicare levy: $X
171- Medicare levy surcharge: $X / nil
172- Tax offsets: $X
173- PAYG instalments credit: $X
174- PAYG withholding credit: $X
175- Balance due / refund: $X
176- HELP compulsory repayment: $X / nil
177- 2025-26 PAYG instalment amount: $X
178 
179## BAS / GST Return
180[Content from australia-gst output]
181- Registration status and reporting period
182- GST on sales (1A) -- quarterly and annual
183- GST on purchases (1B) -- quarterly and annual
184- Net GST position per quarter
185- Any outstanding BAS quarters
186- PAYG instalment amounts per BAS
187 
188## Individual Tax Return (ITR)
189[Content from au-individual-return output]
190- Business income (ex-GST)
191- Total business deductions schedule
192- Net business income
193- Other income (interest, dividends, etc.)
194- Total income
195- Total deductions (including personal deductible super)
196- Taxable income
197- Tax on taxable income (rate table applied)
198- Tax offsets (low income, LMITO if applicable, PHI rebate)
199- Medicare levy
200- HELP compulsory repayment
201- Total tax liability
202- Less: PAYG instalments paid
203- Less: PAYG withholding
204- Balance due / refund
205 
206## Depreciation Schedule
207- Asset register with cost, purchase date, effective life, method (prime cost / diminishing value)
208- Instant asset write-off items (under $20K threshold)
209- Continuing depreciation from prior years
210- Written-down values carried forward to 2025-26
211 
212## Super Contributions
213[Content from au-super-guarantee output]
214- Personal deductible contributions (s290-170 notice required)
215- Employer contributions (if also employed)
216- Total concessional: $X of $30,000 cap
217- Excess concessional: $X / nil
218- Non-concessional contributions: $X
219- Division 293 check: income + super vs $250,000 threshold
220- Total super balance (for carry-forward cap calculation)
221 
222## Medicare Levy and Surcharge
223[Content from au-medicare-levy output]
224- Medicare levy: 2% of taxable income = $X
225- Medicare levy reduction (if low income): $X / nil
226- Income for MLS purposes: $X
227- PHI status: adequate hospital cover / no cover
228- MLS rate: X% / nil
229- MLS amount: $X / nil
230- PHI rebate tier and adjustment: $X / nil
231 
232## PAYG Instalments
233[Content from au-payg-instalments output]
234- 2024-25 instalments paid: $X (credit against final tax)
235- 2024-25 instalment rate used: X%
236- 2025-26 instalment income (from 2024-25 return): $X
237- 2025-26 instalment rate (from NOA): X%
238- 2025-26 quarterly instalment amounts:
239 - Q1 (Jul-Sep): due 28 Oct 2025
240 - Q2 (Oct-Dec): due 28 Feb 2026
241 - Q3 (Jan-Mar): due 28 Apr 2026
242 - Q4 (Apr-Jun): due 28 Jul 2026
243 
244## Cross-skill Reconciliation
245- BAS G1 vs ITR business income: [pass/fail]
246- Super within concessional cap: [pass/fail]
247- MLS correctly assessed: [pass/fail]
248- PAYG credits reconciled: [pass/fail]
249- Instant asset write-off thresholds correct: [pass/fail]
250 
251## Reviewer Attention Flags
252[Aggregated from all upstream skills]
253- T2 items requiring registered tax agent confirmation
254- Mixed-use expense percentages (motor vehicle, phone, internet)
255- Home office deduction (method and hours/area)
256- Instant asset write-off eligibility
257- Super cap proximity
258- PHI rebate tier boundary
259- HELP repayment income threshold
260- Any income approaching tax bracket boundaries
261- Any turnover approaching $75K GST registration threshold (if not registered)
262 
263## Positions Taken
264[List with legislation citations]
265- e.g., "Home office deduction claimed at 67c/hr for X hours -- Practical Compliance Guideline PCG 2023/1"
266- e.g., "Motor vehicle cents-per-km at 85c/km for X km -- s28-25 ITAA 1997, TD 2024/3"
267- e.g., "MacBook Pro instant asset write-off -- s328-180 ITAA 1997, Temporary Full Expensing extended"
268- e.g., "Personal super contribution deduction -- s290-150 ITAA 1997, s290-170 notice lodged"
269 
270## Planning Notes for 2025-26
271- PAYG instalment schedule (quarterly amounts and dates)
272- Super contribution strategy (remaining cap, carry-forward unused cap from prior years)
273- GST registration threshold monitoring (if approaching $75K)
274- Depreciation schedule continuing into 2025-26 (WDV schedule)
275- PHI rebate tier based on projected income
276- Any legislative changes affecting 2025-26 (budget measures, rate changes)
277 
278## Client Action List
279 
280### Immediate (before 31 October 2025 -- ITR lodgement deadline for self-lodgers):
2811. Review this return package with your registered tax agent
2822. Lodge ITR via myTax or through tax agent (tax agent clients have extended deadline)
2833. Pay balance due of $X to ATO (or receive refund of $X)
2844. Lodge any outstanding BAS quarters
285 
286### Note on lodgement deadlines:
287- Self-lodgers: 31 October 2025
288- Tax agent lodgement: extended deadlines apply (typically March-May 2026 depending on category)
289 
290### Quarterly obligations for 2025-26:
291- BAS Q1 (Jul-Sep): lodge and pay by 28 October 2025
292- BAS Q2 (Oct-Dec): lodge and pay by 28 February 2026
293- BAS Q3 (Jan-Mar): lodge and pay by 28 April 2026
294- BAS Q4 (Apr-Jun): lodge and pay by 28 July 2026
295 
296### Super obligations:
297- If you have employees: SG due quarterly (28 days after quarter end)
298- Personal deductible contributions: lodge s290-170 notice with super fund BEFORE lodging ITR
299- Monitor concessional cap ($30,000) across all contribution sources
300 
301### Ongoing:
3021. Issue tax invoices for all sales (if GST registered)
3032. Retain all records for 5 years from lodgement date
3043. Maintain motor vehicle logbook if claiming logbook method
3054. Track home office hours if claiming fixed rate method
3065. Monitor turnover for GST registration threshold ($75K)
3076. Review PAYG instalment rate -- vary if income changes significantly
308```
309 
310---
311 
312## Section 5 -- Refusals
313 
314**R-AU-1 -- Upstream skill did not run.** Name the specific skill. Note: this is a warning, not a hard stop. Continue with available data and flag the gap.
315 
316**R-AU-2 -- Upstream self-check failed.** Name the specific check and note it in the reviewer brief. Continue.
317 
318**R-AU-3 -- Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. Flag for reviewer but continue.
319 
320**R-AU-4 -- Intake incomplete.** Specific missing intake items prevent computation. List what is missing and ask the user for the specific data point.
321 
322**R-AU-5 -- Out-of-scope item discovered during assembly.** E.g., rental income requiring rental schedule, capital gains requiring CGT schedule, foreign income requiring FITO. Flag and exclude from computation.
323 
324---
325 
326## Section 6 -- Self-checks
327 
328**Check AU1 -- All upstream skills executed.** australia-gst, au-individual-return, au-super-guarantee, au-medicare-levy all produced output. au-payg-instalments produced output or was computed from ITR figures.
329 
330**Check AU2 -- BAS G1 matches ITR business income.** Within $1 tolerance.
331 
332**Check AU3 -- Super within concessional cap.** Total concessional contributions do not exceed $30,000 (or cap plus carry-forward unused amounts).
333 
334**Check AU4 -- Medicare levy surcharge correctly assessed.** MLS applied only if no adequate PHI and income above threshold; MLS not applied if PHI held for full year.
335 
336**Check AU5 -- PAYG instalments correctly credited.** Total instalments paid during 2024-25 credited against final tax liability.
337 
338**Check AU6 -- GST treatment correct for registered traders.** Business income reported ex-GST; input tax credits excluded from deductible expenses; GST credits claimed on BAS.
339 
340**Check AU7 -- GST treatment correct for unregistered traders.** Business income reported gross; all expenses reported gross (GST-inclusive); no BAS required.
341 
342**Check AU8 -- Instant asset write-off threshold correct.** Assets under $20,000 (on correct GST basis) claimed as immediate deduction; assets above threshold depreciated.
343 
344**Check AU9 -- Personal super deduction has s290-170 notice requirement flagged.** Reviewer brief notes that the taxpayer must lodge a notice of intent to claim with the super fund before the ITR is lodged.
345 
346**Check AU10 -- Tax rate table correct for residency.** Resident tax rates applied (including tax-free threshold of $18,200).
347 
348**Check AU11 -- HELP compulsory repayment calculated from repayment income.** Repayment income = taxable income + net investment loss + reportable fringe benefits + reportable super. Correct rate applied from HELP repayment thresholds.
349 
350**Check AU12 -- Filing calendar is complete.** All deadlines for BAS, ITR, super, and PAYG instalments are listed with specific dates and amounts.
351 
352---
353 
354## Section 7 -- Output files
355 
356The final output is **three files**:
357 
3581. **`[client_slug]_2024-25_australia_master.xlsx`** -- Single master workbook containing every worksheet and form. Sheets include: Cover, BAS Summary (quarterly), ITR (label-by-label), Depreciation Schedule, Expense Detail, Super Reconciliation, Medicare Levy, PAYG Instalments, Cross-Check Summary. Use live formulas where possible -- e.g., ITR business income references the BAS turnover cell; Medicare levy references ITR taxable income; PAYG credit references BAS instalment totals. Verify no `#REF!` errors. Verify computed values match the computation model within $1 before shipping.
359 
3602. **`reviewer_brief.md`** -- Single markdown file covering all sections from Section 4 above: executive summary, BAS, ITR, super, Medicare, PAYG, cross-skill reconciliation, flags, positions, planning notes.
361 
3623. **`client_action_list.md`** -- Single markdown file with step-by-step actions: immediate lodgements and payments, quarterly calendar for 2025-26, ongoing compliance reminders.
363 
364**If execution runs out of context mid-build:** produce whatever is complete, then state at the end which of the three files were not produced or are partial.
365 
366**All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.**
367 
368---
369 
370## Section 8 -- Cross-skill references
371 
372**Inputs:**
373- `au-freelance-intake` -- structured intake package (JSON)
374- `australia-gst` -- BAS box values and GST output
375- `au-individual-return` -- ITR label values and computation output
376- `au-super-guarantee` -- Super reconciliation output
377- `au-medicare-levy` -- Medicare levy and surcharge output
378- `au-payg-instalments` -- Instalment schedule (or fallback computation)
379 
380**Outputs:** The final reviewer package. No downstream skill.
381 
382---
383 
384## Section 9 -- Known gaps
385 
3861. PDF form filling is not automated. The reviewer uses the worksheets to lodge via myTax or tax agent portal.
3872. E-lodgement is handled by the reviewer via myTax or tax agent software, not by this skill.
3883. Payment execution is the client's responsibility; the skill only provides instructions and amounts.
3894. Rental income schedule is not supported -- if rental income exists, the skill flags it but the rental schedule must be completed separately by the reviewer.
3905. Capital gains tax (CGT) schedule is not supported -- if capital gains exist, the skill flags it but the CGT schedule must be completed separately.
3916. Foreign income and foreign income tax offset (FITO) are out of scope.
3927. Multi-year depreciation tracking assumes the prior year schedule is provided. If not, only current-year acquisitions are depreciated.
3938. au-payg-instalments is a Q4 stub. Until it is fleshed out, PAYG instalments are computed using the ATO's instalment rate method from the NOA. This is a redundancy, not a gap -- the rules are deterministic.
3949. Several upstream content skills (australia-gst, au-individual-return, au-super-guarantee, au-medicare-levy) are Q2 skills. If any are still stubs, the assembly skill computes the figures directly and flags the gap.
39510. The package is complete only for the 2024-25 tax year; 2025-26 appears only as prospective planning.
396 
397### Change log
398- **v0.1 (April 2026):** Initial draft. Modelled on mt-return-assembly v0.1 adapted for Australian jurisdiction with five content skills (BAS, ITR, super, Medicare, PAYG).
399 
400## End of skill
401 
402 
403---
404 
405## Disclaimer
406 
407This 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.
408 
409The 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.
410 

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.

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/36

About

Final orchestrator skill that assembles the complete Australian filing package for Australian-resident sole traders. Consumes outputs from all Australian content skills (australia-gst for BAS, au-individual-return for ITR, au-super-guarantee for voluntary contributions, au-medicare-levy for levy and surcharge, au-payg-instalments for instalment schedule) to produce a single unified reviewer package containing every worksheet, every form, every brief section, all cross-skill reconciliations, and the final action list with payment instructions, filing instructions, and next-year planning. This is the capstone skill that runs last and produces the final deliverable. MUST be loaded alongside all Australian content skills listed above. Australian full-year residents only. Sole traders only.

AUty-2025

5 of 6 in the AU workflow: