Agent skill

Reading Invoice

by kazukinagata in kazukinagata/shinkoku

請求書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku.

MITAuto-check passedDocuments & Office

Install Reading Invoice

skills CLI
$ npx skills add kazukinagata/shinkoku --skill reading-invoice -a claude-code

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

GitHub CLI
$ gh skill install kazukinagata/shinkoku reading-invoice --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/kazukinagata/shinkoku.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/reading-invoice .claude/skills/reading-invoice && 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
reading-invoice
GitHub stars
365
Token cost
~525 tokens
SKILL.md length
112 words
Files
2
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

請求書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku.

  • Works in 3 steps: shinkoku pdf extract-text --file-path… → 抽出テキストに必要な情報(金額・日付・請求元等)が含まれていれば、テキストから構造… → テキストが不十分(スキャン PDF 等)の場合は shinkoku pdf…
  • Tasks that involve Forms and invoices
  • SKILL.md covers PDF ファイルの場合, 画像読み取り方法, 基本ルール and 出力フォーマット, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reading Invoice is an agent skill from kazukinagata/shinkoku. 請求書の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Documents & Office, covering Forms and invoices. The repository describes itself as: 確定申告自動化 AI エージェントプラグイン — 帳簿管理から e-Tax 入力代行まで. The licence is MIT.

When your agent uses it

  • Tasks that involve Forms and invoices

Example prompts

  • “/reading-invoice”

Workflow steps

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

  1. shinkoku pdf extract-text --file-path を実行する
  2. 抽出テキストに必要な情報(金額・日付・請求元等)が含まれていれば、テキストから構造化データを生成する
  3. テキストが不十分(スキャン PDF 等)の場合は shinkoku pdf to-image --file-path --output-dir で PNG に変換し、以下の画像読み取りフローに進む

What it can do on your machine

Read from SKILL.md and the folder at commit 607574d. 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.

    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

Reading Invoice loads about 525 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 112 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~18
When it runs · the whole SKILL.md, loaded when a task matches
~525

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 kazukinagata/shinkoku at commit 607574d, republished under its MIT licence (© kazukinagata). 112 words, ~525 tokens.

Download SKILL.mdSave it as .claude/skills/reading-invoice/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
reading-invoice
description
請求書の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。

請求書 画像読み取り

請求書の画像を読み取り、構造化データとして返すスキル。

PDF ファイルの場合

ファイルが PDF(.pdf)の場合、画像 OCR の前にテキスト抽出を試みる。

  1. shinkoku pdf extract-text --file-path <path> を実行する
  2. 抽出テキストに必要な情報(金額・日付・請求元等)が含まれていれば、テキストから構造化データを生成する
  3. テキストが不十分(スキャン PDF 等)の場合は shinkoku pdf to-image --file-path <path> --output-dir <dir> で PNG に変換し、以下の画像読み取りフローに進む

画像読み取り方法

推奨: デュアル検証(並列2コンテキスト)

精度を高めるため、同じ画像を2つの独立したコンテキストで並列に読み取り、結果を照合する。

  1. 2つの独立した読み取りを実行する: サブエージェントが使える環境では、2つのサブエージェントを並列で起動し、それぞれ独立に画像を読み取る。 各サブエージェントには以下の「基本ルール」と「出力フォーマット」をプロンプトとして渡し、画像ファイルパスを指定する。

  2. 結果照合: 両方の読み取り結果から主要フィールド(金額等)を比較する。

  3. 一致の場合: そのまま採用。「2つの独立した読み取りで結果が一致しました」と報告する。

  4. 不一致の場合: ユーザーに元画像パスと両方の結果を提示し、正しい方を選択してもらう:

    • 差異のあるフィールドを明示する
    • A を採用 / B を採用 / 手動入力 の3択を提示する
フォールバック(サブエージェント非対応の場合)

サブエージェントが利用できない環境では、以下の手順で読み取る:

  1. 画像ファイルを直接 Read ツールで読み取る
  2. 以下の「基本ルール」と「出力フォーマット」に従ってデータを抽出する
  3. 抽出結果をユーザーに提示し、必ず目視確認を依頼する

⚠ デュアル検証が利用できないため、必ずユーザーに目視確認を依頼してください。

基本ルール

  • 画像ファイルは Read ツールで読み取る(Claude Vision が自動的に画像を認識する)
  • 金額は必ず int(円単位の整数)で返す。カンマや「円」は除去する
  • 日付は YYYY-MM-DD 形式で返す
  • 和暦は西暦に変換する(令和7年 → 2025、令和6年 → 2024、平成31年 → 2019)
  • 読み取れないフィールドは UNKNOWN(文字列)または 0(金額)とする
  • 複数ファイルを渡された場合は全て順に処理してまとめて返す

出力フォーマット

画像を読み取り、以下の形式で返す:

---INVOICE_DATA---
vendor: 請求元名
invoice_number: 請求書番号
invoice_registration_number: 適格請求書発行事業者番号(T+13桁)
date: YYYY-MM-DD
total_amount: 請求金額合計(int)
tax_amount: 消費税額(int)
items:
  - description: 品目・サービス名
    amount: 金額(int)
    quantity: 数量(int)
    tax_rate: 税率(10 or 8)
---END---

抽出のポイント

  • 請求金額の合計(税込)を最優先で抽出する
  • 消費税額を確認する(10% と 8% 軽減税率の区分があれば区別する)
  • インボイス番号(T+13桁の適格請求書発行事業者登録番号)の有無を確認する
  • 請求書番号がある場合は抽出する
  • 請求元(vendor)の名称を抽出する
  • 日付は請求日を使用する(発行日と請求日が異なる場合は請求日を優先)
  • 明細行は読み取れる範囲で抽出する(不明な場合は items を空にする)

複数ファイルの処理

複数のファイルパスが指示された場合:

  1. Glob ツールでファイル一覧を取得する(パターンが指示された場合)
  2. 各ファイルを Read ツールで順に読み取る
  3. 全ファイルの結果をまとめて返す(各結果の前にファイル名を記載する)
## file1.jpg
---INVOICE_DATA---
...
---END---

## file2.jpg
---INVOICE_DATA---
...
---END---

© kazukinagata, 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 1 other file in skills/reading-invoice of kazukinagata/shinkoku.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 607574d

Compare with similar skills

Reading Invoice 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.

Reading Invoice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Invoice this skillkazukinagata/shinkoku365—~525Automated safety check: PassMIT
Ar AgingWellApp-ai/Well345—~532Automated safety check: PassMIT
Clients Accountssickn33/agentic-awesome-skills47k1 repos~4.7kAutomated safety check: PassMIT
Payments Receivedsickn33/agentic-awesome-skills47k1 repos~3.5kAutomated safety check: PassMIT
Fee BillingJoelLewis/finance_skills206—~6.8kAutomated safety check: PassMIT
Kiwi ReceiptsLeoYeAI/openclaw-master-skills2.2k—~5.2kAutomated safety check: PassMIT

Similar skills

  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Clients Accounts

    sickn33/agentic-awesome-skills

    Client and account register: contacts, billing address, tax ID and basis, payment terms, invoice totals, amounts paid and outstanding balance.

    47k GitHub starsUsed in 1 repo~4.7k tokens
    Documents & OfficeAuto-check passed
  • Payments Received

    sickn33/agentic-awesome-skills

    Payments received log: reference, client and invoice, amount and currency, payment date and method, withholding tax, bank account, received-by and receipt-sent status.

    47k GitHub starsUsed in 1 repo~3.5k tokens
    Documents & OfficeAuto-check passed
  • Fee Billing

    JoelLewis/finance_skills

    Build and manage advisory fee billing operations from fee schedule design through calculation, collection, revenue recognition, and compliance disclosure.

    206 GitHub stars~6.8k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Kiwi Receipts

    LeoYeAI/openclaw-master-skills

    NZ tax assistant for sole traders. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Pharmacy Dev

    hmislk/hmis

    Pharmacy module development guide for the HMIS project. An agent skill from hmislk/hmis.

    236 GitHub stars~910 tokensUpdated today
    Documents & OfficeAuto-check passed

More from kazukinagata/shinkoku

All 24 skills in this repo
  • Consumption Tax

    kazukinagata/shinkoku

    This skill should be used when the user needs to calculate consumption tax (消費税) or determine their tax method (2割特例, 簡易課税, or 本則課税).

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Furusato

    kazukinagata/shinkoku

    This skill manages furusato nozei (hometown tax) donations. An agent skill from kazukinagata/shinkoku.

    365 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Incorporation

    kazukinagata/shinkoku

    法人成り(個人事業主から法人への移行)に関する相談。税額比較シミュレーション、 法人形態の選択、設立手続き、役員報酬戦略、社会保険の比較を支援する。

    365 GitHub stars~687 tokensUpdated 1 mo ago
    Auto-check passed
  • Invoice System

    kazukinagata/shinkoku

    This skill should be used when the user asks about the invoice system (インボイス制度), qualified invoices (適格請求書), registration numbers (登録番号), input tax credits (仕入税額控除), the 20% special measure (2割特例)…

    365 GitHub stars~778 tokensUpdated 1 mo ago
    Auto-check passed
  • 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
    Auto-check passed
  • Settlement

    kazukinagata/shinkoku

    This skill should be used when the user needs to perform year-end closing adjustments (決算整理), review financial statements (決算書), compute depreciation, or review their trial balance.

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Reading Invoice

What does Reading Invoice do?

請求書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku. Reading Invoice is an agent skill from kazukinagata/shinkoku.

When should I use Reading Invoice?

Reading Invoice fits situations like: tasks that involve Forms and invoices.

How do I install Reading Invoice in Claude Code?

Run `npx skills add kazukinagata/shinkoku --skill reading-invoice -a claude-code`. Or copy the skill folder (skills/reading-invoice in kazukinagata/shinkoku) into .claude/skills/reading-invoice in your project. Claude Code loads it when a task matches its description.

How do I install Reading Invoice in Codex?

Run `npx skills add kazukinagata/shinkoku --skill reading-invoice -a codex`. Or copy the skill folder (skills/reading-invoice in kazukinagata/shinkoku) into .agents/skills/reading-invoice in your project. Codex loads it when a task matches its description.

Can I use Reading Invoice 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 kazukinagata/shinkoku --skill reading-invoice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reading-invoice, .gemini/skills/reading-invoice, .github/skills/reading-invoice and .opencode/skills/reading-invoice in your project.

What does Reading Invoice need to run?

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

Does Reading Invoice 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 Reading Invoice 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 Reading Invoice use?

Reading Invoice 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 Reading Invoice use?

About 525 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reading Invoice?

Skills that share tags, products or a category with Reading Invoice: Ar Aging (WellApp-ai/Well, 345 stars), Clients Accounts (sickn33/agentic-awesome-skills, 47k stars), Payments Received (sickn33/agentic-awesome-skills, 47k stars) and Fee Billing (JoelLewis/finance_skills, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reading Invoice?

kazukinagata (a GitHub user) maintains it in kazukinagata/shinkoku, which has 365 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 9, 2026.

Source: kazukinagata/shinkoku on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.