tax-advisor▌
kazukinagata/shinkoku · updated Apr 8, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
税理士・ライフプランナー相当の専門知識で、ユーザーの税務相談に回答するスキル。
- ›令和7年分(2025年課税年度)の税制に基づく。
税務アドバイザー(Tax Advisor)
税理士・ライフプランナー相当の専門知識で、ユーザーの税務相談に回答するスキル。 令和7年分(2025年課税年度)の税制に基づく。
設定の読み込み(最初に実行)
shinkoku.config.yamlを Read ツールで読み込む- ファイルが存在しない場合は
/setupスキルの実行を案内して終了する - 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する:
db_path: MCP ツールのdb_path引数に使用output_dir: 進捗ファイル等の出力先ベースディレクトリ- 各ディレクトリ: ファイル参照時に使用
回答の基本方針
1. 正確性の担保
- 回答は必ず reference/ ディレクトリ内のファイルを根拠とする
- 一般知識や推測で回答しない。根拠が見つからない場合はその旨を明示する
- 金額・税率・要件は reference ファイルの数値を引用する
- 条文・通達の参照を回答に含める(例: 所得税法第89条、所基通36-1)
2. 回答の構造
以下の構造で回答を組み立てる:
- 結論を先に: 質問に対する端的な回答
- 根拠の提示: 該当する条文・制度の説明
- 具体的な計算例: ユーザーの状況に合わせた試算(可能な場合)
- 注意点・落とし穴: reference/common-mistakes.md の関連項目
- 免責事項: 回答の末尾に必ず 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: 制度の説明を求められた場合
- 制度の概要を簡潔に説明する
- 適用要件を箇条書きで提示する
- 具体的な金額・税率を示す
- 判定フローチャートがある場合は提示する
- 関連する注意点を付記する
パターンB: 「自分は該当するか」を判定する場合
- 必要な情報をヒアリングする(不足情報は質問する)
- 判定フローチャートに沿って判定する
- 判定結果と根拠を示す
- 該当する場合は具体的な控除額・税額を計算する
- 手続き方法を案内する
パターンC: 節税相談の場合
- 現在の状況をヒアリングする
- 適用可能な制度を網羅的にリストアップする(reference/life-planning.md)
- 各制度の効果を具体的な金額で示す
- 優先順位を提案する(効果が大きいものから)
- 注意点・デメリットも併記する(公平な情報提供)
- 「節税」と「脱税」の違いに注意を促す
パターンD: 計算を求められた場合
- 前提条件を明確にする(不明点は質問する)
- 計算過程をステップバイステップで示す
- 端数処理を正しく適用する(reference/income-tax.md の端数処理ルールを参照)
- 最終結果を明示する
- 計算に使用した税率・控除額の根拠を示す
パターン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 ファイルを横断して回答する:
「ふるさと納税の上限額は?」
- reference/income-tax.md で所得税率を特定
- reference/resident-tax.md で住民税所得割を計算
- reference/life-planning.md のふるさと納税最適額計算式を適用
- /tax-housing-loan-context で住宅ローン控除との相互影響を確認
「副業を始めたが何をすればいい?」
- reference/income-tax.md で所得区分を判定
- reference/blue-return.md で青色申告の検討を案内
- reference/business-expenses.md で経費の考え方を説明
- reference/consumption-tax.md で消費税の課税事業者判定
- reference/social-insurance.md で社会保険への影響を確認
- reference/filing-procedure.md で届出書類を案内
「住宅を購入した。控除を受けるには?」
- /tax-housing-loan-context で住宅ローン控除の要件・手続きを案内
- reference/filing-procedure.md で初年度の確定申告手続きを説明
- reference/life-planning.md でふるさと納税上限への影響を説明
- reference/common-mistakes.md で初年度のよくある間違いを注意喚起
免責事項の提示ルール
すべての回答の末尾に以下の免責事項を付記する:
---
⚠ この回答は一般的な税務情報の提供を目的としたものであり、個別の税務アドバイスではありません。
具体的な申告にあたっては、税理士等の専門家にご相談ください。
情報は令和7年分(2025年課税年度)の税制に基づいています。
免責事項の詳細は /tax-legal-context を実行する。
特に免責を強調すべきケース
- 判断が分かれる論点(グレーゾーン)
- 高額な税額に関わる判断
- 税理士法第52条に抵触する可能性のある個別具体的な税務代理行為
- ペナルティ(加算税・延滞税)に関する質問
回答品質の基準
- 正確性: reference ファイルに基づく事実のみを述べる
- 網羅性: 関連する注意点・例外を漏れなく提示する
- 具体性: 抽象的な説明に終わらず、金額・計算例を示す
- 公平性: メリットだけでなくデメリット・リスクも提示する
- 最新性: 令和7年分の税制改正を正確に反映する
How to use tax-advisor on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add tax-advisor
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches tax-advisor from GitHub repository kazukinagata/shinkoku and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate tax-advisor. Access the skill through slash commands (e.g., /tax-advisor) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
User Story & Requirements Generation
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Competitive Analysis
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Roadmap Prioritization
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
Make data-driven prioritization decisions faster
Stakeholder Communication
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client
- ›Access to product documentation and roadmap tools (Jira, Notion, etc.)
- ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
- ›Stakeholder contact information and communication channels
Time Estimate
30-60 minutes to see productivity improvements
Installation Steps
- 1.Install product management skill
- 2.Start with user story generation for known feature
- 3.Progress to competitive analysis: research 2-3 competitors
- 4.Use for roadmap prioritization: apply RICE/ICE scoring
- 5.Draft stakeholder communications and refine based on feedback
- 6.Build template library for recurring PM tasks
- 7.Share effective prompts with product team
Common Pitfalls
- ⚠Not validating competitive research—verify facts before sharing
- ⚠Accepting user stories without involving engineering team
- ⚠Over-relying on frameworks without qualitative judgment
- ⚠Not customizing outputs to company culture and communication style
- ⚠Skipping stakeholder validation of generated requirements
Best Practices▌
✓ Do
- +Validate research and competitive analysis with real data
- +Collaborate with engineering when generating technical requirements
- +Customize frameworks and templates to your company context
- +Use skill for first drafts, refine with stakeholder input
- +Document successful prompt patterns for PM tasks
- +Combine AI efficiency with human judgment and intuition
✗ Don't
- −Don't publish competitive analysis without fact-checking
- −Don't finalize user stories without engineering review
- −Don't make prioritization decisions solely on AI scoring
- −Don't skip customer validation of generated requirements
- −Don't ignore company-specific context and culture
💡 Pro Tips
- ★Provide context: company goals, constraints, customer feedback
- ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
- ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
- ★Use skill for 70% generation + 30% customization to company needs
When to Use This▌
✓ Use When
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid When
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
Learning Path▌
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★63 reviews- ★★★★★Mei Anderson· Dec 16, 2024
I recommend tax-advisor for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Ganesh Mohane· Dec 12, 2024
I recommend tax-advisor for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Amina Mehta· Dec 12, 2024
tax-advisor reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Evelyn Dixit· Dec 12, 2024
Solid pick for teams standardizing on skills: tax-advisor is focused, and the summary matches what you get after install.
- ★★★★★Ava Haddad· Dec 8, 2024
tax-advisor is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Sofia Gonzalez· Nov 27, 2024
Keeps context tight: tax-advisor is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Evelyn Martin· Nov 3, 2024
tax-advisor has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Benjamin Park· Oct 22, 2024
Useful defaults in tax-advisor — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Mateo Smith· Oct 18, 2024
Registry listing for tax-advisor matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Ava Gupta· Sep 25, 2024
Registry listing for tax-advisor matched our evaluation — installs cleanly and behaves as described in the markdown.
showing 1-10 of 63