Agent skill

Reading Payment Statement

by kazukinagata in kazukinagata/shinkoku

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

MITAuto-check passedDocuments & Office

Install Reading Payment Statement

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

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

GitHub CLI
$ gh skill install kazukinagata/shinkoku reading-payment-statement --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-payment-statement .claude/skills/reading-payment-statement && 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-payment-statement
GitHub stars
365
Token cost
~487 tokens
SKILL.md length
106 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…
  • Documents & Office work in your project
  • 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 Payment Statement is an agent skill from kazukinagata/shinkoku. 支払調書の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。

Its SKILL.md is about 490 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. The repository describes itself as: 確定申告自動化 AI エージェントプラグイン — 帳簿管理から e-Tax 入力代行まで. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/reading-payment-statement”

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 Payment Statement loads about 487 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 106 words of instructions outside code blocks.

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

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). 106 words, ~487 tokens.

Download SKILL.mdSave it as .claude/skills/reading-payment-statement/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
reading-payment-statement
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(金額)とする
  • 複数ファイルを渡された場合は全て順に処理してまとめて返す

出力フォーマット

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

---PAYMENT_STATEMENT_DATA---
payer_name: 支払者名
category: 区分(報酬/料金/契約金/賞金)
gross_amount: 支払金額(int)
withholding_tax: 源泉徴収税額(int)
---END---

抽出のポイント

  • 「支払金額」欄を最優先で抽出する
  • 「源泉徴収税額」欄を正確に読み取る
  • 支払者の名称を抽出する
  • 区分(報酬、料金、契約金、賞金のいずれか)を確認する
  • 「報酬、料金、契約金及び賞金の支払調書」というタイトルを確認する
  • 支払を受ける者の情報(住所・氏名)も読み取れれば確認用に含める

複数ファイルの処理

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

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

## file2.jpg
---PAYMENT_STATEMENT_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-payment-statement of kazukinagata/shinkoku.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 607574d

Compare with similar skills

Reading Payment Statement 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 Payment Statement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Payment Statement this skillkazukinagata/shinkoku365—~487Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated yesterday
    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 Payment Statement

What does Reading Payment Statement do?

支払調書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku. Reading Payment Statement is an agent skill from kazukinagata/shinkoku.

When should I use Reading Payment Statement?

Reading Payment Statement fits situations like: documents & Office work in your project.

How do I install Reading Payment Statement in Claude Code?

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

How do I install Reading Payment Statement in Codex?

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

Can I use Reading Payment Statement 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-payment-statement -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-payment-statement, .gemini/skills/reading-payment-statement, .github/skills/reading-payment-statement and .opencode/skills/reading-payment-statement in your project.

What does Reading Payment Statement need to run?

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

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

Reading Payment Statement 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 Payment Statement use?

About 487 tokens (SKILL.md is roughly 1.9k 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 Payment Statement?

Skills that share tags, products or a category with Reading Payment Statement: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reading Payment Statement?

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.