Cross-border Tax Compliance Navigator
Overview
Cross-border Tax Compliance Navigator (International tax obligations and VAT/GST compliance framework). This skill provides a structured framework for planning and implementing cross-border tax compliance strategies in international e-commerce contexts. It is designed for businesses expanding into new markets and needing guidance on tax-related considerations.
The framework covers market assessment, regulatory compliance, implementation planning, and ongoing management. It focuses on practical, actionable guidance that businesses can adapt to their specific circumstances.
Trigger Keywords
- "cross-border tax compliance"
- "international VAT/GST framework"
- "tax obligations for e-commerce"
- "multi-jurisdiction tax requirements"
- "VAT registration thresholds"
- "cross-border tax planning"
Workflow
- Input Analysis: Parse user input to extract target markets, business parameters, and specific tax requirements
- Tax Obligation Mapping: Generate jurisdiction-specific tax obligations based on extracted parameters
- Compliance Planning: Create a structured compliance implementation plan with phases and activities
- Risk Assessment: Identify high, medium, and low-risk scenarios with mitigation strategies
- Output Delivery: Return a comprehensive JSON response with analysis, recommendations, and disclaimers
Output Modules
Tax Obligation Mapping
- Jurisdiction-specific VAT/GST registration requirements and thresholds
- Tax rate structures including standard, reduced, and zero rates
- Filing frequency, deadlines, and electronic filing requirements
- Special rules including distance selling, one-stop-shop, and reverse charge
- Registration processes and responsible authorities
Compliance Implementation Plan
- Phase 1 Assessment: Determine requirements per target market
- Phase 2 Registration: Prepare documentation and submit applications
- Phase 3 Systems: Implement tax calculation and collection systems
- Phase 4 Reporting: Establish filing processes and ongoing compliance
Risk Assessment
- High-risk scenarios including audit probability and penalty structures
- Medium-risk scenarios including complexity and error likelihood
- Low-risk scenarios with mitigation strategies
- Jurisdiction-specific mitigation recommendations
Safety & Compliance
- Professional disclaimers and limitations clearly stated
- Guidance on when to seek professional tax advice
- Information verification recommendations
Safety & Limitations
Safety Boundaries
- No Professional Advice: Provides informational frameworks only. Does not replace qualified tax professionals.
- No Real-Time Data: Based on general frameworks, not current regulations. Regulations change frequently.
- No Transactions: No payment processing, tax calculations, or financial transactions.
- No Code Execution: Pure descriptive implementation. No shell commands or network requests.
- Descriptive Only: Provides planning frameworks and guidance only.
Limitations
- Tax regulations may become outdated and require verification
- Business-specific factors may alter applicable requirements
- Jurisdiction-specific nuances may not be fully captured
- Does not include tax treaty considerations
- Product classification nuances may affect applicable rates
Example Prompts
Level 1: Basic Inquiry
"What are my tax obligations for selling in Germany?"
Level 2: Specific Scenario
"US LLC selling digital products to EU customers via own website"
Level 3: Complex Planning
"Multi-market expansion to Germany, France, UK, Australia with mixed physical/digital goods"
Level 4: Detailed Case
"US corporation selling physical goods to Germany and France with Euro 100k annual sales"
Acceptance Criteria
Functional Requirements
- Returns valid JSON structure from handle() function
- Includes input_analysis field with parsed input information
- Contains proper disclaimer with safety boundaries
- Provides skill-specific tax obligation mapping
- Differentiated from other cross-border e-commerce skills
Quality Requirements
- Clear and structured output
- Comprehensive framework coverage
- Actionable implementation guidance
- Proper safety boundaries enforced
- Input differentiation verified through tests
Integration
Complementary Skills
- Works with cb-compliance-framework for broader compliance coverage
- Integrates with cb-market-entry-strategist for market-specific planning
- Supports cb-multi-currency-pricing for tax-inclusive pricing strategies
Input/Output Flow
- Accepts natural language input via handle() function
- Returns structured JSON for system integration
- Can be chained with related skills for multi-faceted analysis
Version History
v1.0.0 (2026-04-22)
- Initial release
- Basic tax obligation mapping for key markets
- Compliance implementation framework with phases
- Risk assessment with jurisdiction-specific considerations
- Input parsing and parameter extraction
- JSON output with input_analysis and disclaimer
- Safety boundaries and limitations documentation
- Test coverage with 6 tests per skill
Technical Details
Handler Interface
Dependencies
- None (pure Python standard library only)
File Structure
- handler.py: Main handler implementation
- tests/test_handler.py: Unit tests (6 tests)
- SKILL.md: This documentation file
- skill.json: Skill metadata and configuration
- ACCEPTANCE.md: Acceptance criteria documentation
- .claw/identity.json: Identity and authorship information
Test Coverage
- JSON output validation test
- Disclaimer presence and content test
- Input differentiation test
- Jurisdiction-specific functionality test
- Product category-specific test
- Differentiation evidence test
Usage Scenarios
| # | User Input | Expected Output |
|---|---|---|
| 1 | "We sell digital products from the US. At what revenue threshold do I need to register for VAT in each EU country?" | Per-country threshold table: EU-wide OSS threshold (EUR10,000 for intra-EU distance sales), individual country thresholds for non-EU sellers (most are EUR0 with OSS). Digital-services VAT rates per country. Registration process summary for OSS (single portal, quarterly filing). |
| 2 | "We have 3 employees working remotely in Canada, UK, and Spain. Do we have permanent establishment risk?" | PE risk assessment per country: Canada (fixed-place PE unlikely if home-office, but dependent-agent PE possible if sales-role), UK (corporate-tax PE threshold analysis), Spain (high PE risk with employee + revenue nexus). Recommendations: employment-structure review, activity-scope documentation. |
| 3 | "We are approaching the AU GST threshold (A$75,000). Build a 90-day compliance-onboarding plan." | Plan: Day 1-15 → ABN registration, Day 16-30 → GST registration, Day 31-45 → accounting-software integration, Day 46-60 → test BAS lodgment process, Day 61-90 → go-live with monitoring. Estimated cost: $8,000 inclusive of advisor fees. |
Scenario 2: 跨境卖货要交哪些税
User input: "我在亚马逊卖货到美国，搞不清楚要交什么税、什么时候交、怎么交。怕被IRS查。" Expected output: 跨境电商美国税务指南——联邦税：按利润交企业所得税（美国联邦企业所得税21%），如果你的公司在中国注册但美国有仓储就要交；州税：在有关联的州（如有FBA仓库的州）可能需要注册销售税（Sales Tax，各州税率不同0-10%），使用亚马逊的Marketplace Facilitation（亚马逊帮你代扣代缴大部分州但你需要注册）；申报时间：联邦税每年1次（4月15日前）、州税可能每季度或每月申报；不懂怎么办：花300-500美元找一家跨境电商税务代理（如TaxJar/AVASK的代理服务）；避坑：不要用个人名义注册美国账户收款一定要以公司名义，否则被双重征税。关键工具：TaxJar自动计算销售税+Avalara合规咨询。