Cole's AI Skills — 34 навыка для агентной разработки с PIV-циклом

Cole Medin — автор курса Agentic Coding на Dynamous, и этот репозиторий — его личный рабочий набор: 34 навыка, которые он реально использует при разработке с AI-агентами, straight out of .claude/skills/. Никакого фреймворка — каждый навык это markdown-файл, который читается за две минуты. Читайте, берите подходящие, переписывайте остальное под себя.

Центральная идея — один цикл, который автор прогоняет почти на каждой задаче:

prime → plan → implement → validate → review → commit → PR

Вокруг цикла — то, что его кормит (PRD, архитектура, нарезка эпиков), то, что запускает его параллельно (worktrees), и мета-навыки, которыми вы строите собственный AI Layer.

Что такое навык и почему это работает

Навык — папка с SKILL.md внутри: имя, описание того, когда применять, и процедура. Агент грузит при старте только описание, а полный текст подтягивает, когда работа совпала. Именно поэтому навыки масштабируются там, где захлёбывается двухтысячестрочный CLAUDE.md.

Весь набор стоит примерно 4400 токенов always-on контекста — и это только описания; тела навыков загружаются по необходимости. Команда claude plugin details skills покажет разбивку по каждому.

Установка

Плагин Claude Code — проще всего, обновляется сам:

/plugin marketplace add coleam00/skills
/plugin install skills@cole-medin

Все 34 навыка ставятся managed и read-only, новые подтягиваются через /plugin marketplace update. Навыки неймспейсятся: /skills:piv-implement. Если первая команда падает с Permission denied (publickey) — shorthand предпочитает SSH; передайте HTTPS-URL напрямую или установите CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1.

Редактируемые файлы в любом агенте:

npx skills add coleam00/skills             # всё
npx skills add coleam00/skills --list      # сначала посмотреть, что есть
npx skills add coleam00/skills --skill piv-plan-implementation piv-implement piv-validate

Флаг -g ставит глобально в ~/.claude/skills/ вместо текущего проекта. Автор рекомендует именно этот путь: файлы настоящие, ваши — их можно и нужно править.

Или просто скопировать — они всего лишь markdown:

git clone https://github.com/coleam00/skills.git
cp -r skills/.claude/skills/piv-implement your-project/.claude/skills/

Или попросить агента — тоже рабочий вариант: склонировать репозиторий, заглянуть в .claude/skills/ и скопировать то, что подходит проекту, с объяснением выбора.

Состав набора

Prime: загрузить правильный контекст — и только его

prime-codebase, prime-backend, prime-frontend — ориентируют агента в кодовой базе до планирования и реализации. Второй скоупится на API-роуты, сервисы и слой данных, третий — на компоненты, роутинг, стейт и стилизацию.

Plan: намерение до реализации

PIV-цикл: plan, implement, validate

Issues: диагностика до фикса

piv-investigate-issue — параллельное расследование GitHub-исью до обоснованного RCA (root cause analysis), piv-implement-issue — реализует фиксы по этому RCA, с регрессионными тестами.

Параллельная работа

worktree-create поднимает N git worktrees — каждый настроен, зависимости установлены, health-check пройден. worktree-merge интегрирует ветки через одну безопасную integration-ветку.

Мета-навыки: стройте свой AI Layer

Автономия

build-dark-factory — принимает PRD и строит вокруг неё репозиторий, который поставляет валидированный код без человека за клавиатурой. Все пять компонентов — в порядке строительства, плюс детерминированный аудит того, что построено. PRD он сознательно не пишет: принесите свою или сделайте сначала через plan-create-prd.

Инструменты

agent-browser — браузерная автоматизация (навигация, заполнение форм, клики, скриншоты, извлечение данных); ast-grep — структурный поиск по AST-паттернам вместо текста; drive-screen — реальное управление рабочим столом на Windows, macOS и Linux; setup-ai-tutor — семпловый проект курса, адаптируйте или удалите.

Использование с другими агентами

Навыки — просто markdown, никакого Claude-специфичного рантайма здесь нет. CLI npx skills ставит набор в 75+ агентов (Codex, Cursor, Copilot, Cline, Windsurf, OpenCode, Continue и остальные) в те каталоги, которые каждый из них ожидает:

npx skills add coleam00/skills -a codex
npx skills add coleam00/skills -a cursor -a claude-code

Если у агента нет механизма навыков вовсе, работает скучный и эффективный фолбэк: держите папку в репозитории и укажите на неё в AGENTS.md (или аналоге), велев агенту читать соответствующий SKILL.md перед началом работы такого типа.

Два нюанса при переносе:

• Слэш-команды. Ссылки навыков друг на друга (/piv-validate) рассчитаны на инвокацию Claude Code. В других агентах говорите «use the piv-validate skill»
• allowed-tools во frontmatter. Несколько навыков его объявляют; другие агенты безвредно игнорируют это поле

Хуки: вторая половина AI Layer

Навыки — процедурная половина AI Layer, то, до чего агент дотягивается сам. Папка hooks/ — вторая половина: детерминированный код, который срабатывает на событии жизненного цикла, вспомнит модель или нет.

Правило просит агента вести себя хорошо. Хук гарантирует.

Шесть готовых хуков лежат в hooks/: блокировка любых путей к вашим секретам, отказ на rm -rf, принуждение заявленной связности файлов, логирование каждого вызова инструмента, инъекция текущего git-состояния на старте сессии, запрет агенту закончить работу с красными тестами — и пинг вам, когда он закончил.

mkdir -p .claude/hooks
cp hooks/*.py .claude/hooks/
cp hooks/settings.json.example .claude/settings.json

Хук начинает действовать в момент появления — в отличие от навыка. Поэтому читайте их до подключения, задайте TEST_COMMAND в stop-хуке и проверьте оба направления: exit 0 на зелёных тестах, exit 2 на красных.

Подгоните под себя

Две вещи сознательно поставляются шаблонами и ждут правки до первого использования:

• piv-validate содержит список команд-заглушек — впишите реальные команды тестов, проверки типов и линтера вашего проекта
• piv-commit и piv-create-pr читают .claude/references/conventions.md, если он существует (первый — секцию ## commit, второй — ## pr). Создайте файл, и они будут следовать вашим конвенциям, а не гадать

piv-review-pr отдаст глубокую проверку сабагенту code-reviewer, если он у вас есть в .claude/agents/; без него ревью выполняется инлайн — навык всё равно работает.

Всё остальное работает из коробки. Но прочитайте всё равно: навык, который вы не читали, — просто более длинный промпт, который вы не контролируете.

Лицензия MIT — берите, форкайте, переписывайте.