writing-skills · pedronauck — скилл для Claude Code: создание и отладка скиллов

Что делает writing-skills

Скилл даёт агенту процедуру работы с самими скиллами: как выбрать область действия, что оставить в SKILL.md, а что вынести в справочники. Автор — Pedro Nauck, репозиторий pedronauck/skills. Подход опирается на доктрину из writing-great-skills (mattpocock/skills).

Внутри есть пошаговый разбор создания и правки: определить результат, владеющие файлы и известный сбой, собрать минимальный контракт в SKILL.md, а ветки уводить в ссылки с условием. Отдельная ветка посвящена диагностике загрузки: если нужный справочник не подхватился, скилл различает плохой триггер, недоступный путь, конфликтующее правило, устаревшее содержимое и ошибку модели. Для нового пакета предлагается прочитать references/authoring-procedure.md, а assets/SKILL.template.md — необязательный каркас.

Есть скрипт проверки метаданных: python3 <writing-skills-dir>/scripts/validate-metadata.py --name "[name]" --description "[description]". Он только читает данные. Для правки пары абзацев достаточно статического просмотра, а вот заявлять об улучшении поведения без сравнительных прогонов на одних и тех же задачах не стоит — скилл прямо это оговаривает. Заодно он не берётся за AGENTS.md и CLAUDE.md: для них есть отдельный writing-agents-md, а обычные README и документация вне области. Установка идёт через npx skills add или gh skill install в зависимости от платформы.