freelance-invoice

Generates Japanese qualified invoice PDFs from billing data using an HTML template and headless Chrome.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/Cohey0727/CodingAgentTools --skill freelance-invoice-cohey0727
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: freelance-invoice
Source: https://github.com/Cohey0727/CodingAgentTools/tree/main/skills/freelance-invoice
Command: npx skills add https://github.com/Cohey0727/CodingAgentTools --skill freelance-invoice-cohey0727

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Freelancers in Japan must issue compliant qualified invoices (適格請求書) with registration numbers, correct consumption tax breakdowns, and consistent formatting. Manually building these PDFs each month is repetitive and error-prone, especially when recalculating subtotals, tax, and totals after quantity changes. ## Core Features & Use Cases - Invoice PDF Generation: Fills a fixed HTML template with client name, billing period, hours, rate, and issuer details, then prints to PDF via headless Chrome. - Automatic Tax Calculation: Computes subtotal, 10% consumption tax, and grand total with comma formatting, keeping all five amount fields in sync when quantities change. - Issuer Config Management: Reads issuer identity, registration number, and bank transfer details from a gitignored personal-config.json, with an example file to bootstrap setup. - Use Case: A freelance developer says "請求書出して" at month end; the Skill collects client name, hours (e.g., 74.5), and rate, then produces 20250101-1_請求書.pdf ready to send. ## Quick Start Ask the assistant to create an invoice for a client by providing the client name, target month, hours worked, and hourly rate, and it will generate the invoice PDF.

Frequently Asked Questions about freelance-invoice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Japanese invoice PDF from an HTML template?▼

Fill the HTML template placeholders with billing data, then print it to PDF using headless Chrome with the --print-to-pdf flag and --no-pdf-header-footer. This produces a clean A4 invoice without browser headers or footers.

How do I create a qualified invoice (適格請求書) for Japan's invoice system?▼

A qualified invoice must include the issuer's registration number (T-number), tax amount broken down by rate, and the total including tax. This Skill's template includes the registration number field and a 10%/8% tax breakdown table.

How is consumption tax calculated on freelance invoices in Japan?▼

Consumption tax is 10% of the subtotal (quantity multiplied by unit rate), and the grand total is subtotal plus tax. Amounts are formatted with thousands separators, and all five amount fields must be updated together when quantities change.

What happens if personal-config.json is missing?▼

The Skill stops and asks you to copy personal-config.example.json to personal-config.json and fill in your issuer details. This file is gitignored so your name, registration number, address, and bank details stay out of version control.

Can I change the invoice layout or design?▼

The design is fixed in templates/invoice.html and should not be edited unless a layout change is explicitly requested. The Skill only replaces placeholder values like client name, amounts, and dates.

How do I handle hours already billed on a separate invoice?▼

Reduce only the quantity on the new invoice (for example, 77.5 minus 5 equals 72.5 hours) while leaving the work record unchanged. All dependent amounts are recalculated automatically from the adjusted quantity.