Shared workflow base for cross-border and international personal tax skills, tax year 2026. Holds the residency-map intake, the sequenced-plan output contract (a cross-border answer is an ordered set of steps, not separate country answers), the conservative default for cross-border cases, the AUDIT FLASH POINT marker, the double-tax relief and treaty-bridge convention, and the mandatory hand-off to a licensed accountant. It carries no country rates or topic rules of its own and is loaded alongside a topic skill (for example us-foreign-earned-income-2555, us-foreign-tax-credit-1116 or us-foreign-trust-reporting) and the relevant country skills, after cross-border-tax-router has fixed what to load.
Cross-border tax workflow: the shared method for any case that touches more than one country v1.0
General reference only. This skill is general tax/accounting reference material for AI-assisted workflows. It has not been reviewed for any specific person's facts, documents, elections, deadlines, residency, filing status, or local procedures. Do not rely on it to file, pay, amend, or take a tax position without review by a qualified professional in the relevant jurisdiction.
Scope and who this is for
Tax year 2026. This skill carries no rates, thresholds or amounts, and its method does not change with a tax year. It is the shared method every cross-border case follows: the residence of each person in each country, the source of each item of income, the treaty tie-breaker where two countries both claim a person as resident, relief by credit or by exemption, and the forms that claim the relief and report the facts. The country and topic skills hold the rules and figures. cross-border-tax-router decides which of them to load; this skill decides how they are put together.
It carries no country rule and no topic rule of its own. Those live in the topic skills (for example us-foreign-earned-income-2555, us-foreign-tax-credit-1116, us-fbar-fatca-reporting, us-gilti-fdii-beat, us-form-5471-cfc-information, us-foreign-trust-reporting, us-expatriation-exit-tax) and in each country's own skills (for example us-tax-residency, uk-statutory-residence-test, uk-non-dom, mt-non-dom, ie-non-dom, cy-non-dom, ca-tax-residency, leaving-australia-tax-residency-cgt).
A topic skill needs this method, and this method computes nothing without the topic and country skills. Load all three, in the order cross-border-tax-router fixed. Each country and topic skill states its own tax year.
The output is a working paper for a licensed accountant, never a filed return. Cross-border information returns carry heavy penalties, and many cross-border events cannot be undone once done. The work ends by handing the working paper to a licensed accountant in the lead country before the person acts.
Ask the client first
In which countries were you resident, under each country's own rules, during the year, and on which dates did that change?
Do you have a home available to you in more than one country, and where are your family and main economic ties?
Which passports do you hold, and do you hold or have you ever held a US green card?
Which income, gains or assets arise in which country, and has any country already withheld or charged tax on them?
Do you hold foreign bank, brokerage or pension accounts, or interests in foreign companies, trusts or funds?
Have you already claimed treaty relief or filed a certificate of residence in any country for this year?
The method, step by step
Residence of each person, in each country, under that country's own law. Run each country's domestic test separately. The US treats a non-citizen as resident if they meet the green card test or the substantial presence test for the calendar year, and a person can be both non-resident and resident in the same year, which needs a dual-status return (IRS: determining an individual's tax residency status). The UK looks at each tax year separately under the statutory residence test (HMRC RDR3). Record citizenship too: a US citizen or resident alien is taxed on worldwide income wherever they live (IRS: US citizens and resident aliens abroad). Route the tests themselves to the country skills.
Treaty tie-breaker, where two countries both treat the person as resident. For the US, the residence tests do not override a treaty's definition of residence, so a dual-resident taxpayer can still claim treaty benefits if the treaty contains a tie-breaker rule. A person the tie-breaker treats as resident of the other country is "treated as a nonresident alien in figuring your U.S. income tax", but "For purposes other than figuring your tax, you will be treated as a U.S. resident" (IRS Publication 519). In the UK and US convention the tests run in order: permanent home; if there is a permanent home in both States, the centre of vital interests; if that cannot be determined, or there is no permanent home in either State, habitual abode; then nationality; then mutual agreement between the competent authorities (UK and US double taxation convention, Article 4). Stop at the first test that gives one answer. Read the named treaty for every other pair of countries, since wording differs.
Source of each item of income or gain. For each item, record which country it arises in and whether that country taxes non-residents on it. A UK resident "may be taxed on your foreign income by the UK and by the country where your income is from" (GOV.UK: if you're taxed twice). For a UK resident's capital gain, GOV.UK says the person usually pays tax in the country of residence and is exempt in the country where the gain is made, with no claim usually needed. For a gain on an asset that cannot be taken out of the country, such as land or a house, or that the person is using for business in that country, the person will need to pay tax in both countries and get relief from the UK (same page). The country skill holds each source rule.
Who has the primary right, and how the other country gives relief. For each item taxed by more than one country, name the mechanism. By credit: the US lets a person subject to US tax on foreign-taxed income take either a credit or an itemized deduction for qualifying foreign income taxes (IRS: foreign tax credit); route to us-foreign-tax-credit-1116. By exclusion or exemption: "If you elect to exclude either foreign earned income or foreign housing costs, you cannot take a foreign tax credit for taxes on income you exclude", and "If you do take the credit, one or both of the elections may be considered revoked" (same IRS page); route the exclusion to us-foreign-earned-income-2555 and the credit to us-foreign-tax-credit-1116, and make the choice between them with both loaded. By treaty: the UK and US convention requires the US to allow its residents and citizens a credit for UK income tax, subject to the limitations of US law (Article 24 of the convention linked in step 2). In the UK, Foreign Tax Credit Relief is usually claimed on the tax return, and the relief can be less than the foreign tax paid. Foreign Tax Credit Relief cannot be claimed where the double taxation agreement requires the tax to be claimed back from the source country. Without an agreement, relief is usually still given unless the foreign tax does not correspond to UK Income Tax or Capital Gains Tax (GOV.UK: if you're taxed twice).
Check the saving clause before any treaty benefit for a US citizen or resident. Most US treaties contain a saving clause that preserves the right of the United States to tax its citizens and residents "as if the tax treaty had not come into effect", although "many tax treaties have exceptions to the saving clause" (IRS Publication 519). In the UK and US convention this is Article 1, paragraph 4, with the exceptions in paragraph 5 (convention linked in step 2).
The forms that claim relief and report the facts, in each country. A relief not claimed on the right form is not relief. A dual-resident taxpayer who claims treaty benefits files Form 1040-NR with Form 8833 attached and computes tax as a non-resident alien (IRS Publication 519). Americans abroad get the exclusion and the credit only by filing a US return, and US taxpayers with foreign financial accounts over the reporting threshold must report them on FinCEN Form 114 even when the accounts produce no taxable income (IRS: US citizens and resident aliens abroad). For a UK resident, where income is exempt from foreign tax but taxed in the UK, or where the treaty requires it, relief must be applied for in the source country, with HMRC confirming residence (GOV.UK: if you're taxed twice). List every information return the facts trigger, not only the income forms; the thresholds and deadlines are in the topic skills.
Order the steps and say why. Test residence changes before sales, characterise entities before distributions, and test expatriation before later sales (see Layer B below). A treaty tie-breaker that treats a green card holder as a non-resident alien "can trigger section 877A expatriation tax" in certain instances (IRS Publication 519), so test both together. A country may treat a departing resident as having sold certain types of property at their fair market value on departure, even if they were not sold: Canada calls this a deemed disposition (CRA: leaving Canada).
Hand off the working paper as in "Review status and the mandatory hand-off" below.
The sequenced-plan output contract
A cross-border answer is not a stack of single-country answers. It is an ordered plan. Every cross-border topic skill produces both layers below.
Layer A: Reference layer (the rules). For each country and topic engaged, a faithful, cited statement of the rule (statute, form or treaty article), set out as decision steps an assistant can reason over. Layer A answers "What does each system require, and where is it written?" Every rule cites its source, for example section 911, section 877A, Form 3520, or the treaty article.
Layer B: Executable layer (the sequenced plan). A step-by-step procedure that takes the person's facts and the order of events fixed by cross-border-tax-router, and produces an ordered list of steps. Each step states:
What happens (the event, and when).
Which country taxes it, and on what basis (citizenship, residence, domicile or source), citing the Layer A rule.
How double tax is relieved at that step (credit, exemption or exclusion, treaty relief article, re-sourcing, tie-breaker), citing the article or section.
Which forms the step triggers in each country, with the deadlines from the topic skills.
Why the step sits where it does, and what breaks if it moves.
Rule: every Layer B step references the Layer A rule it carries out. No position without a cited source, and no treaty benefit asserted without the article and the form that claims it.
The double-tax relief and treaty-bridge convention
The most valuable part of a cross-border answer is the bridge: how the systems' taxing rights are reconciled so the same income is not taxed twice without relief. For every item that more than one country taxes, state:
Which country has the primary taxing right and which gives relief.
The mechanism: foreign tax credit, exemption or exclusion, a treaty relief article, treaty re-sourcing of income (in the UK and US convention, Article 24 for a United States citizen who is a resident of the United Kingdom), a residence tie-breaker, or a reduced treaty withholding rate.
The form that actually claims it (for example Form 1116 or Form 8833 in the US, and the exclusion form set out in us-foreign-earned-income-2555; the Self Assessment return in the UK).
The double tax the mechanism leaves in place. In the UK, relief can be smaller than the foreign tax paid, where a smaller amount is set by the double taxation agreement or the income would have been taxed at a lower rate in the UK (GOV.UK: if you're taxed twice). A US person cannot take a credit for tax on income they chose to exclude (IRS: foreign tax credit).
The saving clause caveat. Most US treaties let the US tax its citizens and residents as if the treaty had not come into effect, although many treaties have exceptions (IRS Publication 519). Never assert a treaty benefit for a US citizen or resident without checking the saving clause and its exceptions first.
AUDIT FLASH POINT convention
Mark every position that a tax authority (the IRS, HMRC, the ATO and others) commonly challenges with a bold marker:
AUDIT FLASH POINT: [the judgement at issue, why it is contested, the evidence behind the position taken, and the form or disclosure that supports it.]
These are the positions a reviewing accountant must personally own. List every flash point the case triggers in the reviewer brief. Never bury one.
Typical cross-border flash points: the date residence ended and the day-count evidence; treaty residence tie-breakers; grantor or non-grantor trust characterisation; the choice between exclusion and credit and the tests behind the exclusion; covered expatriate status and exit tax valuations; foreign funds held by a US person; reasonable-cause positions for late information returns; and any position that rests on facts in another country the preparer cannot check.
When facts are incomplete and a position could go either way across a border, take the position that is harder to challenge and leaves a reporting trail, say that you have done so, and name the fact that would change the answer. When unsure:
Assume the broader taxing right applies (for example that US citizenship or residence taxation reaches the item).
Assume the reporting obligation is triggered and the information return is filed, rather than assuming an exemption. An unnecessary information return costs little; a missed one can carry penalties.
Assume the higher-tax characterisation of an entity or instrument until a fact shows otherwise.
Never pick the favourable treatment silently. Aggressive positions (for example a treaty benefit for a US citizen or resident that is not among the exceptions to the saving clause, or a decision not to file) need an explicit, documented instruction and a licensed accountant's sign-off. They are never the default.
Structured intake (the residency map)
If facts needed for Layer B are missing, ask for them in one structured block before computing. Never piecemeal, never by guessing. The map in cross-border-tax-router Step 0 is the intake; restate any gaps here, grouped by the decision they unlock:
To put this in order, these facts are still needed:
1. [Fact], used in [step / rule]
2. [Fact], used in [step / rule]
...
If [fact] is not available, the plan assumes [the broader taxing right / that the reporting
obligation applies] (conservative default) and flags it for your accountant.
Universal self-checks
Before delivering output, check (each topic skill adds its own checks):
Both layers produced, with a cited rule for every step
Residence tested in each country under its own law, and a tie-breaker run where two countries claim the person
Source recorded for every item of income or gain
The answer is an ordered plan, not separate country answers
The order of events stated and justified (what breaks if a step moves)
For every item taxed by more than one country, the relief mechanism and the form that claims it stated
Saving clause checked before any treaty benefit for a US citizen or resident
Every information return the facts trigger listed, not only the income forms. For a US person, take the forms and their tests from the topic skills: FinCEN Form 114 and Form 8938 from us-fbar-fatca-reporting, Forms 3520 and 3520-A from us-foreign-trust-reporting, and Form 5471 from us-form-5471-cfc-information. Interests in foreign partnerships and foreign funds have no topic skill here, so flag them as open items for the licensed accountant.
Every figure traced to a country or topic skill and its official source; none stated from memory
Every triggered AUDIT FLASH POINT listed in the reviewer brief
Conservative default applied and flagged wherever facts were missing
Any uncovered country rule, named treaty article, foreign fund or estate item flagged as an open item, not improvised
The output labelled as an unreviewed working paper, and the hand-off done
Output specification
Deliver, in this order:
Situation map: citizenship, residence in each country, domicile where relevant, and the event, in one block.
The sequenced plan: the ordered Layer B steps (event, who taxes, relief, forms, why it sits there).
Reference trace: the rule, form or treaty article behind each step.
Double-tax bridge summary: per item, the primary right, the relief mechanism, the claiming form, and what is left over.
Information-return checklist: every information return triggered, with the deadlines and penalties taken from the topic skills.
Reviewer brief: the judgements taken, every AUDIT FLASH POINT, the conservative defaults applied, and the open items the licensed accountant must clear.
Hand-off, as below.
Review status and the mandatory hand-off
Every cross-border output is an unreviewed working paper. It is drafted from statutes, forms and treaties, and no licensed accountant has signed the specific plan. Never present it as reviewed by an accountant.
The work must end by handing the working paper to a person. Before the person takes any step that cannot be undone (selling, distributing, giving up residence, giving up citizenship or a green card, filing), tell them plainly: this is a working paper, not advice to act on yet; a licensed accountant in the lead country should review it, and that accountant signs off and, if engaged, files. The lead country is the one with the primary taxing right or the largest exposure: usually where the person is or will be resident, or the US where citizenship taxation dominates. Give the accountant the situation map and the full sequenced plan.
These skills give computational and interpretive guidance on cross-border personal tax. They are not tax or legal advice, not an engagement, and not a filed return. Cross-border outcomes turn on entity, residence and treaty facts and significant judgement, and the order of events often changes the result. Have every output reviewed and signed by a qualified, licensed accountant in each relevant country before acting on it. Penalties on cross-border information returns can be severe; when in doubt, file and ask.
Worked cases
Hypothetical facts, not a real client. A UK resident receives a dividend from a company in another country, which withheld GBP 1,500 of tax at source. The UK skill for this person (not this skill) puts the UK tax on that same dividend at GBP 1,000. The bridge, step 4 and the relief convention above: the UK has the residence right and gives relief by Foreign Tax Credit Relief on the Self Assessment return; the relief cannot exceed the UK tax on the same income, because GOV.UK says relief is less where "the income would have been taxed at a lower rate in the UK" (GOV.UK: if you're taxed twice). The amount left over is not relieved in the UK; whether the source country will refund it under the treaty is a question for the named treaty and its claim form, flagged for the accountant. If the treaty instead requires the tax to be claimed back from the source country, Foreign Tax Credit Relief is not available at all and the case changes.
name: UK Foreign Tax Credit Relief capped at the UK tax on the same income (hypothetical amounts)
inputs:
foreign_tax_withheld: 1500
uk_tax_on_same_income: 1000
steps:
- uk_relief: min(foreign_tax_withheld, uk_tax_on_same_income)
- foreign_tax_not_relieved_in_uk: foreign_tax_withheld - uk_relief
- uk_tax_still_due_on_item: uk_tax_on_same_income - uk_relief
expected:
uk_relief: 1000
foreign_tax_not_relieved_in_uk: 500
uk_tax_still_due_on_item: 0
For a US citizen in the same position, the same bridge runs in us-foreign-tax-credit-1116, after the saving clause check in step 5; if the income were foreign earned income the person had elected to exclude in us-foreign-earned-income-2555, no credit would be allowed for tax on the excluded income.
When to refuse or refer
Refuse to assert a treaty benefit without the article, the saving clause check for a US person, and the form that claims it.
Refuse to state a rate, threshold or deadline from memory. Take it from the country or topic skill, or flag it.
Refer any position that depends on the full text of a named treaty article, or on a mutual agreement between tax authorities.
Refer before the person takes any step that cannot be undone.
Refer foreign funds held by a US person, cross-border estate, gift or inheritance questions, and any country with no skill.
Refer late or missed information returns before anything is filed.
Sources
Source
URL
Read on
IRS, determining an individual's tax residency status. Read for the green card and substantial presence tests and dual-status years.
CRA, leaving Canada (emigrants). Read for the deemed disposition on departure, opened through a rendering service because the site timed out on a direct request.
Not yet confirmed: this skill states no rate or threshold of its own; the worked case uses hypothetical amounts, and the UK tax on the item must come from the UK skill. Treaty text other than the UK and US convention is not read here.
Today's figures and who stands behind this skill
This file is an AI skill (tax rules your AI follows) from OpenAccountants, copied on 2026-11-14. Rates, thresholds and deadlines change. For the current version of this skill, its official sources and the named accountant (if any) who stands behind it, call get_skill with slug cross-border-tax-workflow-base on the OpenAccountants connector (https://www.openaccountants.com/connect), or read https://www.openaccountants.com/skills/cross-border-tax-workflow-base. If neither is available, confirm every figure against the official source pages cited above before relying on it.
1---2name: cross-border-tax-workflow-base3description: "Shared workflow base for cross-border and international personal tax skills, tax year 2026. Holds the residency-map intake, the sequenced-plan output contract (a cross-border answer is an ordered set of steps, not separate country answers), the conservative default for cross-border cases, the AUDIT FLASH POINT marker, the double-tax relief and treaty-bridge convention, and the mandatory hand-off to a licensed accountant. It carries no country rates or topic rules of its own and is loaded alongside a topic skill (for example us-foreign-earned-income-2555, us-foreign-tax-credit-1116 or us-foreign-trust-reporting) and the relevant country skills, after cross-border-tax-router has fixed what to load."4license: "AGPL-3.0-or-later (code) / OpenAccountants Guide License v1.0 (content)"5metadata:6 source: https://skillmd.com/skills/openaccountants/cross-border-tax-workflow-base7 upstream: openaccountants8 openaccountants_url: "https://www.openaccountants.com/skills/cross-border-tax-workflow-base"9 jurisdiction: "GLOBAL"10 tax_year: "2026"11 last_updated: "2026-11-14"12---1314# Cross-border tax workflow: the shared method for any case that touches more than one country v1.01516> **General reference only.** This skill is general tax/accounting reference material for AI-assisted workflows. It has not been reviewed for any specific person's facts, documents, elections, deadlines, residency, filing status, or local procedures. Do not rely on it to file, pay, amend, or take a tax position without review by a qualified professional in the relevant jurisdiction.1718## Scope and who this is for1920Tax year 2026. This skill carries no rates, thresholds or amounts, and its method does not change with a tax year. It is the shared method every cross-border case follows: the residence of each person in each country, the source of each item of income, the treaty tie-breaker where two countries both claim a person as resident, relief by credit or by exemption, and the forms that claim the relief and report the facts. The country and topic skills hold the rules and figures. `cross-border-tax-router` decides which of them to load; this skill decides how they are put together.2122It carries no country rule and no topic rule of its own. Those live in the topic skills (for example `us-foreign-earned-income-2555`, `us-foreign-tax-credit-1116`, `us-fbar-fatca-reporting`, `us-gilti-fdii-beat`, `us-form-5471-cfc-information`, `us-foreign-trust-reporting`, `us-expatriation-exit-tax`) and in each country's own skills (for example `us-tax-residency`, `uk-statutory-residence-test`, `uk-non-dom`, `mt-non-dom`, `ie-non-dom`, `cy-non-dom`, `ca-tax-residency`, `leaving-australia-tax-residency-cgt`).2324A topic skill needs this method, and this method computes nothing without the topic and country skills. Load all three, in the order `cross-border-tax-router` fixed. Each country and topic skill states its own tax year.2526The output is a working paper for a licensed accountant, never a filed return. Cross-border information returns carry heavy penalties, and many cross-border events cannot be undone once done. The work ends by handing the working paper to a licensed accountant in the lead country before the person acts.2728## Ask the client first2930- In which countries were you resident, under each country's own rules, during the year, and on which dates did that change?31- Do you have a home available to you in more than one country, and where are your family and main economic ties?32- Which passports do you hold, and do you hold or have you ever held a US green card?33- Which income, gains or assets arise in which country, and has any country already withheld or charged tax on them?34- Do you hold foreign bank, brokerage or pension accounts, or interests in foreign companies, trusts or funds?35- Have you already claimed treaty relief or filed a certificate of residence in any country for this year?3637## The method, step by step38391. **Residence of each person, in each country, under that country's own law.** Run each country's domestic test separately. The US treats a non-citizen as resident if they meet the green card test or the substantial presence test for the calendar year, and a person can be both non-resident and resident in the same year, which needs a dual-status return ([IRS: determining an individual's tax residency status](https://www.irs.gov/individuals/international-taxpayers/determining-an-individuals-tax-residency-status)). The UK looks at each tax year separately under the statutory residence test ([HMRC RDR3](https://www.gov.uk/government/publications/rdr3-statutory-residence-test-srt/guidance-note-for-statutory-residence-test-srt-rdr3)). Record citizenship too: a US citizen or resident alien is taxed on worldwide income wherever they live ([IRS: US citizens and resident aliens abroad](https://www.irs.gov/individuals/international-taxpayers/us-citizens-and-resident-aliens-abroad)). Route the tests themselves to the country skills.402. **Treaty tie-breaker, where two countries both treat the person as resident.** For the US, the residence tests do not override a treaty's definition of residence, so a dual-resident taxpayer can still claim treaty benefits if the treaty contains a tie-breaker rule. A person the tie-breaker treats as resident of the other country is "treated as a nonresident alien in figuring your U.S. income tax", but "For purposes other than figuring your tax, you will be treated as a U.S. resident" ([IRS Publication 519](https://www.irs.gov/publications/p519)). In the UK and US convention the tests run in order: permanent home; if there is a permanent home in both States, the centre of vital interests; if that cannot be determined, or there is no permanent home in either State, habitual abode; then nationality; then mutual agreement between the competent authorities ([UK and US double taxation convention, Article 4](https://www.gov.uk/government/publications/usa-tax-treaties/2001-uk-usa-double-taxation-convention-as-amended-by-the-2002-protocol-in-force)). Stop at the first test that gives one answer. Read the named treaty for every other pair of countries, since wording differs.413. **Source of each item of income or gain.** For each item, record which country it arises in and whether that country taxes non-residents on it. A UK resident "may be taxed on your foreign income by the UK and by the country where your income is from" ([GOV.UK: if you're taxed twice](https://www.gov.uk/tax-foreign-income/taxed-twice)). For a UK resident's capital gain, GOV.UK says the person usually pays tax in the country of residence and is exempt in the country where the gain is made, with no claim usually needed. For a gain on an asset that cannot be taken out of the country, such as land or a house, or that the person is using for business in that country, the person will need to pay tax in both countries and get relief from the UK (same page). The country skill holds each source rule.424. **Who has the primary right, and how the other country gives relief.** For each item taxed by more than one country, name the mechanism. By credit: the US lets a person subject to US tax on foreign-taxed income take either a credit or an itemized deduction for qualifying foreign income taxes ([IRS: foreign tax credit](https://www.irs.gov/individuals/international-taxpayers/foreign-tax-credit)); route to `us-foreign-tax-credit-1116`. By exclusion or exemption: "If you elect to exclude either foreign earned income or foreign housing costs, you cannot take a foreign tax credit for taxes on income you exclude", and "If you do take the credit, one or both of the elections may be considered revoked" (same IRS page); route the exclusion to `us-foreign-earned-income-2555` and the credit to `us-foreign-tax-credit-1116`, and make the choice between them with both loaded. By treaty: the UK and US convention requires the US to allow its residents and citizens a credit for UK income tax, subject to the limitations of US law (Article 24 of the convention linked in step 2). In the UK, Foreign Tax Credit Relief is usually claimed on the tax return, and the relief can be less than the foreign tax paid. Foreign Tax Credit Relief cannot be claimed where the double taxation agreement requires the tax to be claimed back from the source country. Without an agreement, relief is usually still given unless the foreign tax does not correspond to UK Income Tax or Capital Gains Tax ([GOV.UK: if you're taxed twice](https://www.gov.uk/tax-foreign-income/taxed-twice)).435. **Check the saving clause before any treaty benefit for a US citizen or resident.** Most US treaties contain a saving clause that preserves the right of the United States to tax its citizens and residents "as if the tax treaty had not come into effect", although "many tax treaties have exceptions to the saving clause" ([IRS Publication 519](https://www.irs.gov/publications/p519)). In the UK and US convention this is Article 1, paragraph 4, with the exceptions in paragraph 5 (convention linked in step 2).446. **The forms that claim relief and report the facts, in each country.** A relief not claimed on the right form is not relief. A dual-resident taxpayer who claims treaty benefits files Form 1040-NR with Form 8833 attached and computes tax as a non-resident alien ([IRS Publication 519](https://www.irs.gov/publications/p519)). Americans abroad get the exclusion and the credit only by filing a US return, and US taxpayers with foreign financial accounts over the reporting threshold must report them on FinCEN Form 114 even when the accounts produce no taxable income ([IRS: US citizens and resident aliens abroad](https://www.irs.gov/individuals/international-taxpayers/us-citizens-and-resident-aliens-abroad)). For a UK resident, where income is exempt from foreign tax but taxed in the UK, or where the treaty requires it, relief must be applied for in the source country, with HMRC confirming residence ([GOV.UK: if you're taxed twice](https://www.gov.uk/tax-foreign-income/taxed-twice)). List every information return the facts trigger, not only the income forms; the thresholds and deadlines are in the topic skills.457. **Order the steps and say why.** Test residence changes before sales, characterise entities before distributions, and test expatriation before later sales (see Layer B below). A treaty tie-breaker that treats a green card holder as a non-resident alien "can trigger section 877A expatriation tax" in certain instances ([IRS Publication 519](https://www.irs.gov/publications/p519)), so test both together. A country may treat a departing resident as having sold certain types of property at their fair market value on departure, even if they were not sold: Canada calls this a deemed disposition ([CRA: leaving Canada](https://www.canada.ca/en/revenue-agency/services/tax/international-non-residents/individuals-leaving-entering-canada-non-residents/leaving-canada-emigrants.html)).468. **Hand off** the working paper as in "Review status and the mandatory hand-off" below.4748### The sequenced-plan output contract4950A cross-border answer is not a stack of single-country answers. It is an ordered plan. Every cross-border topic skill produces both layers below.5152**Layer A: Reference layer (the rules).** For each country and topic engaged, a faithful, cited statement of the rule (statute, form or treaty article), set out as decision steps an assistant can reason over. Layer A answers "What does each system require, and where is it written?" Every rule cites its source, for example section 911, section 877A, Form 3520, or the treaty article.5354**Layer B: Executable layer (the sequenced plan).** A step-by-step procedure that takes the person's facts and the order of events fixed by `cross-border-tax-router`, and produces an ordered list of steps. Each step states:55561. What happens (the event, and when).572. Which country taxes it, and on what basis (citizenship, residence, domicile or source), citing the Layer A rule.583. How double tax is relieved at that step (credit, exemption or exclusion, treaty relief article, re-sourcing, tie-breaker), citing the article or section.594. Which forms the step triggers in each country, with the deadlines from the topic skills.605. Why the step sits where it does, and what breaks if it moves.6162Rule: every Layer B step references the Layer A rule it carries out. No position without a cited source, and no treaty benefit asserted without the article and the form that claims it.6364### The double-tax relief and treaty-bridge convention6566The most valuable part of a cross-border answer is the bridge: how the systems' taxing rights are reconciled so the same income is not taxed twice without relief. For every item that more than one country taxes, state:6768- Which country has the primary taxing right and which gives relief.69- The mechanism: foreign tax credit, exemption or exclusion, a treaty relief article, treaty re-sourcing of income (in the UK and US convention, Article 24 for a United States citizen who is a resident of the United Kingdom), a residence tie-breaker, or a reduced treaty withholding rate.70- The form that actually claims it (for example Form 1116 or Form 8833 in the US, and the exclusion form set out in `us-foreign-earned-income-2555`; the Self Assessment return in the UK).71- The double tax the mechanism leaves in place. In the UK, relief can be smaller than the foreign tax paid, where a smaller amount is set by the double taxation agreement or the income would have been taxed at a lower rate in the UK ([GOV.UK: if you're taxed twice](https://www.gov.uk/tax-foreign-income/taxed-twice)). A US person cannot take a credit for tax on income they chose to exclude ([IRS: foreign tax credit](https://www.irs.gov/individuals/international-taxpayers/foreign-tax-credit)).7273The saving clause caveat. Most US treaties let the US tax its citizens and residents as if the treaty had not come into effect, although many treaties have exceptions ([IRS Publication 519](https://www.irs.gov/publications/p519)). Never assert a treaty benefit for a US citizen or resident without checking the saving clause and its exceptions first.7475### AUDIT FLASH POINT convention7677Mark every position that a tax authority (the IRS, HMRC, the ATO and others) commonly challenges with a bold marker:7879> **AUDIT FLASH POINT:** [the judgement at issue, why it is contested, the evidence behind the position taken, and the form or disclosure that supports it.]8081These are the positions a reviewing accountant must personally own. List every flash point the case triggers in the reviewer brief. Never bury one.8283Typical cross-border flash points: the date residence ended and the day-count evidence; treaty residence tie-breakers; grantor or non-grantor trust characterisation; the choice between exclusion and credit and the tests behind the exclusion; covered expatriate status and exit tax valuations; foreign funds held by a US person; reasonable-cause positions for late information returns; and any position that rests on facts in another country the preparer cannot check.8485### Conservative-default principle (cross-border edition)8687When facts are incomplete and a position could go either way across a border, take the position that is harder to challenge and leaves a reporting trail, say that you have done so, and name the fact that would change the answer. When unsure:8889- Assume the broader taxing right applies (for example that US citizenship or residence taxation reaches the item).90- Assume the reporting obligation is triggered and the information return is filed, rather than assuming an exemption. An unnecessary information return costs little; a missed one can carry penalties.91- Assume the higher-tax characterisation of an entity or instrument until a fact shows otherwise.9293Never pick the favourable treatment silently. Aggressive positions (for example a treaty benefit for a US citizen or resident that is not among the exceptions to the saving clause, or a decision not to file) need an explicit, documented instruction and a licensed accountant's sign-off. They are never the default.9495### Structured intake (the residency map)9697If facts needed for Layer B are missing, ask for them in one structured block before computing. Never piecemeal, never by guessing. The map in `cross-border-tax-router` Step 0 is the intake; restate any gaps here, grouped by the decision they unlock:9899~~~100To put this in order, these facts are still needed:101 1. [Fact], used in [step / rule]102 2. [Fact], used in [step / rule]103 ...104If [fact] is not available, the plan assumes [the broader taxing right / that the reporting105obligation applies] (conservative default) and flags it for your accountant.106~~~107108### Universal self-checks109110Before delivering output, check (each topic skill adds its own checks):111112- [ ] Both layers produced, with a cited rule for every step113- [ ] Residence tested in each country under its own law, and a tie-breaker run where two countries claim the person114- [ ] Source recorded for every item of income or gain115- [ ] The answer is an ordered plan, not separate country answers116- [ ] The order of events stated and justified (what breaks if a step moves)117- [ ] For every item taxed by more than one country, the relief mechanism and the form that claims it stated118- [ ] Saving clause checked before any treaty benefit for a US citizen or resident119- [ ] Every information return the facts trigger listed, not only the income forms. For a US person, take the forms and their tests from the topic skills: FinCEN Form 114 and Form 8938 from `us-fbar-fatca-reporting`, Forms 3520 and 3520-A from `us-foreign-trust-reporting`, and Form 5471 from `us-form-5471-cfc-information`. Interests in foreign partnerships and foreign funds have no topic skill here, so flag them as open items for the licensed accountant.120- [ ] Every figure traced to a country or topic skill and its official source; none stated from memory121- [ ] Every triggered AUDIT FLASH POINT listed in the reviewer brief122- [ ] Conservative default applied and flagged wherever facts were missing123- [ ] Any uncovered country rule, named treaty article, foreign fund or estate item flagged as an open item, not improvised124- [ ] The output labelled as an unreviewed working paper, and the hand-off done125126### Output specification127128Deliver, in this order:1291301. Situation map: citizenship, residence in each country, domicile where relevant, and the event, in one block.1312. The sequenced plan: the ordered Layer B steps (event, who taxes, relief, forms, why it sits there).1323. Reference trace: the rule, form or treaty article behind each step.1334. Double-tax bridge summary: per item, the primary right, the relief mechanism, the claiming form, and what is left over.1345. Information-return checklist: every information return triggered, with the deadlines and penalties taken from the topic skills.1356. Reviewer brief: the judgements taken, every AUDIT FLASH POINT, the conservative defaults applied, and the open items the licensed accountant must clear.1367. Hand-off, as below.137138### Review status and the mandatory hand-off139140Every cross-border output is an unreviewed working paper. It is drafted from statutes, forms and treaties, and no licensed accountant has signed the specific plan. Never present it as reviewed by an accountant.141142The work must end by handing the working paper to a person. Before the person takes any step that cannot be undone (selling, distributing, giving up residence, giving up citizenship or a green card, filing), tell them plainly: this is a working paper, not advice to act on yet; a licensed accountant in the lead country should review it, and that accountant signs off and, if engaged, files. The lead country is the one with the primary taxing right or the largest exposure: usually where the person is or will be resident, or the US where citizenship taxation dominates. Give the accountant the situation map and the full sequenced plan.143144These skills give computational and interpretive guidance on cross-border personal tax. They are not tax or legal advice, not an engagement, and not a filed return. Cross-border outcomes turn on entity, residence and treaty facts and significant judgement, and the order of events often changes the result. Have every output reviewed and signed by a qualified, licensed accountant in each relevant country before acting on it. Penalties on cross-border information returns can be severe; when in doubt, file and ask.145146## Worked cases147148Hypothetical facts, not a real client. A UK resident receives a dividend from a company in another country, which withheld GBP 1,500 of tax at source. The UK skill for this person (not this skill) puts the UK tax on that same dividend at GBP 1,000. The bridge, step 4 and the relief convention above: the UK has the residence right and gives relief by Foreign Tax Credit Relief on the Self Assessment return; the relief cannot exceed the UK tax on the same income, because GOV.UK says relief is less where "the income would have been taxed at a lower rate in the UK" ([GOV.UK: if you're taxed twice](https://www.gov.uk/tax-foreign-income/taxed-twice)). The amount left over is not relieved in the UK; whether the source country will refund it under the treaty is a question for the named treaty and its claim form, flagged for the accountant. If the treaty instead requires the tax to be claimed back from the source country, Foreign Tax Credit Relief is not available at all and the case changes.149150```oa-check151name: UK Foreign Tax Credit Relief capped at the UK tax on the same income (hypothetical amounts)152inputs:153 foreign_tax_withheld: 1500154 uk_tax_on_same_income: 1000155steps:156 - uk_relief: min(foreign_tax_withheld, uk_tax_on_same_income)157 - foreign_tax_not_relieved_in_uk: foreign_tax_withheld - uk_relief158 - uk_tax_still_due_on_item: uk_tax_on_same_income - uk_relief159expected:160 uk_relief: 1000161 foreign_tax_not_relieved_in_uk: 500162 uk_tax_still_due_on_item: 0163```164165For a US citizen in the same position, the same bridge runs in `us-foreign-tax-credit-1116`, after the saving clause check in step 5; if the income were foreign earned income the person had elected to exclude in `us-foreign-earned-income-2555`, no credit would be allowed for tax on the excluded income.166167## When to refuse or refer168169- Refuse to assert a treaty benefit without the article, the saving clause check for a US person, and the form that claims it.170- Refuse to state a rate, threshold or deadline from memory. Take it from the country or topic skill, or flag it.171- Refer any position that depends on the full text of a named treaty article, or on a mutual agreement between tax authorities.172- Refer before the person takes any step that cannot be undone.173- Refer foreign funds held by a US person, cross-border estate, gift or inheritance questions, and any country with no skill.174- Refer late or missed information returns before anything is filed.175176## Sources177178| Source | URL | Read on |179| --- | --- | --- |180| IRS, determining an individual's tax residency status. Read for the green card and substantial presence tests and dual-status years. | https://www.irs.gov/individuals/international-taxpayers/determining-an-individuals-tax-residency-status | 2026-11-14 |181| IRS, US citizens and resident aliens abroad. Read for worldwide taxation and the FinCEN Form 114 reporting duty. | https://www.irs.gov/individuals/international-taxpayers/us-citizens-and-resident-aliens-abroad | 2026-11-14 |182| IRS, foreign tax credit. Read for credit or itemized deduction, no credit on excluded income, and revocation of the exclusion elections. | https://www.irs.gov/individuals/international-taxpayers/foreign-tax-credit | 2026-11-14 |183| IRS Publication 519, US tax guide for aliens. Read for the tiebreaker rule, Form 1040-NR with Form 8833, the saving clause and the section 877A note. | https://www.irs.gov/publications/p519 | 2026-11-14 |184| UK and US double taxation convention, as amended by the 2002 protocol. Read for art. 1(4) and (5), art. 4(4) and art. 24. | https://www.gov.uk/government/publications/usa-tax-treaties/2001-uk-usa-double-taxation-convention-as-amended-by-the-2002-protocol-in-force | 2026-11-14 |185| HMRC RDR3, statutory residence test guidance. Read for the tax-year basis of the test. | https://www.gov.uk/government/publications/rdr3-statutory-residence-test-srt/guidance-note-for-statutory-residence-test-srt-rdr3 | 2026-11-14 |186| GOV.UK, if you're taxed twice. Read for relief in the source country, Foreign Tax Credit Relief and its limits, and capital gains. | https://www.gov.uk/tax-foreign-income/taxed-twice | 2026-11-14 |187| CRA, leaving Canada (emigrants). Read for the deemed disposition on departure, opened through a rendering service because the site timed out on a direct request. | https://www.canada.ca/en/revenue-agency/services/tax/international-non-residents/individuals-leaving-entering-canada-non-residents/leaving-canada-emigrants.html | 2026-11-14 |188189Not yet confirmed: this skill states no rate or threshold of its own; the worked case uses hypothetical amounts, and the UK tax on the item must come from the UK skill. Treaty text other than the UK and US convention is not read here.190191## Today's figures and who stands behind this skill192193This file is an AI skill (tax rules your AI follows) from OpenAccountants, copied on 2026-11-14. Rates, thresholds and deadlines change. For the current version of this skill, its official sources and the named accountant (if any) who stands behind it, call `get_skill` with slug `cross-border-tax-workflow-base` on the OpenAccountants connector (https://www.openaccountants.com/connect), or read https://www.openaccountants.com/skills/cross-border-tax-workflow-base. If neither is available, confirm every figure against the official source pages cited above before relying on it.
Run npx get-skill add openaccountants/cross-border-tax-workflow-base in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Shared workflow base for cross-border and international personal tax skills, tax year 2026. Holds the residency-map intake, the sequenced-plan output contract (a cross-border answer is an ordered set of steps, not separate country answers), the conservative default for cross-border cases, the AUDIT FLASH POINT marker, the double-tax relief and treaty-bridge convention, and the mandatory hand-off to a licensed accountant. It carries no country rates or topic rules of its own and is loaded alongside a topic skill (for example us-foreign-earned-income-2555, us-foreign-tax-credit-1116 or us-foreign-trust-reporting) and the relevant country skills, after cross-border-tax-router has fixed what to load. It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under AGPL-3.
openaccountants (@openaccountants) published this skill. Their other Agent Skills are listed on their SkillMD profile.