From shinkoku
Provides checklists of required documents for Japanese tax filings, with sources, methods, and shinkoku import instructions, based on assess skill results.
npx claudepluginhub kazukinagata/shinkoku --plugin shinkokuThis skill uses the workspace's default tool permissions.
確定申告に必要な書類を、申告の種類に基づいて一覧化し、各書類の取得先・取得方法を案内するスキル。
Interactively assesses required Japanese tax filings (確定申告, 消費税, 住民税) by interviewing on income, business status, prior returns, stocks/FX/crypto details.
Advises on US taxes for W-2, 1099, S-Corp filers: identifies deductions, logs expenses to JSON, assesses audit risk, optimizes brackets, plans estimated payments, handles multi-state filing and life events.
Prepares federal and state tax returns by extracting data from source documents, computing taxes, and filling official PDF forms.
Share bugs, ideas, or general feedback.
確定申告に必要な書類を、申告の種類に基づいて一覧化し、各書類の取得先・取得方法を案内するスキル。 assess スキルの判定結果を前提として動作する。判定結果がない場合は、まず assess スキルの実行を促す。
shinkoku.config.yaml を Read ツールで読み込む/setup スキルの実行を案内して終了するdb_path: CLI スクリプトの --db-path 引数に使用output_dir: 進捗ファイル等の出力先ベースディレクトリ設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。
.shinkoku/progress/progress-summary.md を Read ツールで読み込む(存在する場合).shinkoku/progress/02-assess.mdassess スキルの判定結果から以下を確認する:
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| マイナンバーカード(または通知カード + 本人確認書類) | 市区町村窓口 | 交付申請済みなら手元にある | e-Tax利用時はICカードリーダーまたはスマホ |
| 確定申告書(第一表・第二表) | 国税庁 | e-Taxで作成 or 税務署で入手 | shinkokuで自動生成可能 |
| 銀行口座情報 | -- | 手元の通帳・キャッシュカード | 還付金の振込先 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 源泉徴収票 | 勤務先の経理部門 | 12月〜1月に交付される | 2か所以上の勤務先がある場合は各社から取得 |
| 給与明細(任意) | 勤務先 | 毎月交付されたもの | 源泉徴収票の数値確認用 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 青色申告決算書(青色の場合) | -- | shinkokuで自動生成 | 損益計算書 + 貸借対照表 |
| 収支内訳書(白色の場合) | 国税庁 | e-Taxで作成 | -- |
| 売上の根拠資料(請求書控え等) | 手元 | 年間の請求書・契約書を整理 | 取引先別に月別集計できるとよい |
| 経費の根拠資料 | 手元 | レシート・領収書・クレカ明細 | shinkokuの journal スキルで取込可能 |
| クレジットカード明細(CSV) | カード会社Webサイト | ダウンロード | import_data.py csv で取込可能 |
| 銀行口座の取引明細 | 銀行のWebサイト | ダウンロード or 通帳記帳 | 事業用口座 |
| 支払調書 | 取引先 | 取引先から1月末までに交付 | import_data.py payment-statement で取込可能 |
| 開業届の控え(任意) | 手元 or 税務署 | 提出時の控え | 開業日の確認用 |
| 青色申告承認申請書の控え(任意) | 手元 or 税務署 | 提出時の控え | 青色申告の承認確認用 |
報酬・料金の支払いに対して源泉徴収された場合、取引先から支払調書を受け取る。
import_data.py payment-statement --file-path PATH で PDF/画像からデータ抽出ledger.py add-business-withholding --db-path DB --input FILE で取引先別に登録| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 消費税申告書 | -- | shinkokuで自動生成 | 2割特例/簡易課税/本則課税に対応 |
| 課税売上・仕入の集計表 | -- | 帳簿から自動集計 | 税率区分別(10%/8%) |
| インボイス登録番号 | 国税庁 | 適格請求書発行事業者公表サイトで確認 | T + 13桁の番号 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 医療費の領収書 | 各医療機関 | 受診時に受け取る | 提出不要だが5年間保存義務 |
| 医療費のお知らせ(医療費通知) | 健康保険組合 | 毎年2月頃に届く or マイナポータル | e-Taxで自動取込可能 |
| 医療費控除の明細書 | -- | 領収書から作成 | 医療費通知があれば明細書の記載を省略可 |
| 保険金等で補填された金額の明細 | 保険会社 | 支払通知書 | 医療費から差し引く必要あり |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 寄附金受領証明書 | 各自治体 | 寄附後に郵送される | ワンストップ特例を使った分も確定申告時は証明書が必要 |
| 寄附金控除に関する証明書(まとめ版) | ふるさと納税サイト | マイナポータル or サイトからDL | 複数自治体分を1枚にまとめた証明書。e-Tax対応 |
| 書類 | 取得先 | 取得方法 | 期間目安 |
|---|---|---|---|
| 住宅借入金等特別控除額の計算明細書 | 国税庁 | e-Taxで作成 or 税務署で入手 | -- |
| 住宅取得資金に係る借入金の年末残高等証明書 | 金融機関 | 10月〜11月頃に郵送 | 届かない場合は金融機関に連絡 |
| 登記事項証明書(建物・土地) | 法務局 | 不動産番号の記載で省略可(推奨)/ 写しの提出 / 窓口・オンライン申請 | 不動産番号なら取得不要(0円)。令和3年度改正により、計算明細書に不動産番号(13桁)を記載すれば添付省略可。不動産番号は登記識別情報通知・固定資産税の課税明細書・売買契約書の重要事項説明書で確認できる |
| 売買契約書または工事請負契約書の写し | 手元 | 購入時の契約書 | 取得価額の確認用 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 国民年金保険料控除証明書 | 日本年金機構 | 10月〜11月に郵送 | 年末調整で使用済みなら不要 |
| 国民健康保険料の納付額 | 市区町村 | 納付額通知書 or 窓口で確認 | 証明書の添付は不要だが金額把握が必要 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 生命保険料控除証明書 | 保険会社 | 10月〜11月に郵送 | 年末調整で使用済みなら不要 |
| 地震保険料控除証明書 | 保険会社 | 10月〜11月に郵送 | 同上 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 小規模企業共済等掛金払込証明書 | 国民年金基金連合会 or 中小企業基盤整備機構 | 10月〜11月に郵送 | iDeCoの場合は国民年金基金連合会 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| スイッチOTC医薬品の購入レシート | 薬局・ドラッグストア | 購入時に受け取る | レシートに★マーク等で対象品目が表示 |
| 特定健康診査等の結果通知表 | 健保組合・市区町村 | 受診後に交付 | セルフメディケーション適用の必須要件 |
注意: 医療費控除とセルフメディケーション税制は併用不可。有利な方を選択する。
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 特定口座年間取引報告書 | 証券会社 | 1月中旬〜下旬に郵送またはWeb | 特定口座(源泉あり)でも確定申告で損益通算可 |
| 配当金の支払通知書 | 証券会社 | 配当支払時に交付 | 総合課税/分離課税/申告不要の選択に必要 |
| 上場株式等の取引残高報告書 | 証券会社 | 各社Webサイト | 一般口座の場合に必要 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 先物取引に係る年間損益報告書 | FX業者 | 1月中に郵送またはWeb | 先物取引に係る雑所得等として分離課税 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 年間取引報告書 | 暗号資産交換業者 | 各社Webサイトからダウンロード | 雑所得(総合課税)として申告 |
| 暗号資産の計算書(総平均法等) | 国税庁 | Excelテンプレートをダウンロード | 移動平均法または総平均法で計算 |
| 書類 | 取得先 | 取得方法 | 備考 |
|---|---|---|---|
| 報酬の支払調書 | 税理士・弁護士事務所 | 翌年1月末までに交付 | 確定申告書第二表に記載 |
以下のスケジュールで書類収集を進めることを推奨する:
【10月〜11月】各種控除証明書の到着期間
□ 生命保険料控除証明書
□ 地震保険料控除証明書
□ 国民年金保険料控除証明書
□ iDeCo/小規模企業共済の払込証明書
□ 住宅ローンの年末残高等証明書
【12月〜1月】年末調整と源泉徴収票
□ 源泉徴収票の受領(勤務先から)
□ ふるさと納税の寄附金受領証明書
【1月〜2月】申告準備
□ 医療費のお知らせ(健康保険組合から)
□ クレカ明細CSVのダウンロード(年間分)
□ 経費レシート・領収書の整理
□ 不動産番号の確認 or 登記事項証明書の取得(住宅ローン控除初年度。不動産番号を計算明細書に記載すれば登記事項証明書は不要)
□ 特定口座年間取引報告書(証券会社から、該当者のみ)
□ FX年間損益報告書(FX業者から、該当者のみ)
□ 暗号資産年間取引報告書(取引所から、該当者のみ)
□ セルフメディケーションOTC購入レシートの集計(該当者のみ)
【2月16日〜3月15日】確定申告期間
※ 還付申告は1月1日から提出可能
※ 消費税の申告期限は3月31日
マイナポータルやe-Taxで電子的に取得できる書類を優先的に案内する:
書類が手元にない場合の対処方法を案内する:
すべての書類が揃ったことを確認し、次のステップを案内する:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
書類収集チェックリスト - 収集状況
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✓] マイナンバーカード
[✓] 源泉徴収票
[✓] クレカ明細CSV
[✓] 経費レシート・領収書
[✓] ふるさと納税 寄附金受領証明書
[✓] 住宅ローン年末残高証明書
[✓] 登記事項証明書 or 不動産番号の確認
[ ] 医療費のお知らせ(2月届き次第)
[✓] 特定口座年間取引報告書(該当者のみ)
[✓] FX年間損益報告書(該当者のみ)
[✓] 暗号資産年間取引報告書(該当者のみ)
[✓] セルフメディケーション購入レシート(該当者のみ)
■ 次のステップ:
→ journal スキルで仕訳入力を開始する
→ tax-advisor スキルで控除の相談をする
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
サマリー提示後、以下のファイルを Write ツールで出力する。 これにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。
.shinkoku/progress/03-gather.md に以下の形式で出力する:
---
step: 3
skill: gather
status: completed
completed_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---
# 書類収集結果
## 必要書類チェックリスト
- [x] {収集済み書類名}
- [ ] {未収集書類名}
(申告種類に応じた全書類を状態付きで列挙する)
## 収集済みファイル一覧
- {書類名}: {ファイルパス}
(収集済みの各書類のファイルパスを記載する)
## 未収集書類の対応方針
- {未収集書類名}: {対応方針(例: 2月届き次第追加、勤務先に再発行依頼中)}
## 次のステップ
/journal で仕訳入力を開始する
.shinkoku/progress/progress-summary.md を更新する(存在しない場合は新規作成):
ファイルを出力したらユーザーに以下を伝える:
.shinkoku/progress/ に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」