furusato SKILL.md skillA

furusato 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/furusato@git:20260909.675d496

Pins git:20260909.675d496 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kazukinagata/shinkoku
Path
skills/furusato/SKILL.md
Versions recorded
6
Latest version
git:20260909.675d496, committed Sep 9, 2026
First version recorded
Feb 15, 2026
Size
11,285 bytes
Repository stars
366
License
MIT

This skill manages furusato nozei (hometown tax) donations. Use when the user wants to register donation data, read donation receipts, check deduction limits, or manage their furusato nozei records. Trigger phrases: "ふるさと納税", "furusato", "寄附金", "寄付金", "ふるさと納税の控除", "寄附金受領証明書", "ワンストップ特例".

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

# ふるさと納税管理(Furusato Nozei Management)

ふるさと納税の寄附金受領証明書を読み取り、寄附データを管理し、控除額を計算するスキル。

## 設定の読み込み(最初に実行)

1. `shinkoku.config.yaml` を Read ツールで読み込む
2. ファイルが存在しない場合は `/setup` スキルの実行を案内して終了する
3. 設定値を把握する:
   - `db_path`: CLI スクリプトの `--db-path` 引数に使用(CWD基準で絶対パスに変換)
   - `tax_year`: 対象年度
   - `furusato_receipts_dir`: 受領証明書の格納ディレクトリ(任意)

## 進捗情報の読み込み

設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。

1. `.shinkoku/progress/progress-summary.md` を Read ツールで読み込む(存在する場合)
2. 以下の引継書を Read ツールで読み込む(存在する場合):
   - `.shinkoku/progress/01-setup.md`
3. 読み込んだ情報を以降のステップで活用する(ユーザーへの再質問を避ける)
4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する

## ステップ1: 受領証明書の画像読み取り

### 1-1. ファイルの確認

`import_data.py furusato-receipt --file-path PATH` でファイルの存在を確認する。

### 1-2. 画像の読み取り

**重要: 画像の読み取りは対応する reading-* スキルに委任する。**

#### 単一の受領証明書の場合

画像ファイルの読み取りには `/reading-receipt` スキルを使用する。
スキルの指示に従い、デュアル検証(2つの独立した読み取り結果の照合)を行って結果を取得する。

**結果照合:** 両方の読み取り結果から `amount`, `date`, `municipality_name` を比較する

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

**不一致の場合:** ユーザーに元画像パスと両方の結果を提示し、正しい方を選択してもらう:
- 差異のあるフィールドを明示する
- A を採用 / B を採用 / 手動入力 の3択を AskUserQuestion で提示する

読み取り結果の `---FURUSATO_RECEIPT_DATA---` ブロックから以下の情報を取得する:

- **自治体名**: 寄附先の市区町村名
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kazukinagata/shinkoku/furusato@sha256:5808745f1bea8632

The line at the top of this page pins the label git:20260909.675d496, 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_2ozralrqbkfiicgb.svg)](https://markdownregistry.com/a/art_2ozralrqbkfiicgb)

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

Versions

The registry has recorded 6 versions of this file, between Feb 15, 2026 and Sep 9, 2026, about one every 41 days.

versioncommittedcommitsizeaudit
git:20260909.675d496 latest2026-09-09 675d496 11,285 BA view · diff
git:20260220.21cd3092026-02-20 21cd309 8,770 BA view · diff
git:20260219.0d59a402026-02-19 0d59a40 8,450 BA view · diff
git:20260217.3f168132026-02-17 3f16813 10,066 BA view · diff
git:20260217.ecf439b2026-02-17 ecf439b 9,751 BA view · diff
git:20260215.789411d2026-02-15 789411d 7,971 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 (11285 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 · 366 stars · license MIT · pushed 2026-09-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2ozralrqbkfiicgb
GET https://markdownregistry.com/api/v1/resolve?ref=kazukinagata/shinkoku/furusato
GET https://markdownregistry.com/api/v1/blob/5808745f1bea8632da6ed85b52907232fa7fd3995d814264d58034bcea02ce5e

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 · 366 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 · 366 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 · 366 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 · 366 stars
e-bookkeeping-compliance SKILL.md skill
kazukinagata/shinkoku · skills/e-bookkeeping-compliance/SKILL.md · 優良な電子帳簿の要件チェック・コンプライアンス診断を実行する。 「優良な電子帳簿」「電帳法対応」「電子帳簿の要件確認」 「税務調査の準備」「75万円控除の条件」「帳簿の要件を満たしているか」 「e-bookkeeping…
git:20260307.724e5a2 · audit A · 366 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 · 366 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 · 366 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 · 366 stars
incorporation SKILL.md skill
kazukinagata/shinkoku · skills/incorporation/SKILL.md · 法人成り(個人事業主から法人への移行)に関する相談。税額比較シミュレーション、 法人形態の選択、設立手続き、役員報酬戦略、社会保険の比較を支援する。 Trigger: "法人成り", "会社設立", "法人化", "株式会社にしたい"…
git:20260220.21cd309 · audit A · 366 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 · 366 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 · 366 stars
reading-deduction-cert SKILL.md skill
kazukinagata/shinkoku · skills/reading-deduction-cert/SKILL.md · 控除証明書(生命保険料・地震保険料等)の画像を読み取り構造化データを返す。 他のスキルから呼び出されるほか、直接ユーザーが呼び出すことも可能。
git:20260224.5f6f2c8 · audit A · 366 stars

Every file in kazukinagata/shinkoku

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