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

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

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

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

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

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

Семь команд — семь этапов

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

Все 23 навыка

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

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

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

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

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

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 разработка, атомарные коммиты, паттерн commit-as-save-point.

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

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

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

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

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

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

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

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

• 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

Установка

Claude Code:

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

Gemini CLI:

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

Cursor: скопируйте SKILL.md в .cursor/rules/

OpenCode: AGENTS.md + skill tool, инструкция в docs/opencode-setup.md

Навыки — это чистый Markdown. Работают с любым агентом, который принимает системные промпты или файлы инструкций.

Ресурсы

• GitHub — исходный код и документация
• docs/skill-anatomy.md — формат навыков
• docs/getting-started.md — руководство для новых агентов