shinkoku — плагин

Установка

Работает в

• Claude Code
• Cursor
• Windsurf
• GitHub Copilot
• Gemini CLI
• Codex
• Cline
• Roo Code

npx skillfoxx add plugins/shinkoku

Что делает

shinkoku — плагин Claude Code и набор скиллов по открытому стандарту SKILL.md, который помогает подать годовую налоговую декларацию в Японии. Он охватывает подоходный и потребительский налоги для индивидуальных предпринимателей на синей декларации, сотрудников с подработкой и работников только с зарплатой. Описание и интерфейс на японском. Рабочий процесс идет цепочкой скиллов. Команда `/setup` создает файл настроек и базу SQLite, `/assess` решает, нужна ли декларация, `/gather` составляет список документов. Скилл `/journal` загружает CSV, чеки, счета и справки об удержании и ведет двойную запись, `/settlement` считает амортизацию и строит оборотную ведомость, отчет о прибылях и убытках и баланс. Затем `/income-tax` считает подоходный налог с вычетами и налог на восстановление, `/consumption-tax` потребительский налог по трем режимам (особый порядок на 20 процентов, упрощенный и общий), а `/submit` ведет к подаче через e-Tax, почтой или лично. Скилл `/e-tax` вносит данные в портал создания декларации через автоматизацию браузера: Claude in Chrome, Antigravity Browser Sub-Agent или Playwright CLI в бета-версии. Скиллы `/reading-*` распознают чеки, справки об удержании, счета, справки о вычетах и платежные ведомости, а двойная проверка с двумя субагентами сверяет результаты. Расчеты выполняет программа shinkoku на Python, а не модель. Дополнительно есть налоговый консультант, учет пожертвований «фурусато-нодзэй» и сравнение с переходом на компанию. Покрыты налоговые годы 2025 и 2026.

Для кого. Для налоговых резидентов Японии: индивидуальных предпринимателей на синей декларации, сотрудников с подработкой и работников с зарплатой, которые готовы проверить результат сами и знают японский.

Пример запроса к агенту

/setup подготовь рабочую папку для моей налоговой декларации, а затем скажи, какие документы мне нужно собрать

Ограничения

• Нужны Python 3.11 или новее и менеджер пакетов uv. Утилиту shinkoku скиллы вызывают внутри, обычно `/setup` ставит ее сам, вручную это делает команда `uv tool install git+https://github.com/kazukinagata/shinkoku`.
• Распознавание изображений работает только с мультимодальными моделями, у текстовых моделей остается ручной ввод.
• Для ввода в портал нужна автоматизация браузера: Claude in Chrome с флагом `claude --chrome`, Antigravity или Playwright CLI в бета-версии.
• Не поддерживаются отдельное налогообложение акций, FX, доход от недвижимости, пенсионный доход, доход от продажи имущества, зачет иностранного налога, сельскохозяйственный и лесной доход, белая декларация и нерезиденты.
• Налоги меняются ежегодно: плагин рассчитан на 2025 и 2026 годы, часть норм более поздних лет только отмечена константами без расчета.
• Все данные и итоги автор просит проверять самому, ответственности за убытки разработчик не несет.

Как отключить. Отключите или удалите плагин командами менеджера плагинов Claude Code, а скиллы, поставленные через npx skills, удалите из каталога скиллов агента. Рабочая папка с декларацией остается: в ней лежат shinkoku.config.yaml с персональными данными, база shinkoku.db и папки .shinkoku и `output`. Удалите их сами, если данные больше не нужны.

Коротко о README

README на японском представляет плагин, таблицы поддерживаемых и неподдерживаемых случаев и подробный отказ от ответственности. Затем идут установка, подготовка рабочей папки, защита личных данных, список скиллов основного процесса, вспомогательных и распознающих, таблица агентов с двойной проверкой, раздел для разработчиков и стек технологий.