skill-developer
Полное руководство по созданию и управлению навыками в Claude Code с системой автоактивации. Следует официальным рекомендациям Anthropic, включая правило 500 строк и паттерн прогрессивного раскрытия.
AIsickn33
official
Разработка
★ 47.3k
Что делает навык
Навык предоставляет полное руководство по созданию, конфигурации и управлению навыками (skills) в среде Claude Code, включая настройку системы автоактивации через хуки. Он описывает архитектуру из двух хуков, типы навыков (guardrail и domain), уровни принудительного исполнения и правила оформления SKILL.md.
Когда применять
- Создание нового навыка с нуля: генерация файла SKILL.md с правильным frontmatter и добавление записи в файл конфигурации skill-rules.json.
- Отладка проблем с активацией навыков: проверка того, почему триггеры (ключевые слова, паттерны намерений) не срабатывают или вызывают ложные срабатывания.
- Настройка уровней принудительного исполнения (enforcement): определение, когда навык должен блокировать действия (BLOCK), предлагать рекомендации (SUGGEST) или выдавать предупреждения (WARN).
- Конфигурация условий пропуска (skip conditions): настройка отслеживания сессий, маркеров файлов или переменных окружения для управления поведением хуков.
Как работает
- Создайте файл SKILL.md в директории .claude/skills/{skill-name}/, добавив frontmatter с именем и описанием, содержащим ключевые слова для активации, и убедитесь, что объем текста не превышает 500 строк.
- Добавьте запись о новом навыке в конфигурационный файл .claude/skills/skill-rules.json, указав тип (domain или guardrail), уровень исполнения и триггеры (keywords, intentPatterns).
- Протестируйте срабатывание хука UserPromptSubmit с помощью команды npx tsx .claude/hooks/skill-activation-prompt.ts, передавая тестовые промпты.
- При необходимости протестируйте блокировку хука PreToolUse с помощью команды npx tsx .claude/hooks/skill-verification-guard.ts для проверки работы guardrail-навыков.
- Отрегулируйте паттерны триггеров и файловых путей на основе результатов тестирования, чтобы минимизировать ложные срабатывания и убедиться в корректной работе.
- При необходимости создайте файлы справки (reference files) для детальной документации, добавив к ним оглавление, если их объем превышает 100 строк.
Примеры запросов агенту
Как создать новый навык для проверки имен таблиц в Prisma, чтобы он автоматически блокировал ошибки при редактировании файлов?
Почему мой навык не активируется при упоминании React, и как отладить триггеры в файле skill-rules.json?
Как настроить хук так, чтобы он мягко напоминал об обработке ошибок после ответа, но не блокировал рабочий процесс?
Что понадобится
- Среда выполнения Claude Code с поддержкой системы хуков (.claude/hooks/)
- Наличие файла конфигурации .claude/skills/skill-rules.json
- Инструменты командной строки для запуска TypeScript-скриптов (npx tsx)
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «skill-developer» из репозитория:
# https://github.com/sickn33/agentic-awesome-skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r skill-developer/ ~/.claude/skills/skill-developer/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.