plan-payroll · ilyautov — Claude Code skill: payroll with Russian 2026 taxes
plan-payroll — a skill that works out the full cost of a payroll run under Russian 2026 tax rules, forecasts cash, and drafts overdue-invoice reminders when the money falls short.
Apache-2.0 ★ 38 updated 2026-09-29
npx skills add ilyautov/small-business-ru --skill plan-payroll -a claude-codeWhat plan-payroll does
The worry of "will payroll clear" usually comes from comparing the take-home total to the bank balance, while the real outflow is bigger — income tax is withheld on every payout and employer contributions sit on top. The skill breaks this down per employee: gross, income tax on the progressive scale, net pay, contributions at 30% up to the yearly base of 2 979 000 ₽ and 15.1% above it.
It runs a three-step pipeline. First a cash forecast over 30, 60 or 90 days (the --horizon argument) via the cash-flow-snapshot workflow, with tax-payment dates through the unified tax account plotted as separate outflows. Then, if the forecast shows a gap, the invoice-chase workflow ranks overdue invoices and drafts payment reminders. Every step waits for explicit owner approval — nothing gets sent until the owner says so.
Figures come from ~~accounting (1C/MoySklad) and ~~payments (YooKassa/Tinkoff/bank statements), falling back to a CSV export when no connector exists. The 15% small-business contribution rate is not applied by default — since 2026 it covers only priority industries, which the owner has to confirm. Output is meant for review by your accountant, not as a substitute.
What it helps with
- compute the full payroll fund with Russian income tax and contributions
- forecast cash 30, 60 or 90 days out ahead of the payout date
- schedule tax and contribution payments in the cash forecast
- rank overdue invoices and draft client payment reminders
- find which receivables to chase to close the payroll gap
Example prompts for the agent
- Run plan-payroll and work out the May payroll fund with taxes
- Run plan-payroll with
--horizon 60and check if the payout clears - Draft reminders for overdue invoices through plan-payroll
How to install plan-payroll
1Skills CLI (Vercel)
npx skills add ilyautov/small-business-ru --skill plan-payroll -a claude-code2Manually: put the files in place
~/.claude/skills/plan-payroll/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/plan-payroll/
1Skills CLI (Vercel)
npx skills add ilyautov/small-business-ru --skill plan-payroll -a codex2Manually: put the files in place
.agents/skills/plan-payroll/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ilyautov/small-business-ru --skill plan-payroll -a cursor2Manually: put the files in place
.cursor/skills/plan-payroll/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ilyautov/small-business-ru small-business-ru/skills/plan-payroll2Manually: put the files in place
.github/skills/plan-payroll/SKILL.md1Skills CLI (Vercel)
npx skills add ilyautov/small-business-ru --skill plan-payroll -a gemini-cli2Platform CLI
gemini skills install https://github.com/ilyautov/small-business-ru --path small-business-ru/skills/plan-payrollManually: put the files in place
.devin/skills/plan-payroll/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ilyautov/small-business-ru --skill plan-payroll -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about plan-payroll
How do I install plan-payroll in Claude Code?
Run npx skills add ilyautov/small-business-ru --skill plan-payroll -a claude-code and the skill lands in ~/.claude/skills/plan-payroll/SKILL.md. For Codex, Cursor, Gemini CLI and OpenCode use the same command with the matching -a flag; for GitHub Copilot run gh skill install ilyautov/small-business-ru plan-payroll.
What does the plan-payroll skill do?
It calculates the true cost of paying salaried staff in Russia: income tax on the progressive scale, employer contributions on top, and the dates money leaves for the budget. It then forecasts cash and, if payroll falls short, drafts payment reminders for overdue invoices — sent only after you approve each one.
What arguments does plan-payroll take?
--horizon sets the forecast window in days — 30, 60 or 90, with 30 as the default. --payroll-date sets the payout date; without it the next scheduled date is used.
Source text
SKILL.md · Apache-2.0
--- name: plan-payroll description: > Прогнозирует деньги, ранжирует просроченные счета, готовит напоминания об оплате и считает фонд зарплаты с налогами РФ 2026 — чтобы собственник уверенно выплатил зарплату сотрудникам. Принимает необязательные аргументы горизонта и даты выплаты. Командная форма: вызывается по имени. allowed-tools: Read, WebFetch --- <!-- Производное от Anthropic knowledge-work-plugins / small-business (Apache-2.0, (c) Anthropic). Локализовано под РФ, файл изменён. См. /NOTICE и /LICENSE. --> # Уверенная выплата зарплаты Тревога «хватит ли на зарплату» обычно про то, что в голове сумма «на руки», а реально с фонда уходит в полтора раза больше — НДФЛ и взносы поверх. Этот скилл считает полную стоимость выплаты с налогами 2026, смотрит прогноз денег и, если впритык, подсказывает, какую дебиторку дожать, чтобы закрыть разрыв к дате выплаты. > **Дисклеймер.** Подготовлено для проверки вашим бухгалтером. Не является > налоговой или юридической консультацией. Налоговые цифры — на 2026 налоговый > период; ставки и пороги перепроверяйте перед расчётом фактической выплаты. Запусти пайплайн уверенной выплаты зарплаты, связав несколько скиллов. Собственник подтверждает на каждой передаче — никогда не отправляй напоминание, не фиксируй прогноз и не запускай выплату без явного подтверждения. Разбор аргументов: - `--horizon` (по умолчанию `30`) — окно прогноза в днях (30, 60 или 90) - `--payroll-date` (необязательно) — дата выплаты; по умолчанию следующая плановая дата по правилам внутреннего распорядка ## Контекст РФ: что такое «зарплата сотрудникам» Это выплата зарплаты штатным сотрудникам по трудовым договорам в РФ (не подрядчикам/самозанятым и не зарубежный payroll). Ключевые правила 2026: - **Зарплата платится не реже двух раз в месяц:** аванс (за первую половину) и окончательный расчёт. Конкретные даты закреплены в трудовом/локальном акте, расчёт — не позднее 15 календарных дней после окончания периода. - **МРОТ: 27 093 ₽** с 01.01.2026 — зарплата за полностью отработанный месяц не ниже него (до удержания НДФЛ). - **НДФЛ удерживает работодатель** как налоговый агент при каждой выплате (и с аванса, и с расчёта). - **Страховые взносы платит работодатель сверх зарплаты** (это не удержание из зарплаты сотрудника, а расход бизнеса поверх неё). - Налоги и взносы идут через **ЕНП** (единый налоговый платёж) с уведомлениями. ## Шаг 1 — Прогноз денег (cash-flow-snapshot) Запусти рабочий процесс скилла `cash-flow-snapshot`: 1. Подтяни дебиторку, кредиторку и исторические сроки оплаты из `~~бухгалтерия` (1С/МойСклад) и `~~платежи` (ЮKassa/Тинькофф/банк-выписка), что подключено. Откатись на выгрузку CSV, если коннектора нет. 2. Заложи известные постоянные расходы (аренда, **полный фонд зарплаты с налогами — см. Шаг 1а**, регулярные платежи поставщикам). 3. Построй прогноз на 30/60/90 дней (используй запрошенный `--horizon`) с доверительными коридорами по проценту отклонения. 4. Пометь риски поимённо — например, «зарплата + взносы 15 мая ложатся на 42 000 ₽ ниже минимального остатка денег при медианном прогнозе». 5. Выдай сводку в чат + XLSX для скачивания. 6. Покажи собственнику. Дождись явного «ок, посмотрим что можно собрать» перед Шагом 2. Если прогноз показывает, что на зарплату с запасом хватает — спроси собственника, всё ли ещё нужно работать с дебиторкой или остановиться здесь. ## Шаг 1а — Полная стоимость зарплаты (фонд + налоги РФ 2026) Чтобы прогноз денег был честным, считай **полную** стоимость выплаты, а не только суммы «на руки». Для каждого сотрудника: **1. НДФЛ (удерживается из начисленной зарплаты, прогрессивная шкала по годовому доходу):** | Годовой доход | Ставка | |---|---| | до 2,4 млн ₽ | 13% | | 2,4–5 млн ₽ | 15% | | 5–20 млн ₽ | 18% | | 20–50 млн ₽ | 20% | | свыше 50 млн ₽ | 22% | Повышенная ставка применяется только к сумме сверх порога. Нерезиденты — 30% ⚠️ (уточни статус резидентства у собственника, если есть сомнения). «На руки» = начислено − НДФЛ. **2. Страховые взносы (платит работодатель сверх начисленной зарплаты):** - Единый тариф **30%** — в пределах базы **2 979 000 ₽** на сотрудника за год. - **15,1%** — с выплат сверх этой базы. - **Льгота МСП 15%** — теперь ⚠️ **только для приоритетных отраслей** (перечень Правительства: ОКВЭД + доля профильного дохода ≥ 70%), и только с части выплаты **свыше 1,5 МРОТ** (≈ 40 640 ₽ в месяц); до 1,5 МРОТ — 30%. Всеобщая льгота МСП с 2026 **отменена**. Не применяй льготу 15% автоматически — сначала подтверди у собственника, что бизнес в приоритетной отрасли и проходит по доле дохода. **Полная стоимость на сотрудника** = начисленная зарплата + страховые взносы. (НДФЛ внутри начисленной — это не сверх, его работодатель удерживает и перечисляет; для денежного потока важно, что «на руки» уходит сотруднику, а НДФЛ уходит в бюджет — обе части складываются в начисленную.) **Покажи собственнику разбивку:** ``` Сотрудник Начислено НДФЛ На руки Взносы (30%) Полная стоимость Иванов И.И. 80 000 ₽ 10 400 ₽ 69 600 ₽ 24 000 ₽ 104 000 ₽ ... ИТОГО фонд X ₽ X ₽ X ₽ X ₽ X ₽ ``` ⚠️ Если у кого-то годовой доход накопленным итогом пересекает порог НДФЛ (2,4 / 5 / 20 / 50 млн ₽) внутри года — отметь это: ставка на сумму сверх порога меняется. Точный расчёт перешагивающего месяца оставь на проверку бухгалтеру. ## Шаг 1б — Сроки уплаты (ЕНП) Заложи в прогноз не только дату выплаты сотрудникам, но и даты ухода денег в бюджет: - **НДФЛ за сотрудников:** уведомления об исчисленных суммах — 3-го и 25-го числа; уплата — 5-го и 28-го числа (две выплаты в месяц по периодам удержания). - **Страховые взносы:** уведомление — до 25-го числа; уплата (ЕНП) — до 28-го числа месяца, следующего за месяцем начисления. - Поставь эти даты как отдельные оттоки в прогнозе денег — частая ошибка: заложить зарплату «на руки», но забыть про НДФЛ и взносы. ## Шаг 2 — Работа с дебиторкой (invoice-chase) После подтверждения Шага 1 запусти рабочий процесс скилла `invoice-chase`: 1. Подтяни просроченные счета из `~~бухгалтерия` и `~~платежи`. 2. Ранжируй по сумме × дней просрочки × истории платежей клиента. 3. Для каждого подготовь черновик напоминания под тон (мягкий для хороших клиентов, твёрдый для регулярно опаздывающих). 4. Счета, выставленные через `~~платежи` с онлайн-оплатой, ставь в очередь как черновики со ссылкой на оплату; остальные — как черновики писем/сообщений через `~~почта` или `~~мессенджер`. 5. Покажи ранжированный список с черновиками. Покажи прогнозный эффект на деньги, если оплатят топ-N в пределах горизонта — закрывает ли это разрыв на зарплату из Шага 1? 6. Дождись явного «отправляй» по каждому напоминанию (или пакетного подтверждения) перед отправкой. ## Точки подтверждения (approval gates, обязательны) - Никогда не отправляй напоминание без подтверждения собственника — только черновики, пока не дано «отправить». - Никогда не фиксируй прогноз как окончательный без подписи собственника. - Никогда не считай льготу по взносам или ставку НДФЛ окончательной без подтверждения собственником статуса (приоритетная отрасль, резидентство). При сомнении пиши «уточните у бухгалтера». - Если коннектор недоступен (`~~бухгалтерия`, `~~платежи`, `~~почта`/`~~мессенджер`), остановись, сообщи, какой коннектор отказал, и спроси: повторить, откатиться на CSV или прервать. ## Вывод Заверши прогон одним абзацем-итогом: вердикт по прогнозу (хватает / разрыв / риск), полная стоимость фонда зарплаты с налогами, отправленные напоминания и кому, прогнозная новая денежная позиция, если напоминания сработают. Повтори дисклеймер: цифры по налогам — для проверки бухгалтером. --- **Нужно глубже?** Это быстрый план под выплату зарплаты. Для регулярного расчёта зарплаты (gross→net, НДФЛ, взносы с тарифами МСП, полная стоимость сотрудника) и дебиторки/кредиторки с реестром старения есть скиллы `payroll-rf`, `receivables-aging`, `accounts-payable` в паке **finance-ru** (линейка RU Business Packs).
© ilyautov · Apache-2.0 · ilyautov/small-business-ru
Similar skills
All skills for Finance and business →plan-payroll by other authors comes first.