AIKraft/Skills/skill-developer

skill-developer

Полное руководство по созданию и управлению навыками в Claude Code с системой автоактивации. Следует официальным рекомендациям Anthropic, включая правило 500 строк и паттерн прогрессивного раскрытия.

sickn33 official Разработка ★ 47.3k

Что делает навык

Навык предоставляет полное руководство по созданию, конфигурации и управлению навыками (skills) в среде Claude Code, включая настройку системы автоактивации через хуки. Он описывает архитектуру из двух хуков, типы навыков (guardrail и domain), уровни принудительного исполнения и правила оформления SKILL.md.

Когда применять

  • Создание нового навыка с нуля: генерация файла SKILL.md с правильным frontmatter и добавление записи в файл конфигурации skill-rules.json.
  • Отладка проблем с активацией навыков: проверка того, почему триггеры (ключевые слова, паттерны намерений) не срабатывают или вызывают ложные срабатывания.
  • Настройка уровней принудительного исполнения (enforcement): определение, когда навык должен блокировать действия (BLOCK), предлагать рекомендации (SUGGEST) или выдавать предупреждения (WARN).
  • Конфигурация условий пропуска (skip conditions): настройка отслеживания сессий, маркеров файлов или переменных окружения для управления поведением хуков.

Как работает

  1. Создайте файл SKILL.md в директории .claude/skills/{skill-name}/, добавив frontmatter с именем и описанием, содержащим ключевые слова для активации, и убедитесь, что объем текста не превышает 500 строк.
  2. Добавьте запись о новом навыке в конфигурационный файл .claude/skills/skill-rules.json, указав тип (domain или guardrail), уровень исполнения и триггеры (keywords, intentPatterns).
  3. Протестируйте срабатывание хука UserPromptSubmit с помощью команды npx tsx .claude/hooks/skill-activation-prompt.ts, передавая тестовые промпты.
  4. При необходимости протестируйте блокировку хука PreToolUse с помощью команды npx tsx .claude/hooks/skill-verification-guard.ts для проверки работы guardrail-навыков.
  5. Отрегулируйте паттерны триггеров и файловых путей на основе результатов тестирования, чтобы минимизировать ложные срабатывания и убедиться в корректной работе.
  6. При необходимости создайте файлы справки (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 и совместимые) подхватывает его по описанию и следует шагам.