invoice-creation（請求書作成スキル）

invoice-creation（請求書作成スキル）

Claude Code に「◯◯社に請求書作って」と頼むだけで、日本の商習慣に合った請求書PDF（A4・1ページ・角印つき）が数秒で出てくるスキルです。外部サービスやAPIキーは一切不要で、あなたのパソコンの中だけで完結します。

こんな人向け

• 毎月の請求書を Word や Excel で手直ししていて、金額や日付の打ち間違いが怖い人
• 請求書サービスの月額を払うほどではないが、見た目はきちんとした請求書を出したい個人事業主・小さな会社
• Claude Code を使い始めて、経理まわりの雑務をまずAIに任せてみたい人

何ができるか

• 宛名・件名・明細を伝えると、日本語フォント埋込のPDF請求書を1ページに収めて生成する
• 自社の社名・住所・振込先・角印を一度 config/issuer.json に書けば、以降は毎回自動で入る
• 消費税あり／なし（免税事業者）の両方に対応。税率も指定できる
• 数量の単位（ヶ月・点・式など）や、長い品名の自動改行にも対応
• 生成前に preflight.py が環境を自動検査するので、「フォントが無くて文字化け」「2ページに割れた」を事前に防げる
• 請求書番号 YYYYMMDD-NNN の採番ルールと、送信前の3点照合（宛名⇄宛先⇄依頼内容）の手順が SKILL.md に組み込まれている

使い方

1. ZIPを解凍し、フォルダを .claude/skills/invoice-creation/ に置く（他の場所でも動きます）
2. ターミナルで pip install fpdf2 を実行する
3. config/issuer.example.json をコピーして config/issuer.json を作り、自社情報を書く
4. 角印を入れたい場合は、透過PNGを assets/seal.png に置く（無ければ押印なしで出ます）
5. python3 scripts/preflight.py --render を実行し、PREFLIGHT: OK を確認する
6. Claude Code で「株式会社◯◯に9月分の◯◯業務の請求書を作って。金額は◯円」と伝える
7. AIが examples/sample-invoice.json と同じ形のJSONを組み立て、scripts/invoice_generator.py でPDFを生成する
8. output/archive/ に出たPDFを開いて、宛名・金額・支払期限を確認する
9. メールで送る前に、AIが「宛名⇄送信先⇄依頼内容」の3点を照合し、あなたの承認を待つ

手動で動かす場合は次の1行です。

python3 scripts/invoice_generator.py --output "output/archive/20260901-001_株式会社サンプル商事.pdf" --json-file examples/sample-invoice.json

同梱物

| ファイル | 役割 |
|---|---|
| SKILL.md | Claude Code 用の手順書。ヒアリング項目・JSON契約・検証・送付前の照合ルール |
| scripts/invoice_generator.py | PDF生成本体（fpdf2）。レイアウトはすべてここで決まる |
| scripts/preflight.py | 環境検査。fpdf2・フォント・設定ファイル・1ページ収まりを機械判定 |
| config/issuer.example.json | 発行者情報のひな形。コピーして issuer.json を作る |
| examples/sample-invoice.json | 請求内容JSONの記入例（消費税ありの2明細） |
| assets/fonts/NotoSansJP.ttf | 埋込用日本語フォント（SIL Open Font License 1.1） |
| assets/seal-sample.png | 見本の角印（動作確認用。実運用では自社の角印に差し替える） |
| references/invoice-html-template.html | ブラウザでレイアウトを確認したい時の補助テンプレ（任意） |
| output/archive/ | 生成したPDFの保存先（空） |
| sample-output/ | 実際に動かして出た請求書PDF・入力JSON・ターミナル出力 |

必要なもの

• Claude Code（または JSON を組み立ててコマンドを叩ける任意のAIエージェント。手動実行も可）
• Python 3.9 以上と fpdf2（pip install fpdf2）
• 外部サービス・APIキー: 不要
• 前提知識: ターミナルで pip install と python3 ファイル名 を打てれば十分です

成果物の例

sample-output/20260901-001_株式会社サンプル商事.pdf が、同梱の examples/sample-invoice.json と架空の発行者設定から実際に生成した請求書です（発行者・宛先・口座はすべて架空）。

• screenshots/output-01.png 入力: 自社情報JSONと請求内容JSON
• screenshots/output-02.png 実行: preflight と生成コマンドのターミナル出力
• screenshots/output-03.png 完成: 生成されたPDF（角印・消費税行・空行整形の様子）

注意事項

• 明細が6行以上あると1ページに収まらない場合があります。品名を短くするか明細をまとめてください
• 角印は透過PNGを想定しています。JPEGだと白い四角が出ます
• 消費税の要否や税率は、あなたの事業の状況（免税／課税）に合わせて設定してください。このスキルは税務上の判断をしません
• 適格請求書（インボイス制度）の登録番号を載せたい場合は、法人番号 の代わりに 所在地2 などの空いている行に文字列として入れるか、invoice_generator.py の発行者欄に1行足してください
• メール送信機能は含みません。送付は Claude Code の Gmail 連携などをご自身の環境で使ってください
• macOS と Linux で動作確認しています。Windows でも Python と fpdf2 があれば動く想定ですが未検証です

更新履歴

• v1.0.0 (2026-09-10) 初版