uk-return-assembly.md421 lines24.4 KB
v1Orchestrator
| 1 | --- |
| 2 | name: uk-return-assembly |
| 3 | description: Final orchestrator skill that assembles the complete UK filing package for UK-resident sole traders. Consumes outputs from all UK content skills (uk-vat-return for VAT100, uk-self-employment-sa103 for trading income, uk-income-tax-sa100 for personal tax, uk-national-insurance for Class 2+4 NIC, uk-student-loan-repayment for student loan, uk-payments-on-account for payments on account) 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 UK content skills listed above. UK full-year residents only. Sole traders only. |
| 4 | version: 0.1 |
| 5 | --- |
| 6 | |
| 7 | # UK 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 | |
| 13 | Specifically: |
| 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 `uk-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 chartered accountant signoff before filing. 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 | |
| 31 | The final capstone skill for UK sole trader returns. Every UK content skill feeds into this one. The output is the complete reviewer package that a chartered accountant can review, sign off on, and deliver to the client along with filing instructions. |
| 32 | |
| 33 | This skill coordinates execution of the content skills, verifies cross-skill consistency, and assembles the final deliverable. |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | ## Section 1 -- Scope |
| 38 | |
| 39 | Produces the complete UK filing package for: |
| 40 | - Full-year UK residents |
| 41 | - Sole traders (self-employed individuals) |
| 42 | - Tax year 2025/26 (6 April 2025 to 5 April 2026) |
| 43 | - Filing SA100 with SA103 (self-employment), VAT100 (if VAT registered), Class 2+4 NIC, student loan repayment (if applicable), payments on account for 2026/27 |
| 44 | |
| 45 | --- |
| 46 | |
| 47 | ## Section 2 -- Execution order and dependency chain |
| 48 | |
| 49 | The skill enforces the following execution order: |
| 50 | |
| 51 | 1. **`uk-vat-return`** -- VAT100 return (if VAT registered) |
| 52 | - Runs first because VAT turnover figures feed into the SA103 |
| 53 | - For standard registration: prepare outstanding quarterly VAT100; verify prior quarters |
| 54 | - For Flat Rate Scheme: apply FRS percentage to gross turnover (including VAT) |
| 55 | - For unregistered: skip. Verify turnover stays under GBP 90,000 rolling 12-month threshold. |
| 56 | - Output: VAT100 box values, input VAT recovered (standard) or FRS saving, turnover (ex-VAT) |
| 57 | |
| 58 | 2. **`uk-self-employment-sa103`** -- SA103 self-employment pages (trading income) |
| 59 | - Depends on VAT output: turnover on SA103 must be ex-VAT for VAT-registered traders |
| 60 | - Covers: turnover (Box 15/16), allowable expenses (Boxes 17-30), net profit (Box 31), capital allowances (Box 34), adjustments |
| 61 | - Cash basis vs accruals: affects timing of income and expense recognition |
| 62 | - Output: SA103 box values, net profit for tax computation, capital allowances schedule |
| 63 | |
| 64 | 3. **`uk-income-tax-sa100`** -- SA100 main return (personal tax computation) |
| 65 | - Depends on SA103: net self-employment profit enters the SA100 as self-employment income |
| 66 | - Depends on P60: employment income and PAYE tax deducted |
| 67 | - Covers: total income, personal allowance (GBP 12,570, tapered above GBP 100,000), tax computation at applicable rates (rUK or Scottish), marriage allowance |
| 68 | - Output: total income, taxable income, income tax liability, tax already paid (PAYE + POA), balancing payment/refund |
| 69 | |
| 70 | 4. **`uk-national-insurance`** -- Class 2 + Class 4 NIC |
| 71 | - Depends on SA103: net self-employment profit feeds Class 4 NIC computation |
| 72 | - Class 2: flat rate GBP 3.45/week (GBP 179.40/year) if profits above Small Profits Threshold (GBP 6,725) -- voluntary below threshold |
| 73 | - Class 4: 6% on profits between GBP 12,570 and GBP 50,270; 2% above GBP 50,270 |
| 74 | - Output: Class 2 amount, Class 4 amount, total NIC due via Self Assessment |
| 75 | |
| 76 | 5. **`uk-student-loan-repayment`** -- Student loan repayment via Self Assessment (if applicable) |
| 77 | - Depends on SA100: total income determines repayment amount |
| 78 | - Plan 1: 9% above GBP 22,015; Plan 2: 9% above GBP 27,295; Plan 4: 9% above GBP 27,660; Plan 5: 9% above GBP 25,000; Postgraduate: 6% above GBP 21,000 |
| 79 | - Deduct repayments already made via PAYE |
| 80 | - **Status check:** uk-student-loan-repayment may be a Q4 stub. If the stub has substantive content, use it. If placeholder, compute using the thresholds above and flag in the reviewer brief. |
| 81 | - Output: total repayment due, amount via PAYE, amount via SA |
| 82 | |
| 83 | 6. **`uk-payments-on-account`** -- Payments on account for 2026/27 |
| 84 | - Depends on SA100: payments on account are based on current year's SA liability |
| 85 | - **Status check:** uk-payments-on-account is currently a Q4 stub. If the stub has substantive content, use it. If placeholder, compute: each POA = 50% of current year SA liability (income tax + Class 4 NIC, excluding PAYE, Class 2, student loan, capital gains tax). Due 31 January 2027 (1st POA) and 31 July 2027 (2nd POA). Flag in the reviewer brief. |
| 86 | - If SA liability < GBP 1,000, or > 80% was collected at source (PAYE), no POA required. |
| 87 | - Output: two POA amounts and dates for 2026/27 |
| 88 | |
| 89 | If 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. |
| 90 | |
| 91 | --- |
| 92 | |
| 93 | ## Section 3 -- Cross-skill reconciliation |
| 94 | |
| 95 | ### Cross-check 1: SA103 net profit = SA100 self-employment income |
| 96 | |
| 97 | | SA103 Output | SA100 Input | Rule | |
| 98 | |-------------|-----------|------| |
| 99 | | SA103 Box 31 (net profit) or Box 32 (net loss) | SA100 self-employment income field | Must match exactly | |
| 100 | | SA103 turnover (Box 15/16) | Must be ex-VAT (if VAT registered) | VAT collected is not turnover on SA103 | |
| 101 | |
| 102 | **If mismatch:** Flag for reviewer. Common causes: timing difference between VAT period and tax year (VAT quarters don't align with 6 Apr-5 Apr), adjustments for private use. |
| 103 | |
| 104 | ### Cross-check 2: SA103 net profit feeds Class 4 NIC computation |
| 105 | |
| 106 | | NIC Input | Source | Rule | |
| 107 | |-----------|--------|------| |
| 108 | | Net self-employment profit | SA103 Box 31 | Class 4 base = net profit | |
| 109 | | Class 4: 6% on GBP 12,570-50,270 | SA103 net profit | Lower profits limit = GBP 12,570, upper profits limit = GBP 50,270 | |
| 110 | | Class 4: 2% above GBP 50,270 | SA103 net profit | No cap | |
| 111 | |
| 112 | **If mismatch:** Verify SA103 net profit figure. If multiple self-employments, combine profits for NIC purposes. |
| 113 | |
| 114 | ### Cross-check 3: Payments on account = 50% of prior year SA balance |
| 115 | |
| 116 | | POA Input | Source | Rule | |
| 117 | |----------|--------|------| |
| 118 | | Prior year total SA liability | Prior year SA302 | Relevant amount = income tax + Class 4 NIC via SA | |
| 119 | | Less: PAYE tax deducted | P60 / prior year SA302 | PAYE deducted from the relevant amount | |
| 120 | | Less: Class 2 NIC | Excluded from POA computation | Class 2 does not count toward POA | |
| 121 | | Less: student loan | Excluded from POA computation | Student loan does not count toward POA | |
| 122 | | Each POA = 50% of (relevant amount - PAYE) | | If result < GBP 1,000 total, no POA required | |
| 123 | |
| 124 | **If mismatch:** Common cause is first year of self-employment (no POA due), or claim to reduce POA (SA303). |
| 125 | |
| 126 | ### Cross-check 4: VAT turnover consistency with SA103 |
| 127 | |
| 128 | | VAT Output | SA103 Input | Rule | |
| 129 | |-----------|-----------|------| |
| 130 | | VAT100 Box 6 (total sales ex-VAT) | SA103 Box 15/16 (turnover) | Should broadly match, adjusted for VAT period vs tax year timing | |
| 131 | | FRS: gross turnover x FRS% = VAT payable | SA103 turnover = gross ex-VAT (not FRS adjusted) | SA103 uses actual turnover, not FRS calculation | |
| 132 | |
| 133 | **If mismatch:** VAT periods (quarters ending Mar/Jun/Sep/Dec) don't perfectly align with the tax year (6 Apr-5 Apr). Small timing differences are expected. Large differences need investigation. |
| 134 | |
| 135 | ### Cross-check 5: Student loan computation consistent with total income |
| 136 | |
| 137 | | Student Loan Input | Source | Rule | |
| 138 | |-------------------|--------|------| |
| 139 | | Total income from SA100 | SA100 total income field | Repayment based on total income minus threshold | |
| 140 | | Repayments via PAYE | P60 student loan deductions | Deducted from total repayment due | |
| 141 | | Net repayment via SA | Total - PAYE deductions | Cannot be negative (no refund of SL via SA) | |
| 142 | |
| 143 | **If no student loan:** This cross-check does not apply. Skip. |
| 144 | |
| 145 | --- |
| 146 | |
| 147 | ## Section 4 -- Final reviewer package contents |
| 148 | |
| 149 | ### Documents |
| 150 | |
| 151 | 1. **Executive summary** -- one-page overview: filing status, income, tax liability, VAT position, NIC, student loan, payments on account, balancing payment/refund |
| 152 | 2. **VAT100 worksheet** (if VAT registered) -- box-by-box with formulas |
| 153 | 3. **SA103 worksheet** -- self-employment pages Box 15 through Box 52 with formulas and supporting schedules |
| 154 | 4. **SA100 computation** -- total income, personal allowance, taxable income, tax at applicable rates, NIC, student loan, less PAYE/POA, balancing payment |
| 155 | 5. **Capital allowances schedule** -- asset register with cost, date, AIA/WDA, annual allowance, WDV |
| 156 | 6. **NIC computation** -- Class 2 + Class 4 breakdown |
| 157 | 7. **Student loan computation** (if applicable) -- plan, threshold, repayment due, PAYE offset |
| 158 | 8. **Payments on account schedule** -- 2026/27 two-instalment calculation |
| 159 | 9. **Cross-skill reconciliation summary** -- all five cross-checks with pass/fail and notes |
| 160 | 10. **Reviewer brief** -- comprehensive narrative with positions, citations, flags, self-check results |
| 161 | 11. **Client action list** -- what the client needs to do, with dates and amounts |
| 162 | |
| 163 | ### Reviewer brief contents |
| 164 | |
| 165 | ```markdown |
| 166 | # Complete Return Package: [Client Name] -- Tax Year 2025/26 |
| 167 | |
| 168 | ## Executive Summary |
| 169 | - Filing status: [Single / Married / Civil partner] |
| 170 | - Residence: UK (full-year) |
| 171 | - Scottish taxpayer: [Yes / No] |
| 172 | - Business: Sole trader |
| 173 | - VAT status: Standard / Flat Rate Scheme / Unregistered |
| 174 | - Accounting basis: Cash / Accruals |
| 175 | - VAT position (Q4 or annual): GBP X due / GBP X refund |
| 176 | - SA103 net profit (Box 31): GBP X |
| 177 | - SA100 total income: GBP X |
| 178 | - Personal allowance: GBP X |
| 179 | - Income tax liability: GBP X |
| 180 | - Class 2 NIC: GBP X |
| 181 | - Class 4 NIC: GBP X |
| 182 | - Student loan repayment via SA: GBP X |
| 183 | - Total SA liability: GBP X |
| 184 | - Tax already paid (PAYE + POA): GBP X |
| 185 | - Balancing payment / refund: GBP X |
| 186 | - 2026/27 payments on account: GBP X each (x2) |
| 187 | |
| 188 | ## VAT Return |
| 189 | [Content from uk-vat-return output] |
| 190 | - Registration type and period |
| 191 | - Output VAT summary (standard rated, zero rated, exempt, outside scope) |
| 192 | - Input VAT summary (reclaimable, blocked) |
| 193 | - FRS computation (if applicable) |
| 194 | - Box-by-box summary |
| 195 | - VAT due / refund |
| 196 | |
| 197 | ## Self-Employment (SA103) |
| 198 | [Content from uk-self-employment-sa103 output] |
| 199 | - Box 15/16: Turnover breakdown by client |
| 200 | - Box 17-30: Allowable expenses schedule |
| 201 | - Box 31: Net profit |
| 202 | - Box 34: Capital allowances (AIA, WDA, balancing charges) |
| 203 | - Cash basis adjustments (if applicable) |
| 204 | - Simplified expenses used (if applicable) |
| 205 | |
| 206 | ## Income Tax (SA100) |
| 207 | [Content from uk-income-tax-sa100 output] |
| 208 | - Self-employment income (from SA103) |
| 209 | - Employment income (from P60, if any) |
| 210 | - Other income (interest, dividends, rental) |
| 211 | - Total income |
| 212 | - Personal allowance (GBP 12,570, tapered if income > GBP 100,000) |
| 213 | - Taxable income |
| 214 | - Tax at rUK or Scottish rates |
| 215 | - Marriage allowance (if applicable) |
| 216 | - Tax already deducted (PAYE) |
| 217 | - Net tax liability |
| 218 | |
| 219 | ## National Insurance |
| 220 | [Content from uk-national-insurance output] |
| 221 | - Class 2: GBP 3.45/week, GBP 179.40/year (if profits > GBP 6,725) |
| 222 | - Class 4: 6% on GBP 12,570-50,270 = GBP X |
| 223 | - Class 4: 2% above GBP 50,270 = GBP X |
| 224 | - Total NIC via Self Assessment: GBP X |
| 225 | - Class 1 already paid via PAYE (informational): GBP X |
| 226 | |
| 227 | ## Student Loan (if applicable) |
| 228 | [Content from uk-student-loan-repayment output, or computed if stub] |
| 229 | - Plan type: [Plan 1/2/4/5/Postgraduate] |
| 230 | - Repayment threshold: GBP X |
| 231 | - Total repayment due: GBP X |
| 232 | - Less: repaid via PAYE: GBP X |
| 233 | - Net repayment via SA: GBP X |
| 234 | |
| 235 | ## Payments on Account (2026/27) |
| 236 | [Content from uk-payments-on-account output, or computed if stub] |
| 237 | - Based on 2025/26 SA liability (income tax + Class 4 NIC, less PAYE) |
| 238 | - 1st POA: 31 January 2027 -- GBP X (50%) |
| 239 | - 2nd POA: 31 July 2027 -- GBP X (50%) |
| 240 | - POA not required if total SA liability < GBP 1,000 or > 80% deducted at source |
| 241 | |
| 242 | ## Cross-skill Reconciliation |
| 243 | - SA103 net profit vs SA100 self-employment income: [pass/fail] |
| 244 | - SA103 net profit vs Class 4 NIC base: [pass/fail] |
| 245 | - POA vs prior year SA liability: [pass/fail] |
| 246 | - VAT turnover vs SA103 turnover: [pass/fail] |
| 247 | - Student loan vs total income: [pass/fail] (or N/A) |
| 248 | |
| 249 | ## Reviewer Attention Flags |
| 250 | [Aggregated from all upstream skills] |
| 251 | - T2 items requiring chartered accountant confirmation |
| 252 | - Mixed-use expense percentages (vehicle, phone, broadband) |
| 253 | - Use of home claim (simplified or actual) |
| 254 | - Capital allowances: AIA vs WDA vs small pools |
| 255 | - Cash basis appropriateness (turnover under GBP 150,000?) |
| 256 | - Simplified expenses elections |
| 257 | - Scottish taxpayer determination |
| 258 | - Personal allowance taper (if total income approaches GBP 100,000) |
| 259 | - Marriage allowance eligibility |
| 260 | - VAT registration threshold monitoring (approaching GBP 90,000) |
| 261 | - Student loan plan type confirmation |
| 262 | - CIS deductions (if Construction Industry Scheme applies) |
| 263 | |
| 264 | ## Positions Taken |
| 265 | [List with legislation citations] |
| 266 | - e.g., "Use of home simplified rate GBP 26/month (101+ hours) -- ITTOIA 2005 s94H" |
| 267 | - e.g., "Motor vehicle simplified expenses 45p/mile x 8,000 miles = GBP 3,600 -- ITTOIA 2005 s94D" |
| 268 | - e.g., "MacBook Pro GBP 1,800 claimed under AIA -- CAA 2001 s51A" |
| 269 | - e.g., "Cash basis elected -- ITTOIA 2005 s25A, turnover under GBP 150,000" |
| 270 | - e.g., "Class 2 NIC GBP 179.40 -- SSCBA 1992 s11(2)" |
| 271 | - e.g., "Class 4 NIC 6%/2% -- SSCBA 1992 s15" |
| 272 | - e.g., "Student loan Plan 2 repayment 9% above GBP 27,295 -- Education (Student Loans) (Repayment) Regulations 2009" |
| 273 | |
| 274 | ## Planning Notes for 2026/27 |
| 275 | - Payments on account schedule (two instalments with amounts and dates) |
| 276 | - VAT threshold monitoring (if approaching GBP 90,000) |
| 277 | - Capital allowances pool WDV carried forward |
| 278 | - Cash basis threshold monitoring (if approaching GBP 150,000) |
| 279 | - Any legislative changes affecting 2026/27 (NIC rate changes, threshold changes) |
| 280 | - Class 2 NIC voluntary payment consideration (if below Small Profits Threshold) |
| 281 | |
| 282 | ## Client Action List |
| 283 | |
| 284 | ### Immediate (before 31 January 2027 -- SA filing and payment deadline): |
| 285 | 1. Review this return package with your chartered accountant |
| 286 | 2. File SA100 + SA103 online via HMRC Self Assessment portal |
| 287 | 3. Pay balancing payment of GBP X to HMRC |
| 288 | 4. Pay 1st payment on account 2026/27 of GBP X (same deadline) |
| 289 | 5. File outstanding Q4 VAT return (if applicable) |
| 290 | |
| 291 | ### Before 31 July 2027: |
| 292 | 1. Pay 2nd payment on account 2026/27 of GBP X |
| 293 | |
| 294 | ### VAT filing calendar (if VAT registered -- quarterly): |
| 295 | - Q1 2026/27 (Apr-Jun): file and pay by [date -- 1 month 7 days after quarter end] |
| 296 | - Q2 2026/27 (Jul-Sep): file and pay by [date] |
| 297 | - Q3 2026/27 (Oct-Dec): file and pay by [date] |
| 298 | - Q4 2026/27 (Jan-Mar): file and pay by [date] |
| 299 | |
| 300 | ### If claim to reduce POA (SA303): |
| 301 | - If you expect 2026/27 income to be materially lower, you can apply to reduce POA via form SA303. Discuss with your accountant -- penalties apply if you reduce too much. |
| 302 | |
| 303 | ### Ongoing: |
| 304 | 1. Issue VAT-compliant invoices for all sales (if VAT registered) |
| 305 | 2. Retain all receipts and records (5 years from 31 January following the tax year) |
| 306 | 3. Maintain mileage log if claiming simplified vehicle expenses |
| 307 | 4. Track capital assets for capital allowances pool |
| 308 | 5. Monitor turnover for VAT registration threshold (GBP 90,000 rolling 12 months) |
| 309 | 6. File VAT returns quarterly via Making Tax Digital (MTD) |
| 310 | 7. Prepare for MTD for Income Tax Self Assessment (ITSA) -- mandatory from April 2026 for businesses with turnover > GBP 50,000 |
| 311 | ``` |
| 312 | |
| 313 | --- |
| 314 | |
| 315 | ## Section 5 -- Refusals |
| 316 | |
| 317 | **R-UK-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. |
| 318 | |
| 319 | **R-UK-2 -- Upstream self-check failed.** Name the specific check and note it in the reviewer brief. Continue. |
| 320 | |
| 321 | **R-UK-3 -- Cross-skill reconciliation failed.** Name the specific reconciliation and describe the discrepancy. Flag for reviewer but continue. |
| 322 | |
| 323 | **R-UK-4 -- Intake incomplete.** Specific missing intake items prevent computation. List what is missing and ask the user for the specific data point. |
| 324 | |
| 325 | **R-UK-5 -- Out-of-scope item discovered during assembly.** E.g., rental income requiring SA105, capital gains requiring SA108, foreign income requiring SA106. Flag and exclude from computation. |
| 326 | |
| 327 | --- |
| 328 | |
| 329 | ## Section 6 -- Self-checks |
| 330 | |
| 331 | **Check UK1 -- All upstream skills executed.** uk-vat-return (if VAT registered), uk-self-employment-sa103, uk-income-tax-sa100, uk-national-insurance all produced output. uk-student-loan-repayment produced output or was computed or was skipped (no loan). uk-payments-on-account produced output or was computed from SA liability. |
| 332 | |
| 333 | **Check UK2 -- SA103 net profit matches SA100 self-employment income.** Exact match required. |
| 334 | |
| 335 | **Check UK3 -- SA103 net profit feeds Class 4 NIC.** Class 4 computed on correct profit figure. |
| 336 | |
| 337 | **Check UK4 -- Payments on account correctly computed.** Each POA = 50% of (income tax + Class 4 NIC - PAYE). Exclusions: Class 2, student loan, CGT. |
| 338 | |
| 339 | **Check UK5 -- VAT treatment correct for registered traders.** Output VAT excluded from SA103 turnover; reclaimable input VAT excluded from SA103 expenses. |
| 340 | |
| 341 | **Check UK6 -- VAT treatment correct for unregistered traders.** No VAT separation needed; gross amounts used throughout. |
| 342 | |
| 343 | **Check UK7 -- Capital allowances correctly applied.** AIA on qualifying items (GBP 1,000,000 limit); WDA at 18% main pool / 6% special rate; small pools written off if WDV < GBP 1,000. |
| 344 | |
| 345 | **Check UK8 -- Personal allowance correctly applied.** GBP 12,570 standard; tapered by GBP 1 for every GBP 2 above GBP 100,000; zero above GBP 125,140. |
| 346 | |
| 347 | **Check UK9 -- Correct tax rate table applied.** Scottish rates if Scottish taxpayer; rUK rates otherwise. |
| 348 | |
| 349 | **Check UK10 -- Filing calendar is complete.** All deadlines for VAT, SA, NIC, and POA are listed with specific dates and amounts. |
| 350 | |
| 351 | **Check UK11 -- Class 2 NIC correctly determined.** Due if profits > Small Profits Threshold (GBP 6,725). Voluntary if below. |
| 352 | |
| 353 | **Check UK12 -- Reviewer brief contains legislation citations.** Every position taken references the specific Act and section. |
| 354 | |
| 355 | **Check UK13 -- Student loan plan type confirmed and correct threshold applied.** Plan 1/2/4/5/Postgraduate each have different thresholds. |
| 356 | |
| 357 | **Check UK14 -- Cash basis vs accruals consistently applied.** If cash basis elected, no accruals adjustments appear in SA103. If accruals, debtors/creditors adjustments are present. |
| 358 | |
| 359 | --- |
| 360 | |
| 361 | ## Section 7 -- Output files |
| 362 | |
| 363 | The final output is **three files**: |
| 364 | |
| 365 | 1. **`[client_slug]_2025-26_uk_master.xlsx`** -- Single master workbook containing every worksheet and form. Sheets include: Cover, VAT100 (quarterly, if applicable), SA103 (self-employment), SA100 (tax computation), Capital Allowances, Expense Detail, NIC Computation, Student Loan (if applicable), Payments on Account 2026/27, Cross-Check Summary. Use live formulas where possible -- e.g., SA100 self-employment income references the SA103 net profit cell; Class 4 NIC references the SA103 sheet; POA references the SA100 liability. Verify no `#REF!` errors. Verify computed values match the computation model within GBP 1 before shipping. |
| 366 | |
| 367 | 2. **`reviewer_brief.md`** -- Single markdown file covering all sections from Section 4 above: executive summary, VAT, SA103, SA100, NIC, student loan, POA, cross-skill reconciliation, flags, positions, planning notes. |
| 368 | |
| 369 | 3. **`client_action_list.md`** -- Single markdown file with step-by-step actions: immediate filings and payments, POA schedule, quarterly VAT calendar for 2026/27, ongoing compliance reminders. |
| 370 | |
| 371 | **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. |
| 372 | |
| 373 | **All files are placed in `/mnt/user-data/outputs/` and presented to the user via the `present_files` tool at the end.** |
| 374 | |
| 375 | --- |
| 376 | |
| 377 | ## Section 8 -- Cross-skill references |
| 378 | |
| 379 | **Inputs:** |
| 380 | - `uk-freelance-intake` -- structured intake package (JSON) |
| 381 | - `uk-vat-return` -- VAT100 box values and classification output (if VAT registered) |
| 382 | - `uk-self-employment-sa103` -- SA103 box values and computation output |
| 383 | - `uk-income-tax-sa100` -- SA100 computation output |
| 384 | - `uk-national-insurance` -- Class 2 + Class 4 NIC output |
| 385 | - `uk-student-loan-repayment` -- Student loan computation output (or fallback, or N/A) |
| 386 | - `uk-payments-on-account` -- POA schedule (or fallback computation) |
| 387 | |
| 388 | **Outputs:** The final reviewer package. No downstream skill. |
| 389 | |
| 390 | --- |
| 391 | |
| 392 | ## Section 9 -- Known gaps |
| 393 | |
| 394 | 1. PDF form filling is not automated. The reviewer uses the worksheets to file online via HMRC Self Assessment portal. |
| 395 | 2. E-filing is handled by the reviewer via HMRC portal, not by this skill. |
| 396 | 3. Payment execution is the client's responsibility; the skill only provides instructions and amounts. |
| 397 | 4. SA102 (employment supplement) is partially supported -- employment income from P60 is included in SA100, but detailed SA102 boxes (benefits in kind, expenses) are not fully automated. Flag for chartered accountant. |
| 398 | 5. Multi-year capital allowances tracking assumes the prior year pool balance is provided. If not, only current-year acquisitions are depreciated. |
| 399 | 6. uk-student-loan-repayment is a Q4 stub. Until fleshed out, student loan is computed using the thresholds in Section 2 step 5. Deterministic per the Education (Student Loans) (Repayment) Regulations 2009. |
| 400 | 7. uk-payments-on-account is a Q4 stub. Until fleshed out, POA is computed as 50% of SA liability. Deterministic per TMA 1970 s59A. |
| 401 | 8. Foreign source income is out of scope (no SA106 / DTA relief). |
| 402 | 9. Rental income (SA105) is out of scope. |
| 403 | 10. Capital gains (SA108) are out of scope. |
| 404 | 11. High Income Child Benefit Charge is not automatically computed -- flagged if income exceeds GBP 60,000. |
| 405 | 12. The package is complete only for the 2025/26 tax year; 2026/27 appears only as prospective planning. |
| 406 | 13. Making Tax Digital for ITSA (mandatory from April 2026 for turnover > GBP 50,000) may change quarterly reporting requirements -- flagged in planning notes. |
| 407 | |
| 408 | ### Change log |
| 409 | - **v0.1 (April 2026):** Initial draft. Modelled on mt-return-assembly v0.1 adapted for UK jurisdiction with six content skills (VAT100, SA103, SA100, NIC, student loan, payments on account). |
| 410 | |
| 411 | ## End of skill |
| 412 | |
| 413 | |
| 414 | --- |
| 415 | |
| 416 | ## Disclaimer |
| 417 | |
| 418 | 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 chartered accountant, ACCA member, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon. |
| 419 | |
| 420 | 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. |
| 421 |
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/36
About
Final orchestrator skill that assembles the complete UK filing package for UK-resident sole traders. Consumes outputs from all UK content skills (uk-vat-return for VAT100, uk-self-employment-sa103 for trading income, uk-income-tax-sa100 for personal tax, uk-national-insurance for Class 2+4 NIC, uk-student-loan-repayment for student loan, uk-payments-on-account for payments on account) 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 UK content skills listed above. UK full-year residents only. Sole traders only.
GBty-2025