This is a Japanese tax filing assessment system that walks users through determining their filing obligations for income tax, consumption tax, and resident tax. It's built around a conversational interview process that checks eligibility for different filing types, handles edge cases like stock trading in multiple account types, cryptocurrency gains, and housing loan deductions, then outputs structured markdown files so other skills can pick up where it left off. The prompts are extremely detailed, with specific instructions about multi-select questions when items aren't mutually exclusive and explicit checklists to prevent skipping items. It's designed for the Japanese tax system specifically, referencing actual tax codes and handling things like the 200,000 yen副業 threshold and invoice registration requirements. If you need to build a stateful multi-step interview system with handoffs, the progress file architecture here is worth studying.

skills.sh installs
339
GitHub stars
368
last updated
Aug 21, 2026

Install

$ npx -y skills add kazukinagata/shinkoku --skill assess --agent claude-code

Installs into .claude/skills of the current project.

Files

申告要否・種類の判定(Tax Filing Assessment)

確定申告が必要かどうか、どの種類の申告が必要かを対話的に判定するスキル。 ユーザーの収入状況・家族構成・事業状況をヒアリングし、必要な申告を特定する。

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

  1. shinkoku.config.yaml を Read ツールで読み込む
  2. ファイルが存在しない場合は /setup スキルの実行を案内して終了する
  3. 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する:
    • db_path: CLI スクリプトの --db-path 引数に使用
    • output_dir: 進捗ファイル等の出力先ベースディレクトリ
    • 各ディレクトリ: ファイル参照時に使用

進捗情報の読み込み

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

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

判定の基本方針

  • ユーザーが「収入」で話す場合、内部的に「所得」に変換して判定を行う
  • 判定は所得税 → 消費税 → 住民税の順序で実施する
  • 各判定で根拠となる条文・通達を示す
  • 判定結果は最後にサマリーとして一覧提示する
  • 不明な点がある場合は追加質問で確認する(推測で判定しない)

ヒアリング時の質問設計ルール

  • チェックリストの項目はすべて漏れなく確認すること。ツールの選択肢数制限(AskUserQuestionは1問あたり最大4選択肢)のために項目を省略してはならない。項目数が多い場合は複数回に分けて確認する
  • 1つの事象に複数の側面がある場合(例: 中古住宅を購入してリフォームも実施)は、**複数選択可能(multiSelect: true)**にするか、組み合わせパターンを選択肢に含める
  • 選択肢を設計する前に、その項目が排他的(1つだけ選ぶ)か並立的(複数該当しうる)かを判断する

ステップ1: 基本情報ヒアリング

以下の情報を対話で収集する。一度にすべてを聞かず、自然な会話の流れで段階的に確認する。

1-0. 前年の確定申告の確認

Sponsors

Details

Repository
github.com/kazukinagata/shinkoku
License
MIT
First seen
Jun 3, 2026

More from kazukinagata/shinkoku

All 24

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs