skill-authoring-workflow — скилл для Claude Code: как писать скиллы
Проводит скилл от черновых заметок до готового SKILL.md, который проходит проверки репозитория. Пригодится, если пишете или обновляете скиллы в Product-Manager-Skills.
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-codeЧто делает skill-authoring-workflow
Скилл задаёт порядок работы в шесть фаз. Сначала поиск пересекающихся скиллов через scripts/find-a-skill.sh, потом выбор типа: компонент, интерактивный или workflow. Дальше генерация черновика — scripts/add-a-skill.sh для готового исходника или scripts/build-a-skill.sh, если текста ещё нет.
Проверки жёсткие. scripts/test-a-skill.sh --skill <skill-name> --smoke, затем python3 scripts/check-skill-metadata.py skills/<skill-name>/SKILL.md и python3 scripts/check-skill-triggers.py. Метаданные ограничены: name до 64 символов, description до 200. Описание должно отвечать и на «что делает», и на «когда применять». В разделе Input нужен пример вызова и прямое указание агенту использовать то, что дали в запросе, вместо повторных вопросов.
Для нового скилла придётся обновить таблицы README и счётчики категорий, иначе каталог разъедется. Упаковка для загрузки в Claude — через scripts/zip-a-skill.sh, там же пресеты вроде core-pm. Ведите диалог по протоколу workshop-facilitation, но при расхождении приоритет у логики самого workflow.
Какие задачи решает
- превратить заметки с воркшопа в готовый скилл
- обновить существующий скилл, не сломав стандарты репозитория
- прогнать метаданные и триггеры перед коммитом
- выбрать между компонентом, интерактивным скиллом и workflow
- собрать zip-пакет скилла для загрузки
Примеры запросов агенту
- Используй skill-authoring-workflow: сделай из
research/pricing-workshop-notes.mdинтерактивный скилл-советник. - Прогони skill-authoring-workflow и проверь метаданные нового скилла перед коммитом.
- Через skill-authoring-workflow обнови существующий скилл и поправь счётчики в README.
Как установить skill-authoring-workflow
1Через Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-authoring-workflow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-authoring-workflow/
1Через Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a codex2Вручную: положить файлы
.agents/skills/skill-authoring-workflow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a cursor2Вручную: положить файлы
.cursor/skills/skill-authoring-workflow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install deanpeters/Product-Manager-Skills skill-authoring-workflow2Вручную: положить файлы
.github/skills/skill-authoring-workflow/SKILL.md1Через Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a gemini-cli2Командой платформы
gemini skills install https://github.com/deanpeters/Product-Manager-Skills --path skills/skill-authoring-workflowВручную: положить файлы
.devin/skills/skill-authoring-workflow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора69
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о skill-authoring-workflow
Как установить skill-authoring-workflow в Claude Code?
Выполните npx skills add deanpeters/Product-Manager-Skills --skill skill-authoring-workflow -a claude-code. Файл скилла окажется в ~/.claude/skills/skill-authoring-workflow/SKILL.md.
Что делает skill-authoring-workflow?
Ведёт создание или обновление скилла по фазам: поиск дублей, генерация черновика, ручная доводка, строгая валидация и правка документации репозитория.
Что нужно для работы скилла?
Скрипты репозитория: find-a-skill.sh, add-a-skill.sh, build-a-skill.sh, test-a-skill.sh, check-skill-metadata.py. Проверка метаданных запускается через python3.
