shinkoku

確定申告を自動化する AI コーディングエージェント向けプラグイン。個人事業主・会社員の所得税・消費税の確定申告を、帳簿の記帳から確定申告書等作成コーナーへの入力代行までエンドツーエンドで支援します。

Claude Code Plugin として動作するほか、SKILL.md オープン標準 に準拠した Agent Skills パッケージとして、Claude Code / Cursor / Windsurf / GitHub Copilot / Gemini CLI / Codex / Cline / Roo Code / Antigravity など 40 以上の AI コーディングエージェントで利用できます。

想定ユーザー

対象	対応レベル	備考
個人事業主（青色申告・一般用）	Full	メインターゲット。帳簿 → 決算書 → 税額計算 → 作成コーナー入力
会社員 + 副業（事業所得）	Full	源泉徴収票 + 事業所得の税額計算 → 作成コーナー入力
給与所得のみ（会社員）	Full	還付申告・医療費控除等 → 作成コーナー入力
消費税課税事業者	Full	2割特例・簡易課税・本則課税すべて対応
ふるさと納税利用者	Full	寄附金 CRUD + 控除計算 + 限度額推定
住宅ローン控除（初年度）	Full	控除額計算（添付書類は別途必要）
医療費控除	Full	明細集計＋控除額計算
仮想通貨トレーダー	Full	雑所得（総合課税）として申告書に自動反映

非対応

以下のケースには対応していません。

対象	理由
株式投資家（分離課税）	株式譲渡所得・配当の分離課税
FX トレーダー	先物取引に係る雑所得等
不動産所得	不動産所得用の決算書・申告
退職所得	退職所得控除の計算
譲渡所得（不動産売却）	長期/短期税率、3,000万円特別控除
外国税額控除	外国税支払額の追跡・控除計算
農業所得・山林所得	専用所得区分
白色申告	青色申告のみ対応
非居住者	日本居住者専用

---

⚠️ 免責事項

確定申告は自己責任で行ってください。

• 本ツールが生成した申告書・計算結果は、提出前に必ずご自身で内容を確認してください
• 税法の解釈や申告内容に不安がある場合は、税理士等の専門家に相談することを強く推奨します
• 本ツールの利用によって生じたいかなる損害についても、開発者は責任を負いません
• 税制は毎年改正されます。本ツールは令和7年分（2025年）と令和8年分（2026年、令和8年度税制改正反映）の所得税・消費税計算に対応しています
• 令和9年分以後について計算に反映済みのもの: 消費税の3割特例（令和9・10年分）、ふるさと納税 特例控除額の193万円上限（令和9年中以後の寄附）、住宅ローン控除の借入限度額（令和12年入居まで）、基礎控除・給与所得控除の令和10年分以後の本則値
• 令和9年分以後について定数・注記のみで計算に未反映のもの: 防衛特別所得税と復興特別所得税1.1%への分割（合計2.1%で税額は不変）、青色申告特別控除の65万/75万への見直し、ひとり親控除38万、公的年金等控除の280万円上限、暗号資産の申告分離課税、基礎控除等の物価連動改定値

---

インストール

前提条件

• Python 3.11 以上
• uv パッケージマネージャ

CLI のインストール

スキルが内部で shinkoku コマンドを呼び出します。通常は /setup スキルが自動でインストールしますが、手動で行う場合は以下を実行してください。

# インストール
uv tool install git+https://github.com/kazukinagata/shinkoku

# 更新
uv tool upgrade shinkoku

Cowork の場合は、チャットで Claude にインストールを依頼してください。

方法 1: Claude Code プラグイン（フル機能）

プラグイン機能を使い、OCR 画像読取を含む全機能を利用できます。

# マーケットプレイスを追加
/plugin marketplace add kazukinagata/shinkoku

# プラグインをインストール
/plugin install shinkoku@shinkoku

方法 2: スキルのみインストール（40+ エージェント対応）

skills CLI でスキルをインストールできます。

# スキルのインストール（インストール先エージェントを対話的に選択）
npx skills add kazukinagata/shinkoku

# 特定のエージェントにグローバルインストール
npx skills add kazukinagata/shinkoku -g -a claude-code -a cursor

# インストール可能なスキル一覧を確認
npx skills add kazukinagata/shinkoku --list

環境別の補足

環境	設定方法
Claude Code	/plugin marketplace add kazukinagata/shinkoku → /plugin install shinkoku@shinkoku
Cowork	プラグイン > 個人用 > GitHub からマーケットプレイスを追加 > kazukinagata/shinkoku を入力してマーケットプレイスを追加し、その後表示される shinkoku プラグインをインストール
その他	npx skills add kazukinagata/shinkoku でインストール（方法 2 を参照）

ブラウザ自動化（e-Tax に必要）

/e-tax スキルでは、確定申告書等作成コーナーへの入力にブラウザ自動化が必要です。以下の3方式に対応しています。

方式	対象環境	備考
Claude in Chrome（推奨）	Windows / macOS のネイティブ Chrome	Claude in Chrome 拡張機能が必要
Antigravity Browser Sub-Agent	Windows / macOS / Linux	Antigravity IDE のブラウザ操作機能を利用
Playwright CLI（β版）	WSL / Linux 等	@playwright/cli のインストールが必要

Claude in Chrome の有効化（Claude Code）

Claude in Chrome を利用するには、Claude Code 起動時にフラグを付けるか、セッション内でコマンドを実行します。

# 起動時に有効化
claude --chrome

# セッション内で有効化
/chrome

Playwright CLI のインストール

Claude in Chrome, Antigravity を利用する場合このステップは不要です。