tax-advisor

The tax-advisor skill acts as a specialized virtual tax accountant and life planner tailored for the Japanese tax system. It is designed to assist users with complex tax-related queries based on the 2025 (Reiwa 7) fiscal year regulations. By utilizing a structured reference database of tax laws, circulars, and institutional guidelines, it provides accurate, evidence-based answers for both individuals and small business owners. It covers topics ranging from income tax calculations, resident tax, and consumption tax (including the Invoice System and 2-percent special exception) to detailed deduction inquiries such as medical expenses, spouse deductions, dependents, and housing loan deductions. The skill is adept at handling scenarios like side business classification (business vs. miscellaneous income), blue-return reporting requirements, and corporate transitions (incorporation). It functions by first analyzing user-provided configuration files to understand specific local environments, then mapping tax-related questions to the appropriate technical documentation. It provides clear, step-by-step calculations, tax rate explanations, and specific citations from the Income Tax Law to ensure clarity and reliability. Furthermore, the skill provides essential guidance on navigating the 'tax walls' commonly encountered by part-time workers and employees (e.g., the 1.03 million yen wall, 1.3 million yen wall).

• Expert-level tax advice grounded in official reference documentation and statutory law.

• Automated transformation of 'gross income' to 'taxable income' using standardized glossary definitions.

• Detailed simulation for tax-saving strategies, including Furusato Nozei (hometown tax) and iDeCo impact analysis.

• Comprehensive coverage of tax reforms, transition measures, and future legislative updates.

• Structured responses including conclusions, logical evidence, calculation examples, and common pitfalls.

• Integration with the shinkoku framework for persistent settings and data management.

• Users must ensure the shinkoku.config.yaml file is correctly configured in the working directory before starting.

• This tool is strictly for educational and guidance purposes; it does not constitute official tax agency filing or legally binding professional tax representation.

• All generated output includes a mandatory legal disclaimer identifying that specific cases should be reviewed by a certified public tax accountant (税理士).

• The skill requires consistent access to local reference files to maintain compliance with the latest annual tax changes.

• It is optimized for users navigating Japanese personal tax filings, including those managing side businesses, e-Tax procedures, and complex benefit/deduction calculations.