Guide · Agent skill
How to use the International Expansion Planner agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The International Expansion Planner is an agent skill for lawyers and operations teams preparing to hire their first employees in a new country. It does not run on its own; it loads when the expansion kickoff or update commands run, then asks structured intake questions and organises the work across legal, tax, finance and HR. After this guide you will know what the skill does, how to install it, how to trigger it and what it will and will not give you.
Quick start
- 1Download and unzip the skill. Download the ZIP from this page and unzip it so that SKILL.md is available to Claude.
- 2Choose the install location. Place the unzipped folder in ~/.claude/skills/ for personal use, in a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 3Set up the plugin configuration. Make sure CLAUDE.md files exist in ~/.claude/plugins/config/claude-for-legal/employment-legal/ with your jurisdictional footprint and escalation table.
- 4Run the kickoff command. Run /expansion-kickoff when you begin planning a new country. The skill will ask its intake questions as one block.
- 5Answer the intake questions. Give the country, roles, planned headcount, start timing, EOR or entity status, and sponsor. Leave gaps where you do not know; they feed the plan.
- 6Use the framing and questions. Take the EOR vs. entity framing, PE flag and drafted questions to your CFO, tax counsel, payroll and HR.
- 7Brief outside counsel and keep the tracker current. Send the outside-counsel briefing request and run /expansion-update in later sessions to keep the gap tracker moving.
What the International Expansion skill makes the agent do
The skill is a reference framework for planning international hiring. Once loaded, the agent asks a single block of intake questions covering the country, roles, planned headcount in the next 12 months, start timing, existing legal entity or EOR use, tax and finance involvement, outside counsel, and the executive sponsor.
From those answers it frames the choice between using an Employer of Record (EOR) and setting up a legal entity, without making the decision itself. It flags permanent establishment (PE) risk for sales, business development, account management and any role that can negotiate or sign contracts, and routes that to tax counsel. It drafts specific questions for finance, tax, HR and outside counsel, produces a briefing request for outside counsel and keeps a persistent gap tracker across sessions.
- Assumes the expansion is already decided; it is not a 'should we expand?' tool.
- Contains no country-specific employment law. Each country goes to an outside-counsel briefing.
Install the skill from the ZIP or the Claude apps
Download the ZIP for this skill from this page and unzip it. The skill's files include SKILL.md. You can put the skill in one of two locations: your personal skills folder at ~/.claude/skills/, or a project's .claude/skills/ folder if you want it available only within that project.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
~/.claude/skills/Set up the claude-for-legal configuration it expects
The skill reads context from a claude-for-legal plugin configuration. It expects CLAUDE.md files in ~/.claude/plugins/config/claude-for-legal/employment-legal/. The skill reads the practice-level CLAUDE.md for the jurisdictional footprint, escalation table and any existing expansion notes, and the output header from its Outputs section.
Matter tracking is optional. If your practice-level CLAUDE.md has matter workspaces enabled, the skill will ask which matter the work is for and write outputs to a matter folder under the same employment-legal directory. If matter workspaces are off, which is the default for in-house users, the skill uses practice-level context only.
~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.mdTrigger the skill with the expansion commands
You do not invoke this skill directly, because its metadata marks it as not user-invocable. It loads when the expansion kickoff or update commands run. The source names /expansion-kickoff and /expansion-update as those commands. Start with the kickoff command when planning a new country and use the update command when returning to an existing expansion.
The skill's intake step asks you to answer in one block and waits for your responses before building the plan. Answer what you can; the source notes that gaps in the answers are themselves useful data.
- Start a new country: run /expansion-kickoff
- Return to an existing expansion: run /expansion-update
/expansion-kickoffWork through the outputs: framing, questions and the gap tracker
The EOR vs. entity framing is a structured table of factors such as headcount in 12 months, timeline to first hire, strategic commitment, cost sensitivity, control needs and IP sensitivity. Specific break-even points, markups, setup costs and timelines are not hardcoded; the skill routes them to tax, finance and the EOR provider.
Each function gets an explicit set of questions to ask. Tax counsel is required before the first hire. Finance and payroll are required before the first paycheck. HR and Total Rewards are required before an offer is made. Outside counsel is required and should not be skipped. The gap tracker records open items so the project continues across sessions.
- Use the PE risk flag as a prompt for tax counsel, not a conclusion.
- Send the outside-counsel briefing request to counsel who knows the country.
- Review the gap tracker at each /expansion-update.
Safety notes: scripts and network access
According to the skill's listing, it runs no scripts and uses no network access. It is a set of instructions in SKILL.md that shape how the agent plans and writes. Outputs are written to your matter folder only when matter tracking is enabled. The skill states it reads another matter's files only if cross-matter context is switched on.
Treat its outputs as planning material. It does not provide current employment rules for any country, so anything involving legal requirements must be confirmed by outside counsel.
- No scripts are run by the skill.
- No network use is listed for the skill.
- Cross-matter reads happen only when that setting is on.
What people use it for
- A scaleup's counsel preparing a first engineering hire in a new country and needing a consistent checklist.
- An operations lead coordinating legal, tax and payroll for a sales hire where PE risk must be assessed before the start date.
- A finance lead comparing an EOR with a local entity for a small test-the-market team of one or two hires.
- Preparing a briefing request so outside employment counsel can cover the local framework for a specific role and headcount.
Frequently asked questions
How do I install the International Expansion skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.
Is the international-expansion skill free?
The source material provided for this guide does not state pricing or licence terms beyond the listed licence, Apache-2.0. Check the licence file included with the repository for its terms.
What are the requirements to run it?
It requires a Claude-compatible agent with the claude-for-legal plugin configuration, meaning CLAUDE.md files in ~/.claude/plugins/config/claude-for-legal/employment-legal/. Matter workspace files are optional and only needed if matter tracking is enabled.
Does the skill tell me the employment law for a country?
No. The skill deliberately contains no country-specific employment law and routes each country to an outside-counsel briefing. Relying on the skill alone could miss legal requirements.
Does it decide between an EOR and setting up an entity?
No. It frames the trade-offs so the CFO and tax counsel can make the decision, and it does not make the choice itself.
How does it compare with other approaches to planning international hiring?
The source does not compare it with other tools. Its stated role is a planning framework that maps the terrain, drafts stakeholder questions, produces an outside-counsel briefing request and keeps a persistent gap tracker. It is not a substitute for local legal advice.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Choose this skill if you are in-house counsel or an operations or finance lead at a scaleup planning a first hire in a new country and want a consistent checklist and outside-counsel briefing. Pick something else, or go straight to local counsel, if you need current country-specific employment rules, a decision on whether to expand, or personal legal advice.
Download the skill