~/VibeHandbook

Агентные инструменты

docs.claude.com

Skills

Что это

Skill (навык) — это упакованный набор инструкций и ресурсов, который обучает ИИ-агента для кодирования выполнению конкретной задачи. Вместо того чтобы заново объяснять свои соглашения в каждом разговоре, вы записываете их один раз в виде Skill — короткое описание плюс шаги, примеры и любые вспомогательные файлы — и агент загружает его по требованию, когда возникает задача. Воспринимайте это как рецепт, к которому агент обращается, когда ситуация совпадает.

Сильные стороны

  • Фиксирует ноу-хау один раз и переиспользует его, так что вы перестаёте повторять одну и ту же подготовку в каждом запросе.
  • Загружается только когда уместно, поэтому не засоряет контекст агента в остальное время.
  • Простые, читаемые файлы — обычно Markdown — поэтому их легко писать, проверять и версионировать в git.
  • Можно делиться внутри команды или между проектами, давая всем одну и ту же проверенную процедуру.

Компромиссы

  • Устаревший или расплывчатый Skill может направить агента не туда; как и документация, он требует поддержки.
  • Слишком много пересекающихся Skills могут запутать, какой из них применять.
  • Он помогает только когда агент распознаёт задачу и подтягивает его.
  • Это рекомендация, а не гарантия — агент всё равно может отклониться от сценария.

Когда использовать

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

Подходит для vibe coding

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

---
name: ship-checklist
description: Steps to take before shipping any change to production.
---

1. Run the test suite and confirm it passes.
2. Bump the version in package.json.
3. Update CHANGELOG.md with a one-line summary.
4. Commit, push, then deploy.