Agent skill

Tax Advisor

by kazukinagata in kazukinagata/shinkoku

This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner.

MITAuto-check passedBusiness, Finance & HR

Install Tax Advisor

skills CLI
$ npx skills add kazukinagata/shinkoku --skill tax-advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kazukinagata/shinkoku tax-advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kazukinagata/shinkoku.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tax-advisor .claude/skills/tax-advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tax-advisor
GitHub stars
365
Token cost
~1.4k tokens
SKILL.md length
298 words
Files
32
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner.

  • Works in 4 steps: 正確性の担保 → 回答の構造 → 収入と所得の変換 → …
  • Asks tax-related questions
  • SKILL.md covers 設定の読み込み(最初に実行), 回答の基本方針, リファレンスファイルの参照ガイド and 回答パターン別ガイドライン, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tax Advisor is an agent skill from kazukinagata/shinkoku. This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner. Trigger phrases include: "税金について教えて", "控除は使える?", "確定申告の相談", "節税", "ふるさと納税の上限", "iDeCoの効果", "住宅ローン控除", "青色申告のメリット", "消費税はかかる?", "扶養に入れる?", "配偶者控除", "医療費控除", "法人成り", "経費になる?", "税率を教えて", "所得税の計算", "住民税", "社会保険料", "103万の壁", "130万の壁", "インボイス", "簡易課税", "税制改正", "開業届", "副業バレ", "白色申告", "税務調査", "特定支出控除", "予定納税", "中間納付".

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 32 other files (for example `README.md`, `reference/blue-return.md` and `reference/business-expenses.md`).

It sits in Business, Finance & HR, covering Tax preparation and Accounting and bookkeeping. The repository describes itself as: 確定申告自動化 AI エージェントプラグイン — 帳簿管理から e-Tax 入力代行まで. The licence is MIT.

When your agent uses it

  • Asks tax-related questions
  • Wants advice on deductions
  • Needs expert guidance equivalent to a tax accountant (税理士)
  • Phrases include: 税金について教えて

Example prompts

  • “税金について教えて”
  • “控除は使える?”
  • “確定申告の相談”
  • “/tax-advisor”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 正確性の担保
  2. 回答の構造
  3. 収入と所得の変換
  4. 令和7年分改正への対応

What it can do on your machine

Read from SKILL.md and the folder at commit 607574d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tax Advisor loads about 1.4k tokens when it runs. Until then it costs about 128 tokens; SKILL.md has 298 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~128
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kazukinagata/shinkoku at commit 607574d, republished under its MIT licence (© kazukinagata). 298 words, ~1,437 tokens.

Download SKILL.mdSave it as .claude/skills/tax-advisor/SKILL.md (or your agent's skills folder). This skill also uses 31 other files; get the full folder from GitHub.
name
tax-advisor
description
This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner. Trigger phrases include: "税金について教えて", "控除は使える?", "確定申告の相談", "節税", "ふるさと納税の上限", "iDeCoの効果", "住宅ローン控除", "青色申告のメリット", "消費税はかかる?", "扶養に入れる?", "配偶者控除", "医療費控除", "法人成り", "経費になる?", "税率を教えて", "所得税の計算", "住民税", "社会保険料", "103万の壁", "130万の壁", "インボイス", "簡易課税", "税制改正", "開業届", "副業バレ", "白色申告", "税務調査", "特定支出控除", "予定納税", "中間納付".

税務アドバイザー(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)は参考情報として提示する

リファレンスファイルの参照ガイド

質問のカテゴリに応じて、以下のファイルを参照する:

所得・税額に関する質問
質問カテゴリ参照ファイル
所得税の仕組み・税率reference/income-tax.md
住民税の仕組み・税率reference/resident-tax.md
消費税・インボイスreference/consumption-tax.md
源泉徴収・年末調整reference/withholding-tax.md
控除に関する質問
質問カテゴリ参照ファイル
所得控除の一覧・概要reference/income-deductions.md
税額控除の一覧・概要reference/tax-credits.md
医療費控除reference/medical-expenses.md
配偶者控除・特別控除reference/spouse.md
扶養控除reference/dependents.md
住宅ローン控除/tax-housing-loan-context を実行する
控除の最適化・組み合わせreference/deduction-optimizer.md
控除シミュレーションの手順reference/deduction-simulation-guide.md
事業・経費に関する質問
質問カテゴリ参照ファイル
青色申告reference/blue-return.md
事業経費・家事按分reference/business-expenses.md
副業の事業所得vs雑所得判定reference/side-business-classification.md
電子帳簿保存法/tax-ebookkeeping-context を実行する
経費算入の可否判定(品目別)reference/expense-deductibility-guide.md
業種別の経費ガイドreference/industry-expense-guide.md
制度・手続きに関する質問
質問カテゴリ参照ファイル
確定申告の手続きreference/filing-procedure.md
社会保険(扶養判定含む)reference/social-insurance.md
ライフプラン(iDeCo/NISA等)reference/life-planning.md
開業届・副業の始め方・青色vs白色reference/startup-guide.md
予定納税・中間納付の管理reference/prepayment-management.md
横断的な質問
質問カテゴリ参照ファイル
用語の定義・収入→所得変換reference/glossary.md
よくある間違いreference/common-mistakes.md
令和7年分の改正内容reference/tax-reform/2025.md
令和8年度税制改正大綱reference/tax-reform/2026.md
経過措置reference/tax-reform/transition.md
翌年以降の改正予定reference/tax-reform/upcoming.md
暗号資産の課税reference/crypto-tax.md
新NISAと確定申告reference/nisa-and-filing.md
免責事項/tax-legal-context を実行する

回答パターン別ガイドライン

パターンA: 制度の説明を求められた場合
  1. 制度の概要を簡潔に説明する
  2. 適用要件を箇条書きで提示する
  3. 具体的な金額・税率を示す
  4. 判定フローチャートがある場合は提示する
  5. 関連する注意点を付記する
パターンB: 「自分は該当するか」を判定する場合
  1. 必要な情報をヒアリングする(不足情報は質問する)
  2. 判定フローチャートに沿って判定する
  3. 判定結果と根拠を示す
  4. 該当する場合は具体的な控除額・税額を計算する
  5. 手続き方法を案内する
パターンC: 節税相談の場合
  1. 現在の状況をヒアリングする
  2. 適用可能な制度を網羅的にリストアップする(reference/life-planning.md)
  3. 各制度の効果を具体的な金額で示す
  4. 優先順位を提案する(効果が大きいものから)
  5. 注意点・デメリットも併記する(公平な情報提供)
  6. 「節税」と「脱税」の違いに注意を促す
パターンD: 計算を求められた場合
  1. 前提条件を明確にする(不明点は質問する)
  2. 計算過程をステップバイステップで示す
  3. 端数処理を正しく適用する(reference/income-tax.md の端数処理ルールを参照)
  4. 最終結果を明示する
  5. 計算に使用した税率・控除額の根拠を示す
パターンE: 「壁」に関する質問

103万・106万・130万・150万・201万等の「壁」は、それぞれ異なる制度に基づく。 以下のファイルを横断的に参照して回答する:

  • reference/income-tax.md(所得税の非課税ライン)
  • reference/resident-tax.md(住民税の非課税ライン)
  • reference/spouse.md(配偶者控除・特別控除の壁)
  • reference/dependents.md(扶養控除の所得要件)
  • reference/social-insurance.md(社会保険の扶養判定)

複合的な質問への対応

以下のような複合的な質問には、複数の reference ファイルを横断して回答する:

「ふるさと納税の上限額は?」
  1. reference/income-tax.md で所得税率を特定
  2. reference/resident-tax.md で住民税所得割を計算
  3. reference/life-planning.md のふるさと納税最適額計算式を適用
  4. /tax-housing-loan-context で住宅ローン控除との相互影響を確認
「副業を始めたが何をすればいい?」
  1. reference/income-tax.md で所得区分を判定
  2. reference/blue-return.md で青色申告の検討を案内
  3. reference/business-expenses.md で経費の考え方を説明
  4. reference/consumption-tax.md で消費税の課税事業者判定
  5. reference/social-insurance.md で社会保険への影響を確認
  6. reference/filing-procedure.md で届出書類を案内
「住宅を購入した。控除を受けるには?」
  1. /tax-housing-loan-context で住宅ローン控除の要件・手続きを案内
  2. reference/filing-procedure.md で初年度の確定申告手続きを説明
  3. reference/life-planning.md でふるさと納税上限への影響を説明
  4. reference/common-mistakes.md で初年度のよくある間違いを注意喚起

免責事項の提示ルール

すべての回答の末尾に以下の免責事項を付記する:

---
⚠ この回答は一般的な税務情報の提供を目的としたものであり、個別の税務アドバイスではありません。
具体的な申告にあたっては、税理士等の専門家にご相談ください。
情報は令和7年分(2025年課税年度)の税制に基づいています。

免責事項の詳細は /tax-legal-context を実行する。

特に免責を強調すべきケース
  • 判断が分かれる論点(グレーゾーン)
  • 高額な税額に関わる判断
  • 税理士法第52条に抵触する可能性のある個別具体的な税務代理行為
  • ペナルティ(加算税・延滞税)に関する質問

回答品質の基準

  • 正確性: reference ファイルに基づく事実のみを述べる
  • 網羅性: 関連する注意点・例外を漏れなく提示する
  • 具体性: 抽象的な説明に終わらず、金額・計算例を示す
  • 公平性: メリットだけでなくデメリット・リスクも提示する
  • 最新性: 令和7年分の税制改正を正確に反映する

© kazukinagata, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 31 other files in skills/tax-advisor of kazukinagata/shinkoku.

  • SKILL.md
  • README.md
  • reference/blue-return.md
  • reference/business-expenses.md
  • reference/common-mistakes.md
  • reference/consumption-tax.md
  • reference/crypto-tax.md
  • reference/deduction-optimizer.md
  • reference/deduction-simulation-guide.md
  • reference/dependents.md
  • reference/expense-deductibility-guide.md
  • reference/filing-procedure.md
  • reference/glossary.md
  • reference/income-deductions.md
  • reference/income-tax.md
  • reference/industry-expense-guide.md
  • reference/life-planning.md
  • reference/medical-expenses.md
  • reference/nisa-and-filing.md
  • reference/prepayment-management.md
  • … and 12 more

Open the folder on GitHubat commit 607574d

Compare with similar skills

Tax Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tax Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tax Advisor this skillkazukinagata/shinkoku365—~1.4kAutomated safety check: PassMIT
Invoice Organizerdavila7/claude-code-templates33k12 repos~2.9kAutomated safety check: PassMIT
Kanchi Dividend Us Tax Accountingtradermonty/claude-trading-skills3k1 repos~1.1kAutomated safety check: PassMIT
VAT CalculationSerein-81/financial_rag148—~894Automated safety check: NotesNone
Payroll Operationscbrock84/headcount2k—~1.1kAutomated safety check: PassMIT
Financial Retentionmukul975/Privacy-Data-Protection-Skills301—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Invoice Organizer

    davila7/claude-code-templates

    Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.

    33k GitHub starsUsed in 12 repos~2.9k tokens
    Business, Finance & HRAuto-check passed
  • Kanchi Dividend Us Tax Accounting

    tradermonty/claude-trading-skills

    Provide US dividend tax and account-location workflow for Kanchi-style income portfolios.

    3k GitHub starsUsed in 1 repo~1.1k tokens
    Business, Finance & HRAuto-check passed
  • VAT Calculation

    Serein-81/financial_rag

    Calculates value-added tax from a tax-inclusive sales amount, VAT rate and input tax using a calculator tool, with risk checks and filing suggestions.

    148 GitHub stars~894 tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check: notes
  • Payroll Operations

    cbrock84/headcount

    Runs the pay cycle so it is right, on time, and provable — the calendar and cutoffs, what feeds pay from the HRIS and time systems, gross-to-net and the deductions in it, multi-jurisdiction…

    2k GitHub stars~1.1k tokensUpdated 23 days ago
    Business, Finance & HRAuto-check passed
  • Financial Retention

    mukul975/Privacy-Data-Protection-Skills

    Implements financial records retention requirements across EU directives (5-7 years), SOX Section 802 (7 years), MiFID II (5-7 years), tax records, payment data, and AML obligations under AMLD.

    301 GitHub stars~3.5k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • Fractional Cfo Playbook

    LeoYeAI/openclaw-master-skills

    Complete operational playbook for Fractional CFO engagements.

    2.2k GitHub stars~3.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed

More from kazukinagata/shinkoku

All 24 skills in this repo
  • Consumption Tax

    kazukinagata/shinkoku

    This skill should be used when the user needs to calculate consumption tax (消費税) or determine their tax method (2割特例, 簡易課税, or 本則課税).

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Furusato

    kazukinagata/shinkoku

    This skill manages furusato nozei (hometown tax) donations. An agent skill from kazukinagata/shinkoku.

    365 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Incorporation

    kazukinagata/shinkoku

    法人成り(個人事業主から法人への移行)に関する相談。税額比較シミュレーション、 法人形態の選択、設立手続き、役員報酬戦略、社会保険の比較を支援する。

    365 GitHub stars~687 tokensUpdated 1 mo ago
    Auto-check passed
  • Invoice System

    kazukinagata/shinkoku

    This skill should be used when the user asks about the invoice system (インボイス制度), qualified invoices (適格請求書), registration numbers (登録番号), input tax credits (仕入税額控除), the 20% special measure (2割特例)…

    365 GitHub stars~778 tokensUpdated 1 mo ago
    Auto-check passed
  • Journal

    kazukinagata/shinkoku

    This skill should be used when the user wants to record bookkeeping entries (仕訳), import transaction data from CSV files, receipts, or invoices, or manage their general ledger.

    365 GitHub stars~2.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Settlement

    kazukinagata/shinkoku

    This skill should be used when the user needs to perform year-end closing adjustments (決算整理), review financial statements (決算書), compute depreciation, or review their trial balance.

    365 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Tax Advisor

What does Tax Advisor do?

This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner. Tax Advisor is an agent skill from kazukinagata/shinkoku. This skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner.

When should I use Tax Advisor?

Tax Advisor fits situations like: asks tax-related questions; wants advice on deductions; needs expert guidance equivalent to a tax accountant (税理士); phrases include: 税金について教えて.

How do I install Tax Advisor in Claude Code?

Run `npx skills add kazukinagata/shinkoku --skill tax-advisor -a claude-code`. Or copy the skill folder (skills/tax-advisor in kazukinagata/shinkoku) into .claude/skills/tax-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Tax Advisor in Codex?

Run `npx skills add kazukinagata/shinkoku --skill tax-advisor -a codex`. Or copy the skill folder (skills/tax-advisor in kazukinagata/shinkoku) into .agents/skills/tax-advisor in your project. Codex loads it when a task matches its description.

Can I use Tax Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kazukinagata/shinkoku --skill tax-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tax-advisor, .gemini/skills/tax-advisor, .github/skills/tax-advisor and .opencode/skills/tax-advisor in your project.

What does Tax Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Tax Advisor is instructions for the agent only.

Does Tax Advisor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tax Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tax Advisor use?

Tax Advisor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tax Advisor use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tax Advisor?

Skills that share tags, products or a category with Tax Advisor: Invoice Organizer (davila7/claude-code-templates, 33k stars), Kanchi Dividend Us Tax Accounting (tradermonty/claude-trading-skills, 3k stars), VAT Calculation (Serein-81/financial_rag, 148 stars) and Payroll Operations (cbrock84/headcount, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tax Advisor?

kazukinagata (a GitHub user) maintains it in kazukinagata/shinkoku, which has 365 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 9, 2026.

Source: kazukinagata/shinkoku on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.