Agent skill

Tw Einvoice Guide

by asgard-ai-platform in asgard-ai-platform/skills

Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation.

MITAuto-check passedBusiness, Finance & HR

Install Tw Einvoice Guide

skills CLI
$ npx skills add asgard-ai-platform/skills --skill tw-einvoice-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install asgard-ai-platform/skills tw-einvoice-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/asgard-ai-platform/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tw-einvoice-guide .claude/skills/tw-einvoice-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tw-einvoice-guide
GitHub stars
242
Token cost
~1.4k tokens
SKILL.md length
414 words
Files
3 (incl. references)
Skills in repo
207
Repo updated
First seen
Licence
MIT

At a glance

Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation.

  • Works in 3 steps: Register on 財政部電子發票整合服務平台 → Apply for 加值服務中心 AppID (if using API… → Set up certificate and authentication
  • The user needs to set up e-invoicing for a Taiwan business
  • SKILL.md covers Framework, Output Format, Gotchas and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tw Einvoice Guide is an agent skill from asgard-ai-platform/skills. Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation. Use this skill when the user needs to set up e-invoicing for a Taiwan business, integrate with the MOF platform, understand carrier codes, or troubleshoot invoice issues — even if they say 'set up e-invoice', 'how does 電子發票 work', 'integrate with 財政部', or 'carrier barcode scanning'.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `examples/sample_scenario.md` and `references/einvoice-api.md`).

It sits in Business, Finance & HR, covering Forms and invoices, Accounting and bookkeeping and Tax preparation. The repository describes itself as: 301 open-source coding agent skills across 22 domains — methodology, judgment & gotchas packaged as Claude Agent Skills for the Asgard AI Platform. The licence is MIT.

When your agent uses it

  • The user needs to set up e-invoicing for a Taiwan business
  • Integrate with the MOF platform
  • Understand carrier codes
  • Troubleshoot invoice issues — even if they say set up e-invoice

Example prompts

  • “set up e-invoice”
  • “how does 電子發票 work”
  • “integrate with 財政部”
  • “/tw-einvoice-guide”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Register on 財政部電子發票整合服務平台
  2. Apply for 加值服務中心 AppID (if using API method)
  3. Set up certificate and authentication

What it can do on your machine

Read from SKILL.md and the folder at commit 4e7f4f8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tw Einvoice Guide loads about 1.4k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 414 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from asgard-ai-platform/skills at commit 4e7f4f8, republished under its MIT licence (© asgard-ai-platform). 414 words, ~1,350 tokens.

Download SKILL.mdSave it as .claude/skills/tw-einvoice-guide/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
tw-einvoice-guide
description
Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation. Use this skill when the user needs to set up e-invoicing for a Taiwan business, integrate with the MOF platform, understand carrier codes, or troubleshoot invoice issues — even if they say 'set up e-invoice', 'how does 電子發票 work', 'integrate with 財政部', or 'carrier barcode scanning'.
metadata.category
WP-05 台灣創業
metadata.tags
taiwan, e-invoice, tax-compliance, integration

Taiwan E-Invoice System (電子發票)

Framework

IRON LAW: E-Invoice Is Mandatory for Most B2C Businesses

Since 2019, businesses using 統一發票 must issue electronic invoices
through the 財政部電子發票整合服務平台. Paper invoices are being phased
out. Non-compliance triggers penalties and may affect 營業稅 filing.
System Architecture
Your System (POS/ERP/E-commerce)
    ↓ API / Turnkey
財政部電子發票整合服務平台 (einvoice.nat.gov.tw)
    ↓
Consumer (via 載具: 手機條碼 / 自然人憑證 / App)
    ↓
國稅局 (tax reconciliation)
Integration Methods
MethodHow It WorksBest ForComplexity
TurnkeyInstall MOF-provided software, batch upload invoicesTraditional businesses, low volumeMedium
API (加值服務中心)Connect via 加值中心 API (e.g., 綠界、藍新)E-commerce, SaaS, high volumeLow-Medium
Direct APIConnect directly to MOF platformLarge enterprises with IT teamHigh
POS integrationPOS vendor handles e-invoice nativelyRetail, F&BLow (vendor does it)
B2B vs B2C Invoice Differences
AspectB2B (營業人對營業人)B2C (營業人對消費者)
Buyer infoBuyer's 統編 requiredNo 統編 (consumer)
Format三聯式二聯式
Tax displayTax amount shown separatelyTax included in price
CarrierN/A手機條碼, 自然人憑證, or membership carrier
Prize eligibilityNoYes (中獎機制)
Carrier Types (載具)
CarrierCode FormatUse Case
手機條碼/XXXXXXX (slash + 7 chars)Most common consumer carrier
自然人憑證2 letters + 14 digitsGovernment ID-linked
會員載具 (membership)Defined by businessLoyalty program integration
捐贈碼3-7 digitsDonate invoice to charity
Implementation Steps

Phase 1: Registration

  1. Register on 財政部電子發票整合服務平台
  2. Apply for 加值服務中心 AppID (if using API method)
  3. Set up certificate and authentication

Phase 2: Development/Integration 4. Choose integration method (Turnkey vs API vs POS) 5. Implement invoice issuance: create, void, void-and-reissue 6. Implement carrier scanning (手機條碼 barcode) 7. Handle 捐贈碼 (donation codes)

Phase 3: Testing 8. Test in sandbox environment 9. Issue test invoices, verify on MOF platform 10. Test void/reissue flows

Phase 4: Go-Live 11. Switch to production environment 12. Monitor daily: match issued invoices vs MOF records 13. Bimonthly: reconcile with 營業稅 filing (401 form)

Show full SKILL.md (166 more words)Show less
Common API Flows

Issue Invoice:

POST /invoice → { seller_id, buyer_id (optional), items[], amount, tax, carrier_type, carrier_id }
→ Response: { invoice_number, invoice_date, random_code }

Void Invoice:

POST /invoice/void → { invoice_number, invoice_date, void_reason }

Query Invoice:

GET /invoice/{number} → { status, items, amount, carrier }

Output Format

markdown
# E-Invoice Implementation Plan: {Business}

## Current State
- Business type: B2B / B2C / Both
- Current invoicing: Paper / Partial e-invoice / None
- Transaction volume: {N}/month

## Integration Method
- Method: {Turnkey / API / POS integration}
- Provider: {加值中心 name, if applicable}
- Rationale: {why this method}

## Implementation Checklist
- [ ] MOF platform registration
- [ ] AppID obtained
- [ ] Integration developed
- [ ] Sandbox testing passed
- [ ] Carrier scanning implemented
- [ ] Donation code support
- [ ] Production go-live
- [ ] Reconciliation process documented

## Timeline
| Phase | Duration | Milestone |
|-------|----------|-----------|
| Registration | 1-2 weeks | AppID obtained |
| Development | 2-4 weeks | Integration complete |
| Testing | 1-2 weeks | Sandbox verified |
| Go-live | 1 day | First production invoice |

Gotchas

  • Invoice number format is assigned by MOF: You don't generate invoice numbers. The MOF assigns number ranges (字軌) that you request in advance. Run out of numbers = can't issue invoices. Request well ahead of time.
  • Void window is limited: Invoices can be voided within the same bimonthly period. After the period closes, voiding requires a more complex process (折讓).
  • 手機條碼 scanning: The barcode is a slash + 7 characters. Many POS scanners need configuration to read this format correctly. Test with real 手機條碼 barcodes.
  • Prize drawing (中獎): B2C e-invoices are automatically entered into the government lottery (統一發票兌獎). Your system must support winner notification if the invoice was stored in a membership carrier.
  • Reconciliation is critical: The MOF platform is the source of truth. If your system's invoice records don't match the platform, your 營業稅 filing will have discrepancies. Reconcile daily.

References

  • For 加值服務中心 API documentation, see references/einvoice-api.md
  • For 營業稅 filing reconciliation, see the tw-tax-basics skill

© asgard-ai-platform, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in tw-einvoice-guide of asgard-ai-platform/skills.

  • SKILL.md
  • examples/sample_scenario.md
  • references/einvoice-api.md

Open the folder on GitHubat commit 4e7f4f8

Compare with similar skills

Tw Einvoice Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tw Einvoice Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tw Einvoice Guide this skillasgard-ai-platform/skills242—~1.4kAutomated safety check: PassMIT
Invoice Organizerdavila7/claude-code-templates32k12 repos~2.9kAutomated safety check: PassMIT
Pp Quentlimvanhorn/printing-press-library2.1k—~7.8kAutomated safety check: NotesApache-2.0
Journalkazukinagata/shinkoku365—~2.3kAutomated safety check: PassMIT
Invoice Po Reconciliationpnp/sharepoint-skills132—~1.4kAutomated safety check: PassMIT
Querying Well DataWellApp-ai/Well345—~703Automated safety check: PassMIT

Similar skills

  • Invoice Organizer

    davila7/claude-code-templates

    Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.

    32k GitHub starsUsed in 12 repos~2.9k tokens
    Business, Finance & HRAuto-check passed
  • Pp Quentli

    mvanhorn/printing-press-library

    Every Quentli payments, invoicing, and SAT tax-billing endpoint, plus offline collection, reconciliation, and at-risk-subscription intelligence no other Quentli tool has.

    2.1k GitHub stars~7.8k tokensUpdated today
    Business, Finance & HRAuto-check: notes
  • Journal

    kazukinagata/shinkoku

    This skill should be used when the user wants to record bookkeeping entries (仕訳), import transaction data from CSV files, receipts, or invoices, or manage their general ledger.

    365 GitHub stars~2.3k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Invoice Po Reconciliation

    pnp/sharepoint-skills

    Reconciles one or more user-selected invoice files against matching purchase orders in the Purchase Order library.

    132 GitHub stars~1.4k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Querying Well Data

    WellApp-ai/Well

    How to query a Well workspace correctly — discover the schema first, then query the right root.

    345 GitHub stars~703 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Reconciliation

    WellApp-ai/Well

    Match bank transactions to invoices and surface unpaid / unmatched items in a Well workspace.

    345 GitHub stars~511 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from asgard-ai-platform/skills

All 207 skills in this repo
  • Algo Ecom Bm25

    asgard-ai-platform/skills

    Implement BM25 ranking function for e-commerce product search relevance scoring.

    242 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Mfg Cpk

    asgard-ai-platform/skills

    Calculate Cpk process capability index to assess whether a process meets specification requirements.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Price Elasticity

    asgard-ai-platform/skills

    Calculate price elasticity of demand to quantify how price changes affect sales volume.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Bayesian

    asgard-ai-platform/skills

    Apply Bayesian averaging to rank items by combining observed ratings with prior expectations.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Elo

    asgard-ai-platform/skills

    Implement Elo rating system to rank items or players from pairwise comparison outcomes.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Wilson

    asgard-ai-platform/skills

    Calculate Wilson Score confidence intervals for ranking items by positive proportion with sample size correction.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Tw Einvoice Guide

What does Tw Einvoice Guide do?

Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation. Tw Einvoice Guide is an agent skill from asgard-ai-platform/skills. Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation.

When should I use Tw Einvoice Guide?

Tw Einvoice Guide fits situations like: the user needs to set up e-invoicing for a Taiwan business; integrate with the MOF platform; understand carrier codes; troubleshoot invoice issues — even if they say set up e-invoice.

How do I install Tw Einvoice Guide in Claude Code?

Run `npx skills add asgard-ai-platform/skills --skill tw-einvoice-guide -a claude-code`. Or copy the skill folder (tw-einvoice-guide in asgard-ai-platform/skills) into .claude/skills/tw-einvoice-guide in your project. Claude Code loads it when a task matches its description.

How do I install Tw Einvoice Guide in Codex?

Run `npx skills add asgard-ai-platform/skills --skill tw-einvoice-guide -a codex`. Or copy the skill folder (tw-einvoice-guide in asgard-ai-platform/skills) into .agents/skills/tw-einvoice-guide in your project. Codex loads it when a task matches its description.

Can I use Tw Einvoice Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asgard-ai-platform/skills --skill tw-einvoice-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tw-einvoice-guide, .gemini/skills/tw-einvoice-guide, .github/skills/tw-einvoice-guide and .opencode/skills/tw-einvoice-guide in your project.

What does Tw Einvoice Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Tw Einvoice Guide is instructions for the agent only.

Does Tw Einvoice Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tw Einvoice Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tw Einvoice Guide use?

Tw Einvoice Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tw Einvoice Guide use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Tw Einvoice Guide?

Skills that share tags, products or a category with Tw Einvoice Guide: Invoice Organizer (davila7/claude-code-templates, 32k stars), Pp Quentli (mvanhorn/printing-press-library, 2.1k stars), Journal (kazukinagata/shinkoku, 365 stars) and Invoice Po Reconciliation (pnp/sharepoint-skills, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tw Einvoice Guide?

asgard-ai-platform (a GitHub organization) maintains it in asgard-ai-platform/skills, which has 242 GitHub stars. The repository holds 207 skills in this directory. The repository was last updated on June 6, 2026.

Source: asgard-ai-platform/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.