headcount: «компания из агентов» для Claude Code
Что это на самом деле, сколько оно стоит в контексте модели, и как ставить, чтобы не сломать то, что уже работает.
Слепок на 2026-09-05: репозиторий cbrock84/headcount (плагины 1.0.0) и документация Claude Code на ту же дату. Числа посчитаны по файлам репозитория, а не взяты из README.
Пять пунктов, если читать только один экран
Что это
172 скилла для Claude Code в 16 «департаментах»: финансы, продажи, маркетинг, безопасность, юристы, HR. Каждый департамент — отдельный плагин. Метафора автора: «добавь департамент, а не промпт».
Что реально приезжает
Только текст: 172 файла SKILL.md с именем и описанием. Ни агентов (хотя README обещает), ни команд, ни хуков, ни MCP. Установка ничего не запускает; вся цена — контекст.
Цена не абстрактная
Список описаний всех скиллов сидит в контексте постоянно, и на него выделен бюджет — 1% окна, в символах. headcount целиком — 66 180 символов. Два-три департамента на стандартном окне переполняют бюджет, и Claude Code начинает резать описания — то, по чему скилл срабатывает.
Качество текста хорошее
Скиллы написаны как метод: порядок шагов, за каждым правилом — ошибка, которую оно ловит, в конце блок «Никогда». Контент переписан с нуля после лицензионного аудита; история — в журнале из 35 решений.
Как ставить
По одному департаменту, там, где нет своих скиллов, с /doctor после установки. technology дублирует стандартный инженерный набор (TDD, отладка, планирование, ревью) — ставить последним, если вообще.
Что это и откуда взялось
Скилл в Claude Code — файл SKILL.md: короткое описание в шапке (по нему модель решает, когда скилл нужен) и тело (что делать, когда он сработал). Плагин — пакет скиллов, ставится одной командой; маркетплейс — каталог плагинов. headcount — маркетплейс из 16 плагинов, и установочная строка читается как корпоративный адрес — имя выбрано ровно под этот эффект (журнал решений, D22):
/plugin marketplace add cbrock84/headcount
/plugin install security@headcountНад департаментами стоит executive (офис CEO); у каждого департамента есть скилл-«руководитель» (chief-financial-officer, head-of-pmo…), который держит зону ответственности и решает, когда специалисты расходятся. security и legal-risk объявлены reviewer-class: «стоят поперёк всех функций», их блокирующие выводы «не могут быть отменены департаментом, который они проверяют» — что это значит на практике, в §6.
Откуда контент и как рос
По журналу решений docs/DECISION-LOG.md: репозиторий начался как сборка из пяти чужих MIT-коллекций (106 скиллов) плюс 12 скиллов из общей папки Google Drive без лицензии. Осознав, что маркетплейс — это распространение, автор переписал всё с нуля (D3, D6): 77 заимствованных скиллов удалены, возможности написаны заново. Записана и собственная ошибка — оригиналы удалили до сверки с заменой, шесть скиллов потеряли содержание, восстановлены из истории (D4). Полнота каталога проверена не на глаз, а по классификатору профессий BLS SOC: найдено и закрыто восемь дыр — закупки, налоги, льготы, комплаенс, офис, ивенты (D30). Репозиторий создан 28 августа 2026; 30-го о нём написал The Daily Commit (тогда «125+ скиллов»), к 5 сентября — 172, поле About на GitHub так и осталось со старыми цифрами.
Как устроен один скилл
Скилл судят дважды: загрузился ли в нужный момент и помог ли, когда загрузился. Это формулировка самого headcount (technology:skill-authoring), и она верная.
Описание — маршрутизирует
Единственное, что модель читает, решая, нужен ли скилл. У headcount описания 258–608 символов (в среднем 384); CI отклоняет короче 80. Строятся однотипно: что скилл делает, затем в каких словах об этом спросят — включая косвенные: «почему не конвертит» так же, как «CRO-аудит».
Тело — работает
В среднем 3 400 символов ≈ 850 токенов, максимум 4 300. Грузится только при срабатывании и остаётся в разговоре. Форма одна: упорядоченная процедура, за каждым правилом названа ошибка, которую оно ловит, в конце блок ## Never.
1. Определите единицу. Клиент, аккаунт, место, заказ — большинство споров о юнит-экономике это споры о единице. 2. Маржинальная прибыль — выручка на единицу минус затраты, которые с ней меняются; занижение переменных затрат — самая частая ошибка, и она приукрашивает всё ниже по цепочке. 3. Стоимость привлечения — полная, включая зарплаты; исключить людей — вторая ошибка по частоте, занижает вдвое.
Никогда: сравнивать стоимость привлечения с выручкой вместо маржи; сообщать LTV без данных об удержании и окна наблюдения.
—finance:unit-economics, в переводе, сокращено
Скиллы-руководители устроены иначе: зона ответственности, «артефакты записи» (какой документ прав, если два расходятся), тулинг по слоям, эскалации — и обязательный шестичастный отчёт в конце каждого обращения: решение → почему → что это стоит → допущения → что изменило бы мнение → кто что делает дальше. Пятнадцать департаментов имеют такого руководителя; demand-generation подчинён CMO маркетинга.
Цена в контексте — главное, что надо знать до установки
Claude Code загружает в контекст список имён и описаний скиллов, чтобы Claude знал, что доступно. Список всегда содержит все имена, но если скиллов много, Claude Code укорачивает описания, чтобы уложиться в символьный бюджет списка — что может вырезать ключевые слова, по которым Claude сопоставляет ваш запрос. Бюджет — 1% контекстного окна модели. При переполнении Claude Code убирает описания начиная со скиллов, которые вы вызываете реже всего.
— документация Claude Code, «Skill descriptions are cut short», в переводе
- Описания грузятся всегда, тело — только при срабатывании.
- Бюджет маленький — 1% окна, в символах; на одно описание ещё и потолок 1 536 символов.
- Первыми теряют описание те, кого вызывали реже — то есть только что установленный скилл с нулём вызовов.
Ловушка холодного старта. Поставили департамент → бюджет переполнился → резать начали ровно то, что вы поставили. Скилл остаётся в списке именем, но модель больше не видит, когда его звать. Внешне это выглядит как «плагин не работает».
Сколько влезает в бюджет
Описания всех 172 скиллов — 66 180 символов (, то есть ≈16 500). Документация говорит «1% окна», но не уточняет перевод токенов в символы; ниже оба прочтения, точный множитель не подтверждён — его показывает /doctor. Департаменты на диаграмме сложены от меньшего к большему; линии — три оценки бюджета.
| Окно | Прочтение «1%» | Бюджет, символов | Влезает департаментов headcount (без учёта других плагинов) |
|---|---|---|---|
| 200 тыс. токенов | 1% токенов × 4 символа | ≈ 8 000 | два самых маленьких (2 519 + 2 720); третий переполняет |
| 200 тыс. токенов | 1% буквально в символах | ≈ 2 000 | ни одного — самый маленький департамент больше бюджета |
| 1 млн токенов | 1% токенов × 4 символа | ≈ 40 000 | одиннадцать; весь headcount не влезает и здесь |
Остальные ваши скиллы делят тот же бюджет. Для масштаба: 14 скиллов superpowers занимают ≈2 150 символов описаний — в 30 раз меньше всего headcount; один marketing втрое больше всего superpowers. Тела не проблема: 850 токенов за одно срабатывание — нормальная цена.
Таблица по департаментам: скиллов, символов описаний, токенов
| Департамент | Скиллов | Символов | ≈ токенов |
|---|---|---|---|
| marketing | 19 | 7 278 | 1 820 |
| technology | 19 | 6 905 | 1 726 |
| finance | 13 | 4 931 | 1 233 |
| product | 11 | 4 660 | 1 165 |
| operations | 12 | 4 404 | 1 101 |
| demand-generation | 12 | 4 388 | 1 097 |
| people | 12 | 4 343 | 1 086 |
| it-operations | 12 | 4 267 | 1 067 |
| revenue | 10 | 3 732 | 933 |
| legal-risk | 8 | 3 437 | 859 |
| security | 8 | 3 328 | 832 |
| executive | 7 | 3 323 | 831 |
| pmo | 9 | 3 085 | 771 |
| customer-experience | 7 | 2 860 | 715 |
| data-analytics | 7 | 2 720 | 680 |
| corporate-strategy | 6 | 2 519 | 630 |
| всего | 172 | 66 180 | ≈16 500 |
Штатные инструменты
- /doctor
- Размер списка скиллов и кто его раздувает — запускать сразу после установки.
- /context
- Строка Skills показывает список после применения бюджета — то, что видит модель.
- /skill-doctor
- Какие скиллы не вызывались; кандидаты на отключение.
- skillOverrides
"finance:tax": "name-only"— скилл в списке без описания (только по имени, бюджет не тратит);"off"— убрать целиком.- skillListingBudgetFraction
0.02— поднять бюджет до 2% окна, если контекста не жалко.
Пересечения с тем, что у вас уже стоит
Адресация департамент:скилл спасает от коллизии имён при явном вызове. Но автозагрузка идёт по описанию, и там побеждает тот, чьё описание модель сочла ближе, — не лучший, а случайный. Это написано в самом headcount:
Два скилла, чьи описания оба подходят под запрос, означают, что ни один не выигрывает надёжно. Прежде чем добавлять, проверьте, что уже покрывает эту землю.
—technology:skill-authoring, «Overlap is the silent killer»
technology и product — почти наверняка есть
19 скиллов technology — стандартный инженерный набор: TDD, системная отладка, планирование, код-ревью, проверка завершённости, worktree, параллельные агенты, написание скиллов. Это ядро самых распространённых процессных плагинов (superpowers — самый заметный). Если такой стоит, 9 из 19 приходят вторым голосом на той же теме. У product 6 из 11 (дизайн-система, стили, интерфейс, бренд) стоят на земле официального frontend-design.
Где обычно никто не конкурирует
finance, revenue, legal-risk, people, operations, pmo, corporate-strategy, customer-experience, it-operations. Сюда инженерные наборы не заходят — единственное место, где headcount работает как задумано: библиотека компетенций там, где своих нет.
Отключать точечно можно, но это чёрный список. headcount растёт быстро (с 125 до 172 скиллов за неделю), новые скиллы в обновлении приедут включёнными и могут встать на место погашенных. Правило: не ставить департамент, в котором пришлось бы выключить половину — если гасить 9 из 19, департамент не ваш.
Что лежит в поставке
Проверено по содержимому плагинов, не по README: приезжают только SKILL.md выбранных департаментов. Ни один plugin.json не объявляет агентов, команд, хуков или MCP-серверов; шапка у всех 172 скиллов — только name и description, без disable-model-invocation, так что все автозапускаемые. Радиус поражения от установки — ноль: ничего не исполняется и в ваш репозиторий не пишется; песочница не нужна, нужен подсчёт символов.
Подробно: что в репозитории и что из этого ставится
| В репозитории | Приезжает при /plugin install? |
|---|---|
16 плагинов, 172 файла SKILL.md | да — только выбранные департаменты; 36–112 КБ на департамент |
19 чартеров агентов в .claude/agents/ | нет — это агенты самого репозитория headcount, с зонами записи plugins/<департамент>/** внутри его дерева; README здесь не прав |
Reference-файлы и скрипт agent-guard.mjs | да, но только у одного скилла — executive:agent-hierarchy (≈47 КБ) |
| Команды, хуки, MCP-серверы | их нет — 0 |
Что headcount обещает, но обеспечить не может
«Выводы reviewer-class не могут быть отменены». В репозитории это структурно: карта поверхностей, ревьюер без зоны записи, проверка в CI. В вашей сессии security:threat-modeling — просто текст в контексте наравне с остальными; считать ли его вывод блокирующим, решает модель, а не механизм.
«Делегируйте департамент как субагента». Чартеры не приезжают (§5). Агента придётся написать самому и в нём сослаться на скиллы департамента.
Автозагрузка на не-английском. Все 172 описания на английском; как они срабатывают на запрос по-русски — не проверено ни автором, ни здесь.
Ни один скилл не ограничен в самозапуске. Без disable-model-invocation модель вправе подтянуть legal-risk:contract-review на любую реплику со словом «договор». Автор сам пишет: «ставьте то, что будете использовать, а не всё; меньший набор даёт более точное срабатывание».
Инженерный процесс за репозиторием — что стоит перенять
Для библиотеки промптов это необычно дисциплинированный репозиторий; возможно, метод здесь ценнее скиллов. Журнал решений — 35 записей, у каждой номер-адрес (присваивается, когда вопрос задан, и не переиспользуется), буквенные варианты, явная рекомендация и записанный исход; отвергнутые варианты остаются с причиной. Десять проверок в одном скрипте — тот же check-all.sh запускает и CI, «чтобы они не расходились»; README, оргчарт и соцкарточка генерируются из дерева и не могут от него отстать. Карта поверхностей — один владелец на каждый путь, проверяется машинно: метод из executive:agent-hierarchy, применённый к самому репозиторию.
Десять проверок CI — что именно не дают сломать
| Карта поверхностей | У каждого пути ровно один владелец-агент; ревьюер не может объявить зону записи |
| Шапки скиллов | Имя = директория, уникально; описание ≥ 80 символов |
| Provenance | Ни чужих лицензий, копирайтов, SPDX, ни шрифтов |
| README, соцкарточка, оргчарт | Сгенерированы из дерева и совпадают с ним; ручная правка ломает CI |
| Ссылки на скиллы | Каждое департамент:скилл в документации и телах существует |
| Американская орфография | Единый house style |
Блоки ## Never | Не смешивают два стиля пунктуации внутри одного блока — ловит вклейку чужого списка в середину; нашла пять реальных случаев, где плоское правило дало бы 59 ложных |
| Манифесты | Все plugin.json и marketplace.json — валидный JSON |
Как ставить, если ставить
/plugin marketplace add cbrock84/headcount
/plugin install finance@headcount- Один департамент — где нет своих скиллов и есть потребность. Автор советует идти от того, на что уходит неделя: IT →
it-operations,security; компания целиком →executive,finance,operations; продажи →revenue,marketing,demand-generation; найм →people,legal-risk. - Сразу
/doctor. Не влезло в бюджет —name-onlyдля ненужного или второй департамент не ставить. - 2–4 недели, потом
/skill-doctor. Скилл, не сработавший ни разу, платит контекстом и ничего не отдаёт — снимать. technology— последним или никогда, если стоит любой процессный плагин.- Не форкать. Резка по департаментам — родной механизм, внутри департамента —
skillOverrides. Форк нужен, только чтобы переписать содержание, а не выбрать его.
Чего здесь не проверяли
- Качество 166 из 172 тел. Полностью прочитано шесть — четыре инженерных и два финансовых; форму остальных гарантируют только проверки CI.
- Точный множитель бюджета. «1% окна» задокументировано, перевод токенов в символы — нет; истину показывает
/doctor. - Срабатывание на не-английских запросах и поведение reviewer-class в живой сессии — только эмпирика, здесь её не было.
- История коммитов. Клон неглубокий; история взята из журнала решений автора, а не из git.
Что читали
- github.com/cbrock84/headcount — README,
CONTRIBUTING.md,scripts/*, манифесты, все 172SKILL.md(шапки целиком, тела — шесть),.claude/agents/*.md; документация: GETTING-STARTED, USE-CASES, AGENT-SURFACES, DECISION-LOG (D1–D35), org-chart; интерактивный оргчарт. - GitHub API — звёзды, форки, даты, на 2026-09-05.
- Claude Code: документация по скиллам (загрузка описаний, бюджет списка,
skillOverrides), справочник настроек. - The Daily Commit, заметка от 2026-08-30.