# Agent Skills: школа синьор-разработчика для вашего ИИ-ассистента

- Site: VeraPoint News
- Section: Инструменты
- Date: 2026-05-18
- Canonical: https://verapointmedia.com/tools/addyosmani-agent-skills/
- Markdown: https://verapointmedia.com/tools/addyosmani-agent-skills.md
- Summary: Набор из 20 инструкций, который превращает Claude Code и Cursor из импульсивных кодеров в методичных инженеров с чётким процессом от идеи до деплоя.
- Target queries: Agent Skills: школа синьор-разработчика для вашего ИИ-ассистента; addyosmani agent skills; обзор Agent Skills: школа синьор-разработчика для вашего ИИ-ассистента; как использовать addyosmani agent skills
- Tags: #ai-agents #claude-code #cursor #devtools #productivity #coding
- Image: https://verapointmedia.com/static/content-assets/tools/addyosmani-agent-skills/cover.webp

## Sources

- https://github.com/addyosmani/agent-skills
- https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account
- https://github.com/addyosmani/agent-skills.git
- https://kiro.dev/docs/skills/

---

Agent Skills — это библиотека markdown-файлов, которая превращает ваш ИИ-ассистент из импульсивного кодера, пишущего «как получится», в методичного инженера с чётким процессом разработки: от проработки идеи до деплоя в продакшен. Проще говоря, это «школа синьора», упакованная в инструкции для Claude Code, Cursor и Gemini CLI: https://github.com/addyosmani/agent-skills

## Если просто

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

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

Всё это оформлено как обычные markdown-файлы с чёткими шагами. Например, команда `/spec` заставляет ИИ сначала задать уточняющие вопросы и написать PRD (я проверила — это Product Requirements Document, по-нашему просто «техническое задание»), прежде чем трогать код. А `/build` работает по принципу «тонких вертикальных срезов» — маленьких кусочков функциональности, которые можно сразу проверить, а не «написал 500 строк — теперь дебажу три дня».

## Что это решает

Главная боль современной разработки с ИИ — это «вайб-кодинг» (vibe coding), когда агент генерирует код быстро, но как попало. Получается спагетти, которые работают до первого рефакторинга, без тестов, без документации, с закомментированными кусками «на всякий случай».

Agent Skills добавляет палочки-выручалочки в виде 20 конкретных «навыков» — от проектирования API до оптимизации производительности. Каждый навык — это проверенный workflow: шаги, что проверить, на что обратить внимание, таблица «рационализации против реальности» (когда ИИ пытается вам сказать «ну так сойдёт», а инструкция требует «нет, переделай»).

Особенно ценно, что это не абстрактные советы вроде «писать чистый код», а конкретные триггеры. Например, если вы работаете с UI, автоматически активируется навык `frontend-ui-engineering`, который проверяет доступность по стандарту WCAG 2.1 AA (я уточнила — это требования к интерфейсам для людей с ограниченными возможностями). Или если ловите баг — включается `debugging-and-error-recovery` с пятиступенчатым процессом: воспроизвести → локализовать → упростить → починить → защитить от повторения.

## Как попробовать

Самый простой путь — через Claude Code (консольный агент Anthropic). Вводите:
```
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```
Если ругается на SSH-ключи (а marketplace клонирует репозитории именно через SSH), используйте HTTPS:
```
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
```
Или просто склонируйте репозиторий локально и укажите путь:
```bash
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
```

Для Cursor всё проще: копируйте любой `SKILL.md` из папки `skills/` в `.cursor/rules/` вашего проекта — и ИИ начнёт следовать этим правилам автоматически. Можно просто скормить папку целиком.

Для Gemini CLI есть нативная установка:
```bash
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
```

## 3 сценария с примерами

**Сценарий 1: Вы стартапер, и вам нужна новая фича (например, система подписок)**
Вместо «Claude, сделай мне платежи» → получить неработающий код на 800 строк.
Вы вводите `/spec`. ИИ сначала пишет полноценное ТЗ: какие команды нужны пользователю, структура базы данных, границы системы (что внутри, что снаружи), стиль кода. Потом `/plan` разбивает это на атомарные задачи: «создать таблицу», «добавить валидацию», «интеграция со Stripe». Потом `/build` реализует первую задачу, сразу с тестами. Результат: через три часа у вас рабочий MVP, который не стыдно показать, а не франкенштейн, который выкинете на следующей неделе.

**Сценарий 2: Вы одинокий разработчик, и некому проверить ваш код**
Вводите `/review` перед коммитом. ИИ запускает пятиступенчатую проверку: архитектура, безопасность (ищет инъекции, незащищённые эндпоинты), производительность (проверяет N+1 запросы в базу), читаемость, соответствие ТЗ. Находит, что вы забыли валидацию входных данных в API. Вы исправляете. Только потом `/ship`. Результат: код, который не сломает продакшен в пятницу вечером.

**Сценарий 3: Баг, который виден только в браузере**
Вы используете `/test` вместе с навыком `browser-testing-with-devtools`. ИИ подключается к Chrome через MCP (Model Context Protocol — я поясню, это такой способ дать ИИ руки в вашем браузере) и сам смотрит в консоль, проверяет DOM, смотрит network-запросы. Вместо ваших попыток описать «ну тут что-то красное в консоли» ИИ сам видит точную ошибку CORS или незагрузившийся скрипт. Результат: дебаг в 10 минут вместо двух часов переписки «а попробуйте перезагрузить».

## Где можно застрять

Во-первых, это не волшебная кнопка. Если вы используете Cursor или Copilot, slash-команды типа `/spec` не работают «из коробки» — там нет такого интерфейса. Вы просто копируете текст инструкций в системный промпт, и качество зависит от того, насколько внимательно ИИ прочтёт эту простыню.

Во-вторых, для Claude Code marketplace требует настроенных SSH-ключей на GitHub. Если вы привыкли работать только через HTTPS, придётся повозиться с ключами или использовать прямую ссылку на репозиторий.

В-третьих, оверхед. Если вы пишете скрипт на 20 строк для конвертации CSV в JSON, полный цикл «спецификация → планирование → ревью» — это как ездить на танке за хлебом. Процесс заточен под серьёзные фичи, а не быстрые прототипы.

И ещё один момент, который меня смущает: это всё ещё markdown-файлы. Если ИИ решит проигнорировать часть инструкций или «схалтурить», никакого enforcement нет. Это скорее «настоятельная рекомендация», чем жёсткий контроль.

## Кому это нужно

Соло-разработчикам, у которых нет ментора или синьора, глядящего через плечо. Стартаперам, которые хотят заложить архитектуру правильно с первого раза, а не переписывать всё через полгода. Командам, где много джунов, и нужно выравнивать качество кода. И всем, кто боится «вайб-кодинга» и хаоса, который ИИ может устроить, если его не держать в узде.

## Кому это не нужно

Если у вас уже выстроенные процессы с code review человеком, CI/CD, и вы привыкли писать спецификации сами — добавление ИИ-посредника может замедлить. Тем, кто использует ИИ только для быстрых одноразовых скриптов — формальности излишни. И если вы только начали программировать и путаетесь в терминах «транк-бейзд девелопмент» или «ред-грин-рефактор» — сначала разберитесь с базой, иначе ИИ будет говорить вам слова, которые вы не понимаете, но будете стесняться спросить.

## Вердикт Веры

Agent Skills — это не инструмент в привычном смысле, а скорее методология, упакованная в текстовые файлы. Она не делает ИИ умнее, но заставляет его работать менее импульсивно.

Я бы сравнила это с переходом от набросков на салфетке к работе по чертежу. Да, медленнее. Да, требует дисциплины. Но если вы строите не шалаш на выходные, а дом, в котором будете жить — лучше с чертежом.

Забирайте, если готовы торговать скорость хаотичного кодинга на предсказуемость результата. Оставьте, если вам важнее сегодняшний вечер, чем состояние кодовой базы через месяц.

## Материалы

- [addyosmani/agent-skills] addyosmani/agent-skills: https://github.com/addyosmani/agent-skills
- [docs.github.com] supporting context: https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account
- [github.com] supporting context: https://github.com/addyosmani/agent-skills.git
- [kiro.dev] supporting context: https://kiro.dev/docs/skills/

## Что читать дальше

- [Как отличить рабочий AI-инструмент от красивой демки](https://verapointmedia.com/guides/kak-otlichit-rabochiy-ai-instrument-ot-krasivoy-demki/) — базовая рамка для проверки любых новых инструментов.
- [Spec Kit: вместо «я хочу» — «сделай, как я сказал», но с ИИ](https://verapointmedia.com/tools/github-spec-kit/) — пример инструмента, который упорядочивает работу, а не просто красиво выглядит.
- [Локальный AI против облачного: что выбрать обычному человеку и малому бизнесу](https://verapointmedia.com/guides/lokalnyy-ai-protiv-oblachnogo/) — помогает понять, где лучше держать данные и вычисления.