invoice-generator

# ═══════════════════════════════════════════════════════════════════════════════
# CLAUDE OFFICE SKILL - Enhanced Metadata v2.0
# ═══════════════════════════════════════════════════════════════════════════════

# Basic Information
name: invoice-generator
description: "Create professional invoices with proper formatting for freelancers and small businesses. Supports multiple currencies and tax calculations."
version: "1.0.0"
author: claude-office-skills
license: MIT

# Categorization
category: finance
tags:
  - invoice
  - billing
  - generator
  - finance
  - business
department: Finance

# AI Model Compatibility
models:
  recommended:
    - claude-sonnet-4
    - claude-opus-4
  compatible:
    - claude-3-5-sonnet
    - gpt-4
    - gpt-4o

# MCP Tools Integration
mcp:
  server: office-mcp
  tools:
    - create_docx
    - fill_docx_template
    - docx_to_pdf
  optional_tools:
    - create_xlsx

# Skill Capabilities
capabilities:
  - invoice_creation
  - tax_calculation
  - currency_handling
  - professional_formatting

# Input/Output Specification
input:
  required:
    - type: text
      name: client_info
      description: Client name, address, contact
    - type: text
      name: line_items
      description: Products/services with quantities and prices
  optional:
    - type: text
      name: currency
      description: Currency (USD, EUR, CNY, etc.)
    - type: text
      name: tax_rate
      description: Tax rate percentage
    - type: text
      name: payment_terms
      description: Payment terms and due date

output:
  primary:
    type: document
    formats: [docx, pdf]
  artifacts:
    - type: file
      name: invoice.docx
      description: Generated invoice document

# Language Support
languages:
  - en
  - zh

# Related Skills
related_skills:
  - invoice-template
  - invoice-organizer
  - expense-report

Invoice Generator Skill

Overview

I help freelancers and small businesses create professional invoices quickly. Just tell me the details, and I'll generate a complete, properly formatted invoice.

What I can do:

• Create professional invoices in multiple formats
• Calculate taxes (VAT, GST, sales tax)
• Handle multiple currencies
• Support various payment terms
• Generate in English or Chinese

What I cannot do:

• File taxes for you
• Guarantee compliance with all local regulations
• Process actual payments

---

How to Use Me

Step 1: Provide Basic Info

Tell me:

1. Your business details (name, address, tax ID if needed)
2. Client details (name, address)
3. Items/services (description, quantity, rate)
4. Invoice number (or I'll suggest one)
5. Payment terms (due date, accepted methods)

Step 2: I'll Generate

I'll create a complete invoice with:

• Professional layout
• Proper calculations
• Payment instructions
• Terms and conditions

Step 3: Export

Copy the output to your preferred tool:

• Paste into Word/Google Docs
• Use the markdown version
• Request HTML for web display

---

Invoice Components

Required Elements

Element	Description	Example
Invoice Number	Unique identifier	INV-2026-0001
Date	Issue date	January 29, 2026
Due Date	Payment deadline	February 28, 2026
From	Your business info	Company name, address
Bill To	Client info	Client name, address
Line Items	Services/products	Description, qty, rate, amount
Total	Sum due	Amount with currency

Optional Elements

Element	When to Include
Tax ID	Required in many countries for B2B
PO Number	If client provided purchase order
Tax Breakdown	When charging VAT/GST/Sales Tax
Late Fee Terms	If you charge for late payment
Bank Details	For wire transfers
Payment Link	For online payment

---

Tax Guidance by Region

United States

No federal invoice requirements, but good practices:

• Include your EIN if B2B
• State sales tax if applicable (varies by state)
• 1099 reporting if paying contractors $600+

Sales Tax Rates (examples):

State	Rate	Notes
California	7.25% base	Up to 10.75% with local
Texas	6.25% base	Up to 8.25% with local
New York	4% state	Up to 8.875% with local
Oregon	0%	No sales tax

European Union

VAT Invoice Requirements:

• Must include VAT number if registered
• Reverse charge for B2B cross-border
• Sequential invoice numbering required

Standard VAT Rates:

Country	Rate
Germany	19%
France	20%
UK (post-Brexit)	20%
Netherlands	21%
Ireland	23%

Reverse Charge: For B2B services in EU, buyer may handle VAT. Include "Reverse Charge - VAT to be paid by recipient."

China

Invoice Requirements:

• Regular invoice vs. VAT special invoice (fapiao)
• Tax registration number required
• Official invoices must be issued through tax authority system

VAT Rates:

Type	Rate
General Goods	13%
Services	6%
Small-scale Taxpayer	3%

Australia

GST Requirements:

• 10% GST on most goods/services
• Must include ABN if registered
• GST-free for exports

---

Payment Terms Reference

Common Terms

Term	Meaning
Due on Receipt	Pay immediately
Net 15	Due within 15 days
Net 30	Due within 30 days (most common)
Net 60	Due within 60 days
2/10 Net 30	2% discount if paid in 10 days, otherwise due in 30

Late Payment Policies

Example language:

"Invoices not paid within [X] days will incur a late fee of [1.5%] per month on the outstanding balance."

Legal maximums vary:

• US: Generally up to 18-24% annually
• UK: 8% + Bank of England base rate
• EU: ECB rate + 8%

---

Output Format

Markdown Invoice

# INVOICE

**Invoice Number:** INV-2026-0042
**Date:** January 29, 2026
**Due Date:** February 28, 2026

---

## From
[Your Business Name]
[Your Address]
[Your Email]
[Tax ID: XXX-XX-XXXX]

## Bill To
[Client Name]
[Client Address]
[Client Email]

---

## Items

| Description | Qty | Rate | Amount |
|-------------|-----|------|--------|
| [Service 1] | 10 hrs | $100/hr | $1,000.00 |
| [Service 2] | 1 | $500 | $500.00 |

---

|  | |
|---|---|
| **Subtotal** | $1,500.00 |
| **Tax (10%)** | $150.00 |
| **Total Due** | **$1,650.00** |

---

## Payment Details

**Bank Transfer:**
Bank: [Bank Name]
Account: [Account Number]
Routing: [Routing Number]

**Or pay online:** [Payment Link]

---

**Payment Terms:** Net 30
**Late Fee:** 1.5% per month on overdue balance

Thank you for your business!

---

Examples

Example 1: Simple Freelance Invoice

User: Create an invoice for 20 hours of web development at $75/hour for Acme Corp. I'm John Smith, based in Austin, TX.

Me:

INVOICE

Invoice Number: INV-2026-0001 Date: January 29, 2026 Due Date: February 28, 2026

---

From

John Smith Austin, TX 78701 john@example.com

Bill To

Acme Corp [Client Address]

---

Items

Description	Qty	Rate	Amount
Web Development Services	20 hrs	$75.00/hr	$1,500.00

---

Total Due	$1,500.00 USD

---

Payment Terms: Net 30

---

Example 2: With VAT (UK)

User: Invoice for consulting services to a UK client, £2000, need to add VAT

Me:

Subtotal	£2,000.00
VAT (20%)	£400.00
Total Due	£2,400.00 GBP

VAT Registration: GB123456789

---

Example 3: Multiple Line Items

User: Invoice for: Logo design $500, Brand guidelines $1200, Business card design $300. Client is StartupXYZ.

Me:

Description	Qty	Rate	Amount
Logo Design	1	$500.00	$500.00
Brand Guidelines Document	1	$1,200.00	$1,200.00
Business Card Design	1	$300.00	$300.00

---

Total Due	$2,000.00 USD

---

Invoice Numbering Best Practices

Format Options

Format	Example	Best For
Sequential	001, 002, 003	Simple, low volume
Year-Seq	2026-001	Easy to track by year
Client-Seq	ACME-001	Multiple clients
Date-Seq	20260129-01	Date-based tracking

Tips

• Never reuse invoice numbers
• Keep numbers sequential (gaps may raise audit questions)
• Include prefix for different services if needed

---

Tips for Better Results

1. Provide complete info - The more details, the better the invoice
2. Specify currency - USD, EUR, GBP, CNY, etc.
3. Include tax requirements - Tell me if you need VAT/GST
4. Mention payment methods - Bank, PayPal, Stripe, etc.
5. Request specific format - Markdown, HTML, or plain text

---

Common Mistakes to Avoid

1. Missing due date - Always specify when payment is expected
2. Vague descriptions - "Consulting" is worse than "Marketing strategy consulting - Q1 campaign planning"
3. Wrong calculations - I'll double-check, but verify final numbers
4. Missing tax info - Required for B2B in many countries
5. No payment instructions - Make it easy to pay you!

---

Limitations

• I generate text invoices, not PDFs directly
• Tax calculations are estimates - verify with accountant
• Can't integrate with accounting software
• Don't know your specific local requirements

---

Languages

Works with multiple languages including English and Chinese. Just specify your preferred language when requesting an invoice.

---

Built by the Claude Office Skills community. Get paid faster!