Agent Skills — продакшен-навыки для AI-агентов от Addy Osmani

Addy Osmani — инженер из Google, автор книг «Learning JavaScript Design Patterns» и «Image Optimization». Его проект Agent Skills — это не набор промптов и не фреймворк. Это 25 структурированных workflow, которые заставляют AI-агентов работать как senior-инженеры: с спецификациями, тестами, ревью и всеми практиками, которые обычно выбрасываются ради скорости.

~98 тысяч звёзд на GitHub. Поддержка Claude Code, Cursor, Gemini CLI, OpenCode, Windsurf, GitHub Copilot, Codex, Antigravity, Kiro и любого другого агента, который принимает Markdown.

Зачем это нужно

AI-агенты по умолчанию идут по кратчайшему пути. Пропускают спецификации, не пишут тесты, игнорируют безопасность. Agent Skills даёт им структурированные workflow, которые заставляют агента проходить через те же этапы, что и опытный инженер.

Каждый навык — это не абстрактный совет, а конкретный процесс: шаги, контрольные точки, критерии выхода. Включены таблицы антирационализации — список типичных отговорок агента («добавлю тесты потом») с контраргументами.

Девять команд — девять этапов

Навыки организованы вокруг жизненного цикла разработки. Девять slash-команд активируют нужные навыки автоматически:

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

Навыки активируются и автоматически: проектирование API запускает api-and-interface-design, сборка UI — frontend-ui-engineering, и так далее.

Быстрый старт

Самый короткий путь — через open-source skills CLI, который ставит навыки в 70+ агентов (Claude Code, Cursor, Codex, Copilot, Cline и другие):

npx skills add addyosmani/agent-skills            # все 25 навыков
npx skills add addyosmani/agent-skills --list     # посмотреть перед установкой

Отдельный навык:

npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me
npx skills add addyosmani/agent-skills --skill test-driven-development

Нюанс: установка одного навыка через npx копирует только skills/<name>/, без общего каталога references/. Навык работает, но пути к общим чеклистам недоступны. Проблема отслеживается в #361.

Claude Code (рекомендуется):

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Cursor: workflow-навыки в .cursor/skills/, короткие политики в .cursor/rules/*.mdc — не вставляйте полные навыки в rules.

OpenCode: скопировать навыки в .opencode/skills/, добавить проектный AGENTS.md.

Gemini CLI:

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Codex (CLI v0.122+):

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

Полные инструкции — в docs/ для каждого инструмента. Для внедрения в существующий кодбейс есть Adoption Guide: полный жизненный цикл с первого дня для новых проектов или поэтапный verification-first rollout для устоявшихся.

Все 25 навыков

Команды выше — только точки входа. Пакет включает 25 навыков: 24 навыка жизненного цикла плюс мета-навык using-agent-skills.

Мета — какой навык применить

using-agent-skills — сопоставляет входящую работу с нужным workflow и задаёт общие правила работы.

Определение — что именно строим

interview-me — агент задаёт по одному вопросу за раз, пока не достигнет ~95% уверенности в том, что вы хотите. Не даёт себе уйти в реализацию, пока задача не ясна.

idea-refine — структурированное дивергентно-конвергентное мышление. Превращает размытую идею в конкретное предложение.

spec-driven-development — пишет PRD: цели, команды, структура, стиль кода, тестирование, границы. До строчки кода.

constraint-driven-development — интервьюирует вас по планке качества с разумными порогами по умолчанию, пишет CONSTRAINTS.md, расставляет проверки по стоимости и ловит агентов, которые отключают проверки или пропускают тесты, чтобы «получить зелёный».

Планирование — разбиваем на задачи

planning-and-task-breakdown — декомпозирует спецификацию на маленькие, верифицируемые задачи с критериями приёмки и учётом зависимостей.

Разработка — пишем код

incremental-implementation — тонкие вертикальные слайсы: реализовать → протестировать → проверить → закоммитить. Feature flags, безопасные значения по умолчанию, откаты.

test-driven-development — классический Red-Green-Refactor. Пирамида тестов (80/15/5), размеры тестов, DAMP вместо DRY, правило Бейонсе, браузерное тестирование.

context-engineering — кормит агента правильной информацией в нужный момент: rules-файлы, упаковка контекста, MCP-интеграции.

source-driven-development — каждое решение о фреймворке подтверждается официальной документацией. Проверить, процитировать источник, пометить непроверенное.

doubt-driven-development — adversarial-ревью каждого нетривиального решения: CLAIM → EXTRACT → DOUBT → RECONCILE → STOP, с опциональной эскалацией на другую модель. Когда ставки высоки — продакшен, безопасность, необратимые изменения.

frontend-ui-engineering — архитектура компонентов, дизайн-системы, управление состоянием, адаптивная вёрстка, WCAG 2.1 AA.

api-and-interface-design — контракт-first дизайн, закон Хайрама, One-Version Rule, семантика ошибок, валидация на границах.

Верификация — доказываем, что работает

browser-testing-with-devtools — Chrome DevTools MCP для живых данных: инспекция DOM, консоль, сеть, профилирование.

debugging-and-error-recovery — пятишаговый триаж: воспроизвести → локализовать → минимизировать → исправить → защитить. Правило stop-the-line.

Ревью — контроль качества перед слиянием

code-review-and-quality — ревью по пяти осям, размер изменений ~100 строк, метки серьёзности (Nit/Optional/FYI), нормы скорости ревью, стратегии разбиения.

code-simplification — забор Честертона, правило 500. Уменьшение сложности с сохранением поведения.

security-and-hardening — OWASP Top 10, паттерны авторизации, управление секретами, аудит зависимостей, трёхуровневая система границ.

performance-optimization — сначала измеряем. Core Web Vitals, профилирование, анализ бандла, обнаружение антипаттернов.

Деплой — отправляем в продакшен

git-workflow-and-versioning — trunk-based разработка, атомарные коммиты, размер изменений ~100 строк, паттерн commit-as-save-point.

ci-cd-and-automation — Shift Left, feature flags, пайплайны качества, циклы обратной связи при ошибках.

deprecation-and-migration — код как liabilities, обязательное vs рекомендованное устаревание, паттерны миграции, удаление zombie-кода.

documentation-and-adrs — Architecture Decision Records, документация API, стандарты inline-документации. Документируем почему.

observability-and-instrumentation — структурированные логи, RED-метрики, трейсинг OpenTelemetry, симптомные алерты. Инструментируем сразу, как пишем.

shipping-and-launch — предзапусковые чеклисты, жизненный цикл feature flags, поэтапные релизы, процедуры отката, мониторинг.

Агентные персоны

Четыре преднастроенных специалиста для целевых ревью:

Матрица принятия решений и правила оркестрации — в docs/agents.md.

Справочные чеклисты

Быстрая справка, которую навыки подключают по мере необходимости: definition-of-done.md, testing-patterns.md, security-checklist.md, performance-checklist.md, accessibility-checklist.md, observability-checklist.md, orchestration-patterns.md — семь файлов в каталоге references/.

Анатомия навыка

Каждый навык следует единой структуре:

• Overview — что делает навык
• When to Use — условия активации
• Process — пошаговый workflow
• Rationalizations — таблица отговорок с контраргументами
• Red Flags — признаки, что что-то не так
• Verification — требования к доказательствам

Ключевые принципы: процесс, а не текст. Верификация обязательна. «Кажется правильным» — недостаточно. Прогрессивное раскрытие — SKILL.md это точка входа, дополнительные ресурсы загружаются по необходимости.

Инженерная культура Google

Навыки основаны на практиках из Software Engineering at Google и руководства по инженерным практикам Google. Конкретные концепции, встроенные в workflow:

• Закон Хайрама — в API-дизайне
• Правило Бейонсе и пирамида тестов — в тестировании
• Размер изменений и нормы скорости ревью — в code review
• Забор Честертона — в упрощении кода
• Trunk-based разработка — в git workflow
• Shift Left и feature flags — в CI/CD
• Код как liabilities — в deprecation

Структура репозитория

Портативное ядро лежит в общих каталогах, адаптеры — в путях нативных discovery-конвенций:

Сравнение с другими коллекциями

Как это соотносится с Superpowers и навыками Matt Pocock? Честное сравнение трёх подходов — в docs/comparison.md, с ссылкой на контролируемый head-to-head эксперимент.

Ресурсы

• GitHub — исходный код и документация
• docs/skill-anatomy.md — формат навыков
• docs/getting-started.md — руководство для новых агентов
• docs/adoption-guide.md — внедрение в существующий проект
• skills/using-agent-skills/SKILL.md — мета-навык