Как написать свой skill для Claude Code?

Skill — это специализированный навык Claude Code, оформленный как SKILL.md. Хороший skill должен набрать минимум 85% по формуле качества.

Формула качества

Score = 70
  + 10 (если >= 2 конкретных примера ввода/вывода)
  +  5 (если есть framework/структура)
  +  5 (если self-contained — без внешних зависимостей)
  +  5 (если есть чёткий workflow)
  +  5 (бонус за секцию "Приоритет при конфликтах")
= итого (макс 100)

Что должен содержать SKILL.md

• Frontmatter — name и description (description «пушит» использование)
• Минимум 2 примера — конкретный ввод и конкретный вывод
• Секция workflow — пошаговый процесс, НЕ абстрактные рекомендации
• Приоритет при конфликтах — как вести себя при противоречиях
• Нет внешних зависимостей — скилл работает без MCP-серверов и коннекторов

Что снижает качество

• Зависимость от внешних источников (CONNECTORS.md, MCP серверы)
• Отсутствие примеров вывода — модель не понимает ожидаемый формат
• Абстрактные инструкции вместо конкретных шагов
• Размер > 500 строк (используй references/ для деталей)

После создания автоматически запускается Quality Gate: структурный чеклист, sub-agent ревью (code-reviewer + architect + security-reviewer) и тест-прогон.