Handles the final submission phase of Japanese tax returns, walking you through verification checklists for income tax and consumption tax filings before you hit submit. It validates your taxpayer profile, flags common mistakes like missing MyNumber entries or miscalculated deductions, then compares e-Tax, mail, and in-person submission methods with concrete tradeoffs. The e-Tax path integrates with Claude in Chrome to auto-fill the official tax portal forms while you review each screen. Includes deadline tracking, payment method guidance, and post-submission tasks like document retention periods. Most useful once you've finished calculations and need systematic verification before filing, especially if you're juggling blue-form accounting or consumption tax obligations.

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

Install

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

Installs into .claude/skills of the current project.

Files

提出準備・チェックリスト(Submission Preparation)

確定申告書類の最終確認と提出方法の案内を行うスキル。 申告書の作成が完了した後の最終ステップとして使用する。

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

  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/07-income-tax.md
    • .shinkoku/progress/08-consumption-tax.md
    • .shinkoku/progress/02-assess.md
  3. 読み込んだ情報を以降のステップで活用する(ユーザーへの再質問を避ける)
  4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する

基本方針

  • 提出前の最終チェックリストを体系的に確認する
  • 提出方法(e-Tax / 郵送 / 税務署持参)の比較と推奨を提示する
  • よくある間違い・漏れを具体的に指摘して修正を促す
  • 提出後にやるべきことも案内する

ステップ0: 納税者プロファイルの検証

profile.py で config から納税者情報を取得し、記入漏れがないか検証する。

shinkoku profile --config shinkoku.config.yaml

検証項目

□ 氏名(姓・名)が登録されているか
□ 住所(郵便番号・都道府県・市区町村・番地)が登録されているか
□ マイナンバーが登録されているか(has_my_number: true)
□ 所轄税務署名が登録されているか
□ 提出方法(e-tax/mail/in-person)が設定されているか

不足している情報がある場合は、ユーザーに補完を案内する(/setup スキルの再実行または config の手動編集)。

Sponsors

Details

Repository
github.com/kazukinagata/shinkoku
Categories
Git & Pull Requests, Code Review & Quality
License
MIT
First seen
Jun 3, 2026

More from kazukinagata/shinkoku

All 24
1davila7 avatargh-fix-cidavila7/claude-code-templatesInspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, then create a fix plan and implement after user approval. Use whe325skills.sh installs
2leonardomso avatarconcept-workflowleonardomso/33-js-conceptsEnd-to-end workflow for creating complete JavaScript concept documentation, orchestrating all skills from research to final review325skills.sh installs
3bmad-code-org avatarbmad-checkpoint-previewbmad-code-org/bmad-methodLLM-assisted human-in-the-loop review. Make sense of a change, focus attention where it matters, test. Use when the user says "checkpoint", "human review", or "324skills.sh installs
4gohypergiant avataraccelint-security-best-practicesgohypergiant/agent-skillsComprehensive security audit and vulnerability detection for JavaScript/TypeScript applications following OWASP Top 10. Use when (1) Users say 'audit security',323skills.sh installs
5shining319 avataracademic-writing-styleshining319/claude-code-single-person-workflowPersonalized academic writing assistant for university assignments in Chinese and English. Use when users need help writing/revising academic reports, project d323skills.sh installs
6webflow avatarbulk-cms-updatewebflow/webflow-skillsCreate or update multiple CMS items in a Webflow collection with validation and diff preview. Use when adding multiple blog posts, products, or updating fields 323skills.sh installs