Skills от dzhng — 30 навыков для агентов, которые пишут код сами

Отдать фичу AI-агенту — это не то же самое, что поставить задачу и уйти. Сложность в другом: агент должен сам разобраться, где границы работы, что уже известно, а что придётся исследовать, и не бросить задачу на середине. Репозиторий dzhng/skills — это 30 навыков, которые превращают такую работу в повторяемый цикл: нарезать, собрать, проверить, повторить.

Что это за набор

Это личная библиотека автора репозитория, а не продукт компании. Навыки не привязаны к предметной области — они работают с любой кодовой базой. Каждый навык — это папка с файлом SKILL.md, который агент читает в момент вызова. Навыки небольшие, их можно свободно комбинировать и переписывать под себя.

Установка одна команда:

npx skills add dzhng/skills

Ключ --list покажет список и позволит выбрать нужные навыки по отдельности. Другой путь — просто скопировать папку skills/<категория>/<название>/ в папку навыков вашей обвязки агента (например, .claude/skills/).

Если репозиторий уже скачан, тот же результат даёт npm-скрипт из package.json:

npm run install-skills              # в ~/.agents/skills, с симлинком из ~/.claude/skills
npm run install-skills -- ../my-app # в конкретный репозиторий, а не в домашнюю папку
npm run install-skills -- --only write-spec,review ../my-app
npm run list-skills                 # имена и категории

Настоящие файлы лежат в .agents/skills/<название>/ — одной плоской копии без категорий. В .claude/skills/<название> лежит относительная символическая ссылка на неё, поэтому обе обвязки читают один и тот же набор. Повторный запуск перезаписывает установленные копии, но если .claude/skills/<название> у вас остался обычной папкой, скрипт его не тронет. Ключ --dry-run сначала показывает план.

Навыки работают с любой обвязкой агента, которая их поддерживает: Claude Code, Codex, opencode, Cursor, duet и ещё семьдесят с лишним. Полный список — в репозитории vercel-labs/skills.

Программная фабрика

Автор считает, что разработка уходит от разовых задач к фабрикам: агент сам идёт к цели и не останавливается, пока результат нельзя принять. Трудность не в том, чтобы разбить цель на задачи, — это умеет любой планировщик. Трудность в том, чтобы разбить её на куски, каждый из которых можно проверить по отдельности, и вообще понять, где эти куски проходят.

Сами навыки работают с метафорой тумана войны. Сначала местность картируют, потом вырезают из неё территории, которые строятся и проверяются независимо, а всё, что скрывает за собой новую карту, режут заново. Перепланирование не заканчивается вместе с планированием: спецификация остаётся живым документом и перенарезается прямо во время работы, как только выясняется, что план устарел. Каждый кусок обязан доказать, что он готов: ревью архитектуры, ревью кода и — для всего визуального — сверка с базовым изображением.

В качестве доказательства автор приводит один запуск Codex без присмотра: 3 дня 18 минут агент шёл к одной цели, сам нарезал работу и повторял цикл, пока не закончил.

Полный цикл: большая фича от начала до конца

1. Карта тумана. Навык /explore-unknowns разбирает идею по четырём квадрантам. Сначала он выясняет то, что уже известно, потом проводит интервью, показывает готовые артефакты, которые можно потрогать и отреагировать на них, и в конце делает отдельный проход по слепым зонам. На выходе — полная карта из четырёх квадрантов.

2. Формализация. Навык /write-spec превращает карту в спецификацию. Большая часть решений уже принята выше по потоку, поэтому этот шаг — переписывание, и автор в это время не читает текст. Если встречается что-то действительно новое, навык спрашивает, а не решает сам.

3. Сборка. Дальше включается цикл:

/goal /implement-spec specs/<feature>

/goal переводит обвязку агента в режим цикла — такой же приём работает и в Claude Code, и в Codex, — а спецификация им управляет. Маленькая фича занимает пару часов, большая — два-три дня. Команду можно уточнить: например, указать ветку или сказать, что код пишет Codex, а вы остаётесь главным оркестратором и ревьюером.

4. Ревью решений, а не правок. В конце запуска навык сводит файл specs/<feature>/choices.md — все решения, которые агент принял там, где спецификация молчала, от наименее уверенных. Это и есть то, что вы смотрите. Если решение не нравится, отправляете правку назад, и следующий проход проверяет себя заново. Каждый раз, когда ИИ пишет код, вы ревьюите то, что он выбрал.

Остальное срабатывает само: в конце каждого среза — проход /review, для всего визуального — /screenshot-critique и /compare-screenshots, после последнего среза — /close-spec, а если реализация показывает, что план устарел, план нарезается заново.

По времени вы потратите от 30 минут до нескольких часов на шаги 1–2 и столько же на шаг 4. Если прогон идёт два дня, по два-три часа уходит на каждом конце. Ваше время — это начало и конец, середина идёт без вас.

Исследование через быстрые эксперименты

Когда очередное решение требует не мнения, а данных, включается навык /auto-research. Он начинает с одной быстрой показательной задачи, проверяет короткую серию гипотез, перебирает их сочетания и расширяет перебор по мере того, как подход становится рабочим. Каждая новая неудача становится центром внимания, а уже пройденные задачи превращаются в проверки на то, что старое не сломалось. Реальный пример команды:

/auto-research Reduce cost per task by at least 15% relative to the saved
baseline, without reducing task success. Start with one fast development task.

Если непонятно, что считать оценкой, какой метрикой мерить и что за база, навык спрашивает до начала экспериментов. Пройти проверку и попасть в целевой процент — это два разных требования. На выходе вы получаете лучший проверенный артефакт и карту влияния параметров: что проверяли, где помогает, где мешает и как изменения взаимодействуют. Дальше эти данные идут в спецификацию.

Когда цикл не нужен

Полный конвейер требуется не всегда. Навыки можно брать по отдельности.

• Обсуждение превратилось в фичу. /explore-unknowns полезен и в начале, и в конце разговора: запустите его, чтобы собрать углы, которые ни вы, ни собеседник не подумали, и продолжите со второго шага.
• Правка, которая вышла за рамки. Случайный фикс, который задел больше ожидаемого: сначала /review (refactor-clean → code-review → write-docs), потом /audit-choices. Если правка слишком велика, чтобы её прочитать, сводка choices.md остаётся единственным способом понять, что теперь происходит в вашей кодовой базе.

Состав навыков

Engineering — нарезать, собрать, проверить, повторить

Visual review — не принимать картинку на глаз

Authoring — держать сами навыки в форме

Graphics

Лицензия и благодарности

Набор распространяется по лицензии MIT.

Навык retro скопирован у Мэтта Покока. Идеи тумана войны и «нарисуй карту» пришли от него же и от Тхарика. Навыки доступны на skills.sh/dzhng/skills.