reading-withholding SKILL.md skillA

reading-withholding from kazukinagata/shinkoku is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kazukinagata/shinkoku/reading-withholding@git:20260224.5f6f2c8

Pins git:20260224.5f6f2c8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kazukinagata/shinkoku
Path
skills/reading-withholding/SKILL.md
Versions recorded
2
Latest version
git:20260224.5f6f2c8, committed Feb 24, 2026
First version recorded
Feb 19, 2026
Size
4,795 bytes
Repository stars
367
License
MIT

源泉徴収票の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 源泉徴収票 画像読み取り

源泉徴収票の画像を読み取り、構造化データとして返すスキル。

## 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(金額)とする
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kazukinagata/shinkoku/reading-withholding@sha256:869065eb703ca80d

The line at the top of this page pins the label git:20260224.5f6f2c8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xmfkjlskvn2kuxob.svg)](https://markdownregistry.com/a/art_xmfkjlskvn2kuxob)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Feb 19, 2026 and Feb 24, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260224.5f6f2c8 latest2026-02-24 5f6f2c8 4,795 BA view · diff
git:20260219.0d59a402026-02-19 0d59a40 4,243 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4795 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kazukinagata/shinkoku · 367 stars · license MIT · pushed 2026-09-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xmfkjlskvn2kuxob
GET https://markdownregistry.com/api/v1/resolve?ref=kazukinagata/shinkoku/reading-withholding
GET https://markdownregistry.com/api/v1/blob/869065eb703ca80da3abf4bbc8dd9a7ff711e03b1bb126a1890a4c132c5b9bff

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kazukinagata/shinkoku

CLAUDE.md CLAUDE.md file
kazukinagata/shinkoku · CLAUDE.md
git:20260909.675d496 · audit A · 367 stars
assess SKILL.md skill
kazukinagata/shinkoku · skills/assess/SKILL.md · This skill should be used when the user asks to determine what tax filings they need, wants to know if they must file a…
git:20260307.724e5a2 · audit A · 367 stars
capabilities SKILL.md skill
kazukinagata/shinkoku · skills/capabilities/SKILL.md · Display shinkoku's current capabilities, supported personas, and known limitations. Use when the user asks "what can…
git:20260220.296d9e9 · audit A · 367 stars
consumption-tax SKILL.md skill
kazukinagata/shinkoku · skills/consumption-tax/SKILL.md · This skill should be used when the user needs to calculate consumption tax (消費税) or determine their tax method (2割特例…
git:20260909.675d496 · audit A · 367 stars
e-bookkeeping-compliance SKILL.md skill
kazukinagata/shinkoku · skills/e-bookkeeping-compliance/SKILL.md · 優良な電子帳簿の要件チェック・コンプライアンス診断を実行する。 「優良な電子帳簿」「電帳法対応」「電子帳簿の要件確認」 「税務調査の準備」「75万円控除の条件」「帳簿の要件を満たしているか」 「e-bookkeeping…
git:20260307.724e5a2 · audit A · 367 stars
e-tax SKILL.md skill
kazukinagata/shinkoku · skills/e-tax/SKILL.md · This skill should be used when the user wants to file their tax return electronically via the 確定申告書等作成コーナー (NTA Tax…
git:20260303.f875239 · audit A · 367 stars
furusato SKILL.md skill
kazukinagata/shinkoku · skills/furusato/SKILL.md · This skill manages furusato nozei (hometown tax) donations. Use when the user wants to register donation data, read…
git:20260909.675d496 · audit A · 367 stars
gather SKILL.md skill
kazukinagata/shinkoku · skills/gather/SKILL.md · This skill should be used when the user needs to know what documents to collect for their tax filing, wants a checklist…
git:20260307.724e5a2 · audit A · 367 stars
income-tax SKILL.md skill
kazukinagata/shinkoku · skills/income-tax/SKILL.md · This skill should be used when the user needs to calculate their income tax (所得税), compute deductions, or import…
git:20260909.675d496 · audit A · 367 stars
incorporation SKILL.md skill
kazukinagata/shinkoku · skills/incorporation/SKILL.md · 法人成り(個人事業主から法人への移行)に関する相談。税額比較シミュレーション、 法人形態の選択、設立手続き、役員報酬戦略、社会保険の比較を支援する。 Trigger: "法人成り", "会社設立", "法人化", "株式会社にしたい"…
git:20260220.21cd309 · audit A · 367 stars
invoice-system SKILL.md skill
kazukinagata/shinkoku · skills/invoice-system/SKILL.md · This skill should be used when the user asks about the invoice system (インボイス制度), qualified invoices (適格請求書)…
git:20260307.724e5a2 · audit A · 367 stars
journal SKILL.md skill
kazukinagata/shinkoku · skills/journal/SKILL.md · This skill should be used when the user wants to record bookkeeping entries (仕訳), import transaction data from CSV…
git:20260220.296d9e9 · audit A · 367 stars

Every file in kazukinagata/shinkoku

Browse by kind, by grade A, or by owner.