Writing Skills: скилл Superpowers для создания и проверки своих скиллов

obra/superpowers· Проверено 13.11.2026· 317 тыс.на GitHub

Скилл Superpowers о том, как писать скиллы по TDD: прогнать сценарий на субагенте без скилла, записать его ошибки, написать скилл под них и проверить снова.

Как установить Writing Skills

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /writing-skills.

# плагином, внутри Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# или вручную
git clone --depth 1 https://github.com/obra/superpowers.git /tmp/writing-skills
mkdir -p ~/.claude/skills/writing-skills
cp -r /tmp/writing-skills/skills/writing-skills/. ~/.claude/skills/writing-skills/

Что умеет

Прогнать сценарии давления на субагенте без скилла и записать его отговорки дословно
Написать минимальный SKILL.md под найденные ошибки и проверить, что агент теперь соблюдает правила
Закрыть новые лазейки таблицей отговорок и красными флагами
Написать description в формате «Use when…» без пересказа порядка работы
Проверить формулировку микротестами: 5 и больше прогонов и контрольный прогон без инструкции

Цикл RED-GREEN-REFACTOR перенесён на документацию: тест — сценарий с субагентом, код — SKILL.md, падение — нарушение правила без скилла.

Форму инструкции выбирают по типу ошибки: для нарушения правил под давлением — запрет и таблица отговорок, для неверной формы ответа — описание того, каким должен быть результат.

Справочники в references/: discovery.md (frontmatter, описание, названия), bulletproofing.md, testing-skills-with-subagents.md, flowcharts.md и anthropic-best-practices.md с практиками Anthropic.

Скрипт render-graphs.js на Node.js рисует блок-схемы скилла в SVG.

Что нужноСубагенты или доступ к API модели для прогонов сценариев; Node.js — только для render-graphs.js
АгентыСтавится вместе с набором Superpowers в Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode, Qwen Code и другие агенты.

Что попросить агента

Напиши скилл, чтобы агент всегда <прогонял линтер перед коммитом>Сначала прогонит сценарии без скилла, запишет, как агент нарушает правило, и только потом напишет SKILL.md
Поправь description у моего скилла <имя>Перепишет описание в формате «Use when…» с условиями и симптомами, без пересказа шагов
Агент обходит правило из моего скиллаСоберёт его отговорки, добавит на каждую явный ответ и красные флаги и проверит снова

Ограничения

!

Правило «нет скилла без падающего теста» действует и для правок существующих скиллов

!

Создавать несколько скиллов пачкой без проверки каждого скилл запрещает

!

Рассчитан на знание скилла test-driven-development из того же набора

Описание из SKILL.md

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Частые вопросы

Как установить writing-skills skill в Claude Code?
Поставьте набор Superpowers: /plugin install superpowers@claude-plugins-official или через маркетплейс автора obra/superpowers-marketplace. Скилл writing-skills включится сам, когда задача подойдёт.
Как проверить, что скилл работает?
Прогнать тот же сценарий на субагенте со скиллом и без него. Для правил-дисциплины — сценарии с несколькими видами давления: сроки, потраченное время, усталость.
Где хранить свои скиллы?
В папке скиллов вашего агента: в Claude Code это ~/.claude/skills/. Codex, Copilot CLI и Gemini CLI также читают ~/.agents/skills/.
Что писать в description?
Только когда применять скилл: условия и симптомы, начиная с «Use when…». Пересказ шагов туда не пишут: прочитав его, агент следует пересказу и не открывает сам скилл.
Когда скилл писать не стоит?
Для разовых решений, общеизвестных практик, правил конкретного проекта (им место в файле инструкций) и механических ограничений, которые проверяются регулярным выражением или валидацией.
Зачем тестировать скилл?
Если вы не видели, как агент ошибается без скилла, вы не знаете, учит ли скилл нужному. Развернуть непроверенный скилл, по словам авторов, то же, что развернуть непроверенный код.

Похожие скиллы