name: skill-name-kebab-case description: | Краткое описание в 1-2 предложения. Что делает skill, кому полезен. Пример: "Расчёт авансового платежа УСН за период. Полезен ИП/ООО на УСН доходы или доходы-расходы." required_tools:

• fns.check_msp_status
• cbr.key_rate
• cbr.exchange_rate

optional_tools:

• 1c.read_journal

version: 1.0.0 status: alpha # alpha | beta | stable domain_owner: "@AlsKozlov" # GitHub username бухгалтера-ревьюера last_legislative_update: "2026-05" # YYYY-MM последней проверки актуальности НК risk_level: medium # low | medium | high — насколько критична ошибка references:

• "НК РФ ст. 346.21"
• "Письмо Минфина от XX.XX.XXXX №XXX"

Skill Name — На русском заголовок

Назначение

Что именно делает этот skill. Когда бухгалтер его использует.

Входные данные

Что должен предоставить пользователь:

• ИНН компании или ИП
• Период (квартал / месяц)
• Дополнительно: ...

Workflow

Шаг 1 — Что делаем

Описание шага в естественном языке. Включая tool calls:

Через fns.check_msp_status(inn=user.inn) проверь статус компании. Если в реестре МСП — применяются льготные тарифы страховых взносов.

Что извлечь из ответа:

• field1
• field2

Шаг 2 — Что делаем дальше

Если выполнено условие X — переходим к шагу 3. Иначе — пропускаем.

cbr.key_rate(date=...) — текущая ключевая ставка.

Шаг 3 — Финальный расчёт

Формула / процедура расчёта в естественном языке. Можно с примерами:

Пример: для дохода 500 000 ₽ за квартал на УСН 6% налог = 30 000 ₽, минус уплаченные страх.взносы (но не более 50% налога для работодателей, 100% для ИП без работников).

Degraded mode

Если MCP fns недоступен:

• Продолжай расчёт по общим правилам
• В финальном отчёте явно укажи: "⚠ Статус в реестре МСП не проверен — применены стандартные тарифы. Перепроверьте вручную через nalog.gov.ru."

Если cbr.key_rate недоступен:

• Используй последнее известное значение из training data
• Помеком: "⚠ Ключевая ставка не сверена с ЦБ — используйте актуальное значение"

Финальный отчёт

Структура:

1. Сводка (2-3 строки) — итоговая сумма налога / взноса
2. Применённые ставки — со ссылками на НПА (актуальная редакция)
3. Расчёт — пошаговый, с цифрами
4. Проверенные данные — что верифицировано через MCP (✅) и что нет (⚠)
5. Рекомендации — что бухгалтер должен проверить вручную

Тестовые кейсы

См. tests/test-cases.yaml для regression testing:

• case-001: типовой кейс
• case-002: edge case (минимальный налог УСН)
• case-003: ошибочный input → должен корректно отклонить

Известные ограничения

• Не покрывает: ...
• Спорные ситуации: ...
• Требует проверки руками: ...

Версии и changelog

• 1.0.0 (2026-05-26) — initial release