New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Reading Receipt

by kazukinagata in kazukinagata/shinkoku

レシート・領収書・ふるさと納税受領証明書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku.

MITAuto-check passedDocuments & Office

Install Reading Receipt

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

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

GitHub CLI
$ gh skill install kazukinagata/shinkoku reading-receipt --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-receipt .claude/skills/reading-receipt && 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-receipt
GitHub stars
365
Token cost
~604 tokens
SKILL.md length
120 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 Receipt is an agent skill from kazukinagata/shinkoku. レシート・領収書・ふるさと納税受領証明書の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。

Its SKILL.md is about 600 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-receipt”

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 Receipt loads about 604 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 120 words of instructions outside code blocks.

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

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). 120 words, ~604 tokens.

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

出力フォーマット

レシート・領収書の場合

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

---RECEIPT_DATA---
date: YYYY-MM-DD
vendor: 店舗名
total_amount: 金額（int）
tax_included: true/false
items:
  - name: 品目名
    amount: 金額（int）
    quantity: 数量（int）
---END---
ふるさと納税受領証明書の場合

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

---FURUSATO_RECEIPT_DATA---
municipality_name: 自治体名（市区町村名）
prefecture: 都道府県名
amount: 寄附金額（int）
date: YYYY-MM-DD
receipt_number: 受領証明書番号（記載がなければ UNKNOWN）
---END---

抽出のポイント

レシート・領収書
  • 合計金額（税込）を最優先で抽出する
  • 内税・外税の区別を確認する（「税込」「税抜」の記載）
  • 品目は読み取れる範囲で抽出する（不明な場合は items を空にする）
  • 店舗名はレシート上部のロゴや名称から抽出する
  • 日付はレシート上の取引日を使用する（発行日ではなく）
ふるさと納税受領証明書
  • 「寄附金受領証明書」というタイトルを確認する
  • 自治体名は「○○市」「○○町」「○○村」等の正式名称を抽出する
  • 都道府県名は自治体名の前に記載されていることが多い
  • 寄附金額は「金額」「寄附金額」欄から抽出する
  • 日付は寄附を受領した日（受領日）を使用する
  • 受領証明書番号は「第○○号」等の記載から抽出する

複数ファイルの処理

複数のファイルパスが指示された場合、または Glob パターンでファイル一覧を取得した場合:

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

## file2.jpg
---RECEIPT_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-receipt of kazukinagata/shinkoku.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 607574d

Compare with similar skills

Reading Receipt 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 Receipt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Receipt this skillkazukinagata/shinkoku365—~604Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 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
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.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.

    27k 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.

    781 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

  • Word Document Reader and Writer

    HKUDS/DeepTutor

    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 3 days ago
    Documents & OfficeAuto-check passed

  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k 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

Categories

Questions about Reading Receipt

What does Reading Receipt do?

レシート・領収書・ふるさと納税受領証明書の画像を読み取り構造化データを返す. An agent skill from kazukinagata/shinkoku. Reading Receipt is an agent skill from kazukinagata/shinkoku.

When should I use Reading Receipt?

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

How do I install Reading Receipt in Claude Code?

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

How do I install Reading Receipt in Codex?

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

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

What does Reading Receipt need to run?

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

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

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

About 604 tokens (SKILL.md is roughly 2.4k 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 Receipt?

Skills that share tags, products or a category with Reading Receipt: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 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 Receipt?

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.