From shinkoku
Interactively assesses required Japanese tax filings (確定申告, 消費税, 住民税) by interviewing on income, business status, prior returns, stocks/FX/crypto details.
npx claudepluginhub kazukinagata/shinkoku --plugin shinkokuThis skill uses the workspace's default tool permissions.
確定申告が必要かどうか、どの種類の申告が必要かを対話的に判定するスキル。
Provides Japanese tax advice on deductions, filings, business expenses, and 2025 rules using reference files for accurate consultations.
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.
Automates NZ IR3 individual income tax return filing for 2026 tax year via myIR portal browser automation. Uses pre-populated data, pauses for user login and explicit submit confirmation.
Share bugs, ideas, or general feedback.
確定申告が必要かどうか、どの種類の申告が必要かを対話的に判定するスキル。 ユーザーの収入状況・家族構成・事業状況をヒアリングし、必要な申告を特定する。
shinkoku.config.yaml を Read ツールで読み込む/setup スキルの実行を案内して終了するdb_path: CLI スクリプトの --db-path 引数に使用output_dir: 進捗ファイル等の出力先ベースディレクトリ設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。
.shinkoku/progress/progress-summary.md を Read ツールで読み込む（存在する場合）.shinkoku/progress/01-setup.md以下の情報を対話で収集する。一度にすべてを聞かず、自然な会話の流れで段階的に確認する。
事業所得がある場合（開業2年目以降）、前年の確定申告内容を確認する。
config の past_returns_dir にファイルがあれば参照する。
前年の申告納税額（㊺欄）が 15万円以上 の場合:
予定納税を納付済みの場合、確定申告書 ㊹欄「源泉徴収税額」に加算する。
前年以前3年以内に青色申告で純損失がある場合:
以下の収入の有無をすべて順に確認する（項目数が多い場合は複数回に分けること）:
株式・配当収入がある場合、以下を確認する:
FX取引がある場合、以下を確認する:
暗号資産の取引がある場合、以下を確認する:
以下の項目をすべて確認する。項目数が多いため、2回に分けて確認すること。
住宅の取得・リフォームが判明した場合、以下を追加で確認する。
※「中古住宅を購入してリフォームも実施」はよくあるパターンのため、必ず複数選択を許可すること。 中古取得+リフォームの場合、それぞれで住宅ローン控除の借入限度額が異なる可能性がある。
→ 詳細な控除額の判定は /tax-housing-loan-context を実行する
ステップ2の判定に進む前に、以下のすべてを確認済みであること。未確認の項目があればユーザーに追加質問する。
収集した情報に基づき、以下のフローチャートで判定する。
Q1. 給与所得者ですか？
├── Yes → Q2へ
└── No → Q5へ
Q2. 給与収入は2,000万円を超えますか？
├── Yes → 【確定申告必要】（所得税法第121条第1項）
└── No → Q3へ
Q3. 給与を2か所以上から受けていますか？
├── Yes → 主たる給与以外の収入が20万円を超えるか確認 → Q4へ
└── No → Q4へ
Q4. 給与所得・退職所得以外の所得が20万円を超えますか？
├── Yes → 【確定申告必要】（所得税法第121条第1項第2号）
└── No → Q6へ
Q5. 事業所得・不動産所得等がありますか？
├── Yes → 所得金額が基礎控除+所得控除の合計を超えるか？
│ ├── Yes → 【確定申告必要】
│ └── No → 【確定申告不要】（ただし損失繰越のために申告する場合あり）
└── No → 各所得の合計で判定
Q6. 以下のいずれかに該当しますか？
- 医療費控除を受けたい
- ふるさと納税でワンストップ特例を使わない/使えない
- 住宅ローン控除の初年度
- 雑損控除を受けたい
- 年末調整で申告漏れした控除がある
├── Yes → 【確定申告した方が有利（還付申告）】
└── No → 【確定申告不要】
以下に該当する場合は確定申告不要であることを明示する:
副業所得20万円以下で所得税の確定申告が不要でも、以下の場合は申告が必要:
分離課税（株式・FX の第三表）の計算・帳票生成は対象外。 株式取引・FX取引がある場合は税理士への相談を案内する。 仮想通貨は雑所得（総合課税）として所得税スキルで取り扱う。
Q1. 事業収入（売上）がありますか？
├── No → 【消費税申告不要】
└── Yes → Q2へ
Q2. 基準期間（2年前: 令和5年）の課税売上高が1,000万円を超えますか？
├── Yes → 【課税事業者】→ 消費税申告必要
└── No → Q3へ
Q3. 特定期間（前年1-6月: 令和6年1-6月）の課税売上高または
給与支払額が1,000万円を超えますか？
├── Yes → 【課税事業者】→ 消費税申告必要
└── No → Q4へ
Q4. 適格請求書発行事業者（インボイス登録）をしていますか？
├── Yes → 【課税事業者（インボイス登録による）】→ 消費税申告必要
│ → 2割特例の適用可否を確認（令和8年9月30日までの経過措置）
└── No → 【免税事業者】→ 消費税申告不要
課税事業者と判定された場合、以下の申告方法を判定する:
Q1. 2割特例の適用要件を満たすか？
（インボイス登録により課税事業者になった者で、基準期間の課税売上が1,000万円以下）
├── Yes → 2割特例が最も有利な場合が多い。簡易課税・本則課税との比較を提案
└── No → Q2へ
Q2. 基準期間の課税売上高が5,000万円以下で、簡易課税の届出をしているか？
├── Yes → 簡易課税で申告
└── No → 本則課税で申告
Q1. 確定申告を行いますか？
├── Yes → 住民税の申告は不要（確定申告データが市区町村に送付される）
└── No → Q2へ
Q2. 給与所得のみで年末調整済みですか？
├── Yes → Q3へ
└── No → 【住民税の申告が必要】
Q3. 給与以外の所得がありますか？（20万円以下を含む）
├── Yes → 【住民税の申告が必要】（所得税では不要でも住民税は必要）
└── No → 住民税の申告は不要（給与支払報告書が提出されている）
副業がある給与所得者には以下を確認する:
すべての判定が完了したら、以下の形式で結果をまとめて提示する:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
申告要否・種類の判定結果
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 所得税の確定申告: [必要 / 不要 / 還付申告推奨]
根拠: [該当条文・理由]
■ 分離課税: 対象外（該当する場合は税理士への相談を案内）
■ 消費税の申告: [必要 / 不要]
課税事業者区分: [課税事業者 / 免税事業者]
申告方法: [2割特例 / 簡易課税 / 本則課税]
■ 住民税の申告: [不要（確定申告で対応） / 別途必要]
■ shinkoku 対応状況:
対応レベル: [Full / Partial / Out]
[Partial/Out の場合: 未対応の項目と対応方法を記載]
■ 次のステップ:
→ gather スキルで必要書類を確認する
→ [その他の推奨アクション]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
サマリー提示後、以下のファイルを Write ツールで出力する。 これにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。
.shinkoku/progress/02-assess.md に以下の形式で出力する:
---
step: 2
skill: assess
status: completed
completed_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---
# 申告要否・種類の判定結果
## 判定結果
- 所得税の確定申告: {必要/不要/還付申告推奨}（{根拠}）
- 消費税の申告: {必要/不要}
- 住民税の申告: {不要（確定申告で対応）/別途必要}
- 青色申告特別控除: {65万円/10万円}（{根拠}）
## 収入の概要
- 給与収入: {あり/なし}（{詳細}）
- 事業収入: {あり/なし}（{詳細}）
- 株式取引: {あり/なし}（{口座種類、概算損益}）
- FX取引: {あり/なし}（{概算損益}）
- 仮想通貨: {あり/なし}（{概算損益}）
- 雑所得: {あり/なし}（{詳細}）
- 配当所得: {あり/なし}（{課税方式: 総合/分離/申告不要}）
- 一時所得: {あり/なし}（{詳細}）
- その他の収入: {該当する収入があれば記載}
## 分離課税
- 対象外（該当する場合は税理士への相談を案内済み）
## 予定納税
- 前年の申告納税額（㊺欄）: {金額}円
- 予定納税額: {金額}円（第1期・第2期 各{金額}円、{納付済み/未納付}）
## 純損失の繰越控除
- 繰越控除の有無: {あり/なし}
- 繰越損失額: {金額}円（{損失発生年度}）
## 消費税の詳細
- 課税事業者区分: {課税事業者/免税事業者}（{根拠}）
- 基準期間の課税売上高: {金額}万円
- 適用可能な方法: {2割特例/簡易課税/本則課税}
## 次のステップ
/gather で必要書類を確認する
.shinkoku/progress/progress-summary.md を更新する（存在しない場合は新規作成）:
ファイルを出力したらユーザーに以下を伝える:
.shinkoku/progress/ に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」詳細な判定ロジックは上記のステップを参照。
判定結果の提示時に以下を必ず付記する: