handle-complaint
Обрабатывает входящую жалобу клиента от начала до конца — подтягивает контекст, готовит ответ и предлагает операционное исправление. Принима
Open source Repository Open in the app JSON README (API)
About
Обрабатывает входящую жалобу клиента от начала до конца — подтягивает контекст, готовит ответ и предлагает операционное исправление. Принимает необязательный аргумент — ID письма или обращения. Команд
Details
- Kind
- Agent skills
- Topic
- No topic detected
- Publisher
- ilyautov
- Origin
- majiayu
- Category
- ferramentas
- Stars
- 15
- Added
- 2026-09-13 10:12:48
- Updated
- 2026-09-13 10:12:48
- Origin id
ilyautov/small-business-ru/small-business-ru/skills/handle-complaint@main
README
# small-business-ru: AI-напарник предпринимателя
> 🇬🇧 [English version](README.en.md)
> **Чтобы не сойти с ума в своём деле.** 34 открытых AI-скилла под операционку малого бизнеса РФ: деньги, клиенты, налоги УСН, договоры по ГК РФ, найм по ТК РФ. Весь small-business-пак от Anthropic (создатели Claude), локализованный под российские реалии, плюс 3 скилла, которых у них нет. Для Claude Code, Cursor, Codex, ChatGPT и Gemini. Числа считаются **кодом**, контрагент проверяется по **реальным реестрам** ФНС/ФССП/арбитража, а где данных нет, скилл пишет «не проверено» вместо выдумки.
[](LICENSE)
[](https://github.com/anthropics/knowledge-work-plugins/tree/main/small-business)
[](https://github.com/ilyautov/small-business-ru/commits/main)
[](#что-внутри)
[](https://small-business-ru.aifrontier.tech/)
[](https://github.com/ilyautov/small-business-ru/stargazers)
<p align="center">
<a href="https://small-business-ru.aifrontier.tech/">
<img src="assets/social-preview.png" alt="small-business-ru: 34 открытых AI-скилла для малого бизнеса РФ, числа считаются кодом, контрагент проверяется по реестрам" width="760">
</a>
</p>
📖 **Сайт и инструкции:** [small-business-ru.aifrontier.tech](https://small-business-ru.aifrontier.tech/): как поставить, как пользоваться обычными словами, живое демо. [Про внедрение под ваш бизнес](https://small-business-ru.aifrontier.tech/vnedrenie.html).
## Зачем это нужно
**Вы и финдиректор, и отдел продаж, и кадровик, и юрист одновременно.** Что-то всегда проваливается: счёт не дослали, контрагент оказался банкротом уже после отгрузки, срок налога прошёл, маржа уехала незаметно.
Вчера вы тащили это в одиночку. small-business-ru это AI-напарник по операционке: берёт на себя рутину по деньгам, клиентам, налогам, договорам и найму и не даёт важному провалиться. Скажите обычными словами, что болит, остальное он проведёт по шагам.
И главное отличие от «просто чата». «Внедрите AI» обычно значит ассистент, который уверенно **врёт цифрами**: придумает налоговую ставку, выдумает надёжность поставщика, а вы примете это за факт, потому что звучит уверенно. small-business-ru заходит с другой стороны:
- **Числа считаются кодом**, а не прикидываются моделью. Прогноз денежного потока, маржа, налоги УСН считаются скриптами, сверенными на контрольных точках.
- **Данные из реальных реестров.** Контрагент проверяется по ЕГРЮЛ, ФССП, картотеке арбитража, ЕФРСБ, ГИР БО. Каждый факт идёт с источником и датой.
- **«Не проверено» вместо выдумки.** Где данных нет, скилл честно это говорит. Светофор риска это оценка, а не приговор; решение всегда за вами.
Скажите обычными словами: «хватит ли на зарплату», «проверь контрагента», «закрой месяц». Claude подберёт нужный сценарий и проведёт по шагам, останавливаясь перед всем, что трогает деньги или клиентов.
> ⚠️ **alpha.** Помогает с рабочими задачами, но не заменяет бухгалтера, юриста или кадровика. Налоговые цифры на 2026 год; сверяйте с действующими нормами.
## Три скилла под РФ, которых нет у Anthropic
Это весь small-business-пак Anthropic, локализованный под РФ (все 31 скилл, покрытие 100%), плюс три сценария, собранных с нуля под российские реалии. Они и есть доказательство, что это настоящая локализация под РФ, а не перевод английского пака.
### `counterparty-guard`: проверка контрагента по ИНН до сделки
Сводит ЕГРЮЛ, ФССП, суды, банкротства, финансы в **светофор 🟢/🟡/🔴** за минуты. Не верит одному агрегатору: в живом тесте 5 агрегаторов разошлись по числу судов почти втрое (примерно ~500 / ~1000 / ~1500). Факт это то, что совпало у ≥3 источников.
<p align="center">
<img src="docs/assets/demo_counterparty-guard.gif" alt="Демо counterparty-guard: ввод ИНН, на выходе светофор риска с причиной и источниками" width="520">
</p>
### `tax-calendar-proactive`: налоговый штурман УСН
Сам, без вопроса, показывает что горит, когда срок и **сколько примерно платить**. Суммы считает скриптом (сверен на контрольных точках), ставки берёт из канона 2026. Предупреждает о приближении к НДС-порогу 20 млн заранее.
<p align="center">
<img src="docs/assets/demo_tax-calendar-proactive.gif" alt="Демо tax-calendar-proactive: налоговый календарь УСН с расчётом сумм и сроков" width="520">
</p>
### `cross-source-verify`: движок круговой сверки
Сводит данные из нескольких источников с оценкой уверенности и **явным показом расхождений**, не выбирая молча одну версию. На этом принципе стоит весь набор.
## Что входит в зонтичный пак
С одного маркетплейса ставятся три модуля — берите нужные:
| Модуль | Что делает | Установка |
|---|---|---|
| **small-business-ru** | 34 скилла операционки: деньги, УСН-налоги, дебиторка, маржа, CRM, контент, найм, договоры, проверка контрагента | `/plugin install small-business-ru@small-business-ru` |
| **humanizer-ru** | Убирает запах нейросети из русского текста: ответы клиентам, посты, письма звучат по-человечески | `/plugin install humanizer-ru@small-business-ru` |
| **marketplaces-mcp-ru** | MCP-серверы Wildberries + Ozon: продажи, остатки, цены, финансы, отзывы прямо из Seller API | `/plugin install marketplaces-mcp-ru@small-business-ru` |
**Модули работают в связке.** Пример сквозного сценария:
> «Собери отзывы на Wildberries ниже 4★ за неделю» (marketplaces-mcp-ru) → «сгруппируй жалобы и подготовь ответы» (клиентские скиллы) → «очеловечь ответы» (humanizer-ru).
marketplaces-mcp-ru просит токены кабинетов (`WB_API_TOKEN`, `OZON_CLIENT_ID`, `OZON_API_KEY`); без них операционные скиллы всё равно работают через выгрузки CSV/Excel.
## Что внутри
**34 скилла = весь small-business-пак Anthropic (31, покрытие 100%) + 3 наших под РФ.** Это все роли, что предприниматель тащит сам, в одном паке:
- **Деньги:** прогноз денежного потока, дебиторка, маржа, закрытие месяца
- **Налоги УСН:** авансы, страховые взносы ИП, выплаты подрядчикам
- **Продажи / CRM:** приоритет лидов, гигиена CRM, кампании
- **Клиенты:** жалобы, отзывы, поддержка
- **Контент / маркетинг:** посты, контент-стратегия, Canva
- **Найм:** вакансия → интервью → оффер по ТК РФ
- **Брифы:** понедельник / пятница / квартал
- **Договоры:** ревью по ГК РФ
Всё связывает роутер `smb-router`, понимающий обычную речь, так что имена команд запоминать не нужно. Полный список скиллов лежит в [`small-business-ru/README.md`](./small-business-ru/README.md). Правила, налоговый/правовой слой и глоссарий в [`small-business-ru/RULES.md`](./small-business-ru/RULES.md).
> **Нужен финучёт глубже?** Этот пак про быстрые финансовые штурманы владельца-универсала. Для регулярного управленческого учёта и бухгалтерии РСБУ есть отдельный пак **finance-ru** в линейке RU Business Packs (ОПиУ/баланс/ОДДС, маржа по продуктам, дебиторка, зарплата с НДФЛ/взносами, склад/FIFO, маркетплейсы, 115-ФЗ, проводки, формы ГИР БО, аудит). Налоговые цифры у обоих паков из единого канона, расчёты согласованы.
## Установка
### Claude Code / Cowork (родной формат)
```text
/plugin marketplace add ilyautov/small-business-ru
/plugin install small-business-ru@small-business-ru
```
Затем скажите **«настрой меня»**: скилл `smb-onboard` поможет Claude понять ваш бизнес и подключить инструменты. Подключение РФ-сервисов (1С, ЮKassa, Битрикс24, Контур.Диадок, Яндекс 360, Telegram) опционально; без коннекторов скиллы работают через выгрузку CSV/Excel.
### Через skills.sh (любой Claude-агент)
```bash
npx skills add ilyautov/small-business-ru
```
CLI [skills.sh](https://skills.sh) клонирует репозиторий и ставит скиллы в каталог вашего агента (Claude Code, Cursor, Codex, Gemini CLI и др.), для Claude Code через симлинк.
### Claude.ai (веб-интерфейс)
Claude.ai принимает скиллы по одному: один ZIP — один скилл с `SKILL.md` в корне архива. Для зонтичного пака из 34 скиллов загрузка идёт по той же схеме поштучно:
1. Склонируйте репозиторий и заархивируйте нужный скилл из `small-business-ru/skills/`, например `counterparty-guard`:
```bash
git clone --depth 1 https://github.com/ilyautov/small-business-ru
cd small-business-ru/small-business-ru/skills
zip -r counterparty-guard.zip counterparty-guard/
```
2. Откройте Claude.ai → **Settings** → **Capabilities** → **Skills**.
3. Нажмите **Upload skill** и выберите архив.
4. Повторите для остальных скиллов, которые нужны (или начните с `smb-router` — он маршрутизирует к остальным по обычной речи).
> Если Claude.ai не принимает архив из-за лишней вложенной папки, зайдите внутрь неё и заархивируйте содержимое ещё раз, чтобы `SKILL.md` оказался в корне ZIP.
### Организации (Enterprise и Team)
Администраторы Claude for Work раскатывают скиллы централизованно через workspace skill library, и они становятся доступны всей команде без индивидуальной загрузки каждым сотрудником. Загрузите ZIP нужного скилла (см. выше) в **Admin Console → Workspace Skills → Add skill**. Для полного пака повторите на каждый из 34 скиллов или на те, что нужны команде.
### API (`/v1/messages` и аналоги)
При вызове API скилл передаётся параметром `container.skills`: укажите путь к нужному скиллу из `small-business-ru/skills/` (например `small-business-ru/skills/tax-calendar-proactive`). Детали формата — в документации вашего клиента Anthropic API.
### Другие AI-стеки (Codex, ChatGPT, Gemini, Cursor)
Логика переносима: один источник (`SKILL.md`), а под стеки идут обёртки, тело не форкается. Готовые адаптеры лежат в папке [`adapters/`](./adapters/) (alpha) для трёх killer-скиллов:
| Стек | Как подключить |
|---|---|
| **Codex (OpenAI CLI)** | скопировать [`adapters/codex/AGENTS.md`](./adapters/codex/AGENTS.md) в корень проекта |
| **ChatGPT / Custom GPT** | вставить [`adapters/chatgpt/*.md`](./adapters/chatgpt/) в Instructions (один GPT на один скилл) |
| **Gemini (CLI)** | скопировать [`adapters/gemini/GEMINI.md`](./adapters/gemini/GEMINI.md) в корень проекта |
| **Cursor / Windsurf** | скопировать [`adapters/cursor/*.mdc`](./adapters/cursor/) в `.cursor/rules/` |
Скрипты расчёта (`fetch_counterparty.py`, `tax_calc.py`) работают в Claude Code, Codex, Gemini CLI и Cursor. В чистом ChatGPT без Code Interpreter расчёт идёт по формулам в промпте либо просит принести выгрузку.
### Другие агенты (общий стандарт SKILL.md)
Формат Agent Skills стал кросс-платформенным, поэтому пак работает и за пределами четырёх стеков с готовыми адаптерами выше. Каждый из 34 скиллов — это папка с `SKILL.md` в `small-business-ru/skills/<имя-скилла>/`; агенты, читающие этот формат нативно, просто ждут её в своём каталоге скиллов:
| Как подключается | Агенты | Что делать |
|---|---|---|
| Читают `SKILL.md` нативно | GitHub Copilot, Cline, Roo Code, Goose, OpenCode | Скопировать нужную папку из `small-business-ru/skills/` в каталог скиллов агента (например `.agents/skills/`) |
| Конвертация инсталлером | Windsurf, Trae, Junie | Поставить через их установщик скиллов, указав репозиторий `ilyautov/small-business-ru` |
| Ручная вставка | Zed, Aider, Continue.dev | Вставить тело `SKILL.md` нужного скилла в файл правил или инструкций агента |
Универсальный путь: скопируйте папку скилла целиком (не только `SKILL.md` — вместе с ней едут скрипты расчёта, если они есть) в каталог, который агент сканирует, и перезапустите его. Триггеры активации те же, что в Claude.
## Использование
Попросите Claude по-русски, обычными словами:
```
проверь поставщика по ИНН 7700000000 перед предоплатой
что у меня горит по налогам в этом квартале
построй прогноз денежного потока на 3 месяца
кто из клиентов должен и сколько просрочено
```
Не уверены, с чего начать, скажите **«настрой меня»** или **«что ты умеешь для моего бизнеса»**. Роутер сам подберёт нужный скилл и спросит, чего не хватает.
📋 **Все 34 скилла с примерами фраз** расписаны в [USAGE.md](./USAGE.md): деньги, налоги, продажи, клиенты, контент, найм, договоры, брифы.
## До и после
**Проверка контрагента в одном агрегаторе:**
> Открыл один сервис: около 500 судебных дел. Выглядит терпимо, дал отсрочку.
**Через `counterparty-guard`:**
> Quick-scan по deal-killer-сигналам: статус «в стадии ликвидации» (ЕГРЮЛ) плюс исполнительные производства ФССП. 🔴, сбор остановлен, отсрочку давать нельзя. Число судов у трёх агрегаторов разошлось почти втрое, так что взяли не самую красивую цифру, а пересечение источников с датами.
Разница не в «более умном чате», а в том, что факт это совпадение источников, и deal-killer ловится до сделки, а не после отгрузки.
## Часто ищут
**Как проверить контрагента по ИНН перед сделкой?** Скилл `counterparty-guard` собирает открытые данные (ЕГРЮЛ, ФССП, картотека арбитража, ЕФРСБ, финансы) и выдаёт светофор риска с причиной и рекомендацией (предоплата / отсрочка / избегать). Сначала быстрый quick-scan по deal-killer-сигналам, потом полное досье по запросу.
**Как не пропустить срок налога по УСН?** `tax-calendar-proactive` сам показывает ближайшие сроки (авансы УСН, страховые взносы ИП, отчётность), считает суммы скриптом и заранее предупреждает о приближении к порогам.
**Работает ли это без 1С, с выгрузкой Excel?** Да. Коннекторы к 1С, банку, CRM опциональны; базово скиллы работают на ваших выгрузках CSV/Excel.
**Можно ли использовать не в Claude, в Cursor, ChatGPT, Codex, Gemini?** Да, для трёх killer-скиллов есть адаптеры в папке [`adapters/`](./adapters/). Тело логики одно, меняется только способ установки.
**Это бесплатно?** Да, открытый код под Apache-2.0. Берите, форкайте, дорабатывайте. Внедрение под вашу отрасль и данные это отдельная услуга, см. [сайт](https://small-business-ru.aifrontier.tech/vnedrenie.html).
**Чем отличается от агрегаторов вроде Контур.Фокуса или Checko?** Скилл их не заменяет, а **сводит несколько источников** и показывает расхождения вместо одной цифры, потому что счётчики у агрегаторов не совпадают. Плюс он встроен в вашего AI-агента и работает в связке с остальной операционкой.
**Безопасно ли, куда уходят мои данные?** Скилл это инструкция для вашего агента; он работает там, где работает ваш Claude или Cursor. TLS-проверка в скриптах включена по умолчанию. Что и куда отправлять, решаете вы; для чувствительных данных можно держать всё локально.
## Чем это не является
Готовит черновики и помогает в работе, но не заменяет профессиональную консультацию. Налоговые и правовые расчёты сверяйте с актуальным законодательством и профильным специалистом. Решение, которое трогает деньги или клиентов, всегда за вами.
Это alpha и открытый код, поэтому **ставьте, проверяйте на своих данных и экспериментируйте.** Нашли косяк, спорную цифру или нужен скилл под вашу задачу, заводите [issue](https://github.com/ilyautov/small-business-ru/issues) или пишите. Цифры в примерах намеренно округлены; доверяйте не нашим, а своим прогонам.
## Проверка, вклад, безопасность
- **Eval.** Калькуляторы сверены на контрольных точках: `python3 eval/run_eval.py` (и в CI на каждый PR). Методика в [`eval/README.md`](./eval/README.md).
- **Как помочь.** Багрепорты, цифры под сомнением, новые скиллы: [CONTRIBUTING.md](./CONTRIBUTING.md).
- **Безопасность.** Модель угроз, TLS в сетевых скриптах, как сообщить об уязвимости: [SECURITY.md](./SECURITY.md).
## Лицензия и атрибуция
Apache-2.0 (см. [`LICENSE`](./LICENSE)). 31 из 34 скиллов это локализованная адаптация открытого пака Anthropic [knowledge-work-plugins / small-business](https://github.com/anthropics/knowledge-work-plugins) (Apache-2.0): структура и сценарии от Anthropic, файлы переписаны под РФ. Оригинальные (не производные): `counterparty-guard`, `tax-calendar-proactive`; `cross-source-verify` адаптирован из `enterprise-search`. Подробности в [`NOTICE`](./NOTICE).
---
**small-business-ru** это открытый набор AI-скиллов для малого бизнеса в России: проверка контрагента по ИНН, налоговый календарь УСН на 2026, прогноз денежного потока, дебиторка, маржа, найм по ТК РФ. Бесплатный open-source для Claude Code, Cursor, Codex, ChatGPT и Gemini, а не онлайн-сервис «в один клик». Числа считаются кодом, данные берутся из реальных реестров ФНС/ФССП/арбитража.