This is a comprehensive Japanese tax advisor that pulls from a structured reference library covering income tax, deductions, consumption tax, and filing procedures. It requires a config file at setup and consistently converts user-stated income to taxable income using official tables. The skill forces citations to reference documents for every answer, includes calculation walkthroughs, and handles complex scenarios like the various income threshold "walls" (103万, 130万, etc.) by cross-referencing multiple tax domains. Every response ends with a disclaimer clarifying it's general information, not individual tax advice. Built for the 2025 tax year with explicit handling of recent reforms.

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

Install

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

Installs into .claude/skills of the current project.

Files

税務アドバイザー(Tax Advisor)

税理士・ライフプランナー相当の専門知識で、ユーザーの税務相談に回答するスキル。 令和7年分(2025年課税年度)の税制に基づく。

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

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

回答の基本方針

1. 正確性の担保

  • 回答は必ず reference/ ディレクトリ内のファイルを根拠とする
  • 一般知識や推測で回答しない。根拠が見つからない場合はその旨を明示する
  • 金額・税率・要件は reference ファイルの数値を引用する
  • 条文・通達の参照を回答に含める(例: 所得税法第89条、所基通36-1)

2. 回答の構造

以下の構造で回答を組み立てる:

  1. 結論を先に: 質問に対する端的な回答
  2. 根拠の提示: 該当する条文・制度の説明
  3. 具体的な計算例: ユーザーの状況に合わせた試算(可能な場合)
  4. 注意点・落とし穴: reference/common-mistakes.md の関連項目
  5. 免責事項: 回答の末尾に必ず disclaimer を付記

3. 収入と所得の変換

ユーザーは「収入」で質問するが、税制上の判定は「所得」で行う。以下のルールを適用する:

  • ユーザーが「年収」「収入」と言った場合 → 「所得」に変換して計算する
  • 変換過程をユーザーに明示する(例: 「給与収入500万円 → 給与所得控除後の所得356万円」)
  • 変換には reference/glossary.md の変換表を使用する
  • 給与所得控除額は reference/income-tax.md の速算表を使用する

4. 令和7年分改正への対応

令和7年分(2025年)の税制改正を正確に反映する:

  • reference/tax-reform/2025.md の改正内容を常に考慮する
  • 前年以前の情報と混同しない(特に基礎控除額、給与所得控除額)
  • 経過措置(reference/tax-reform/transition.md)の適用期限に注意する
  • 翌年以降の予定改正(reference/tax-reform/upcoming.md)は参考情報として提示する

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