Superpowers для Claude Code: установка, скиллы и воркфлоу
Что плагин Superpowers добавляет Claude Code, точные команды установки из репозитория, все 15 скиллов в v7.0.2 и чем его воркфлоу отличается от обычного Claude Code.
Коротко
- Superpowers — открытый плагин из 15 composable-скиллов (брейншторм, планы, TDD, отладка, worktree, код-ревью), которые Claude Code подхватывает автоматически после установки.
- Из официального маркетплейса: /plugin install superpowers@claude-plugins-official. Либо сначала добавить obra/superpowers-marketplace и поставить superpowers@superpowers-marketplace.
- В авторском анонсе минимумом назван Claude Code 2.0.13 или около того; манифест плагина в репозитории — v7.0.2, релиз 2026-11-03.
- Порядок: брейншторм → worktree → письменный план → исполнение сабагентами или inline с TDD → ревью → завершение ветки. Перед каждой задачей агент проверяет, есть ли подходящий скилл.
Состояние репозитория проверено 2026-11-11: 315,938 звёзд на GitHub, последний релиз v7.0.2 от 2026-11-03, последний коммит 22f0b463. Число звёзд меняется ежедневно — читайте его как снимок. Команды установки, названия скиллов и номера версий на этой странице скопированы из источников, а не пересказаны.
Что такое Superpowers на самом деле
Superpowers — открытый плагин под лицензией MIT (на момент написания v7.0.2), который даёт Claude Code не очередной набор инструментов, а методологию разработки. Это не модель, не прокси к API и не форк: это библиотека из 15 скиллов плюс бутстрап, который заставляет агента искать и соблюдать их.
Скилл — это папка с файлом SKILL.md: YAML-фронтматтер с name и description, ниже markdown-инструкции. Description и есть триггер — Claude Code читает его и решает, применим ли скилл. Superpowers добавляет хук на старте сессии, который внедряет бутстрап using-superpowers, поэтому агент ищет скилл до ответа, а не после того, как уже написал код.
Автор — Jesse Vincent (obra) из Prime Radiant, публикация 2025-10-09, в тот же день, когда Anthropic выпустил систему плагинов Claude Code. Тот же репозиторий ставится в Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode и другие: одна библиотека скиллов, много харнессов.
- Версия
- v7.0.2 · 2026-11-03
- Последний коммит
- 22f0b463
- Лицензия
- MIT
Установка Superpowers в Claude Code
Два поддерживаемых пути, оба скопированы из README репозитория. Выполняйте их внутри сессии Claude Code — это слэш-команды, а не команды оболочки.
Путь 1 — официальный маркетплейс (одна строка)
Маркетплейс Anthropic claude-plugins-official добавляется автоматически при первом запуске интерактивной сессии Claude Code, поэтому нужна только строка установки. В README также есть ссылка на страницу claude.com/plugins/superpowers.
/plugin install superpowers@claude-plugins-officialПуть 2 — маркетплейс Superpowers
Если нужен авторский маркетплейс — там же лежат связанные плагины вроде superpowers-chrome и elements-of-style. Первая строка регистрирует маркетплейс, вторая ставит плагин по имени.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceЧто нужно до первого запуска
- 1Claude Code 2.0.13 или новее — минимум, который называет авторский анонс для работы через плагин.
- 2Перезапуск после установки: выйдите и снова запустите claude, чтобы хук старта сессии внедрил бутстрап.
- 3Git-репозиторий для полного воркфлоу: шаг worktree создаёт отдельную ветку, а финал предлагает merge, pull request или отказ от работы.
Другие харнессы, тот же репозиторий
В README для каждого кодового агента указана одна строка установки. Ниже — точные копии; перед запуском перечитайте README, команды меняются от релиза к релизу.
| Харнесс | Команда установки |
|---|---|
| Codex CLI | /plugins |
| Cursor | /add-plugin superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Qwen Code | qwen extensions install obra/superpowers |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers |
| Grok Build | grok plugin install superpowers@xai-official --trust |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes | hermes plugins install obra/superpowers --enable |
Воркфлоу, который он навязывает
Именно эта часть меняет поведение Claude Code. Семь шагов из раздела Basic Workflow в README плюс правило: перед любой задачей агент проверяет, есть ли подходящий скилл.
- 1
brainstorming
До начала работы агент выясняет вопросами, что вам на самом деле нужно и зачем, пересказывает своё понимание для правок и пишет дизайн-документ для всего крупнее мелкой правки.
- 2
using-git-worktrees
После утверждения дизайна создаётся изолированное рабочее пространство в новой ветке, запускается настройка проекта и проверяется чистый тестовый baseline — только потом правки кода.
- 3
writing-plans
Утверждённый дизайн превращается в задачи по 2–5 минут, каждая с точными путями файлов, полным кодом и шагами проверки.
- 4
subagent-driven-development или executing-plans
Два режима: свежий сабагент на каждую задачу с ревью после каждой (самый тщательный) или inline-исполнение в текущей сессии с одним ревью всей ветки в конце (самый дешёвый).
- 5
test-driven-development
Во время реализации действует RED-GREEN-REFACTOR: написать падающий тест, увидеть падение, написать минимум кода, увидеть прохождение, закоммитить. Код, написанный до теста, удаляется.
- 6
requesting-code-review
Между задачами работа сверяется с планом, проблемы докладываются по серьёзности — критичные блокируют продвижение.
- 7
finishing-a-development-branch
В конце проверяются тесты, предлагаются merge, pull request, сохранение или отказ, выбранный вариант выполняется, worktree очищается.
Все 15 скиллов в v7.0.2
Имена папок — это идентификаторы, по которым сопоставляет агент, поэтому они не переводятся. Каждое описание пересказывает фронтматтер соответствующего скилла в коммите 22f0b463.
Тестирование
test-driven-development
Сначала тест, увидеть его падение, затем только тот код, который нужен для прохождения, — плюс справочник антипаттернов тестирования.
Отладка
systematic-debugging
Четырёхфазный поиск корневой причины для любого бага, упавшего теста или странного поведения — до предложения фикса. Лечение симптома считается провалом.
verification-before-completion
Перед заявлением «готово, исправлено, проходит» — выполнить команду проверки и прочитать её вывод.
diagnosing-superpowers
Если сессия пошла не так, прочитать её транскрипт и доложить, что произошло, с построчными доказательствами; при желании собрать очищенный бандл для баг-репорта.
Совместная работа
brainstorming
Обязателен перед творческой работой: вытягивает намерение вопросами и пересказывает понимание до начала работы.
writing-plans
Превращает спецификацию в план, который выполнит инженер, никогда не видевший кодовой базы: точные файлы, имена, сигнатуры и тесты в каждой задаче.
executing-plans
Inline-исполнение плана: реализуете задачу за задачей в текущей сессии, в конце — одно ревью всей ветки на свежем контексте.
subagent-driven-development
Свежий сабагент-исполнитель на каждую задачу, ревью спецификации и качества после каждой, широкое ревью всей ветки в конце.
dispatching-parallel-agents
Если задач две и больше, они независимы и не делят состояние — делегировать каждую агенту со своим контекстом, а не делать последовательно.
requesting-code-review
Отправляет сабагента-ревьюера с точно собранным контекстом, чтобы проблемы всплывали между задачами, а не в конце.
receiving-code-review
Как принимать замечания: проверять до реализации, спрашивать вместо предположений, без показного согласия.
using-git-worktrees
Обеспечить изолированное рабочее пространство: сначала родные инструменты worktree платформы, и только при их отсутствии — ручной git worktree.
finishing-a-development-branch
Проверить тесты, определить окружение, предложить merge/PR/сохранить/отказаться, выполнить выбор и всё убрать.
Мета
writing-skills
Создание и правка скиллов через TDD, применённый к процессной документации, включая проверку того, что скилл действительно срабатывает.
using-superpowers
Бутстрап-скилл: как искать скиллы, как их загружать и почему их надо вызывать до любого ответа.
Superpowers против обычного Claude Code
В обычном Claude Code уже есть plan mode, нативные скиллы, сабагенты, worktree и плагины. Superpowers не добавляет новых примитивов — он добавляет мнение о том, когда их применять, и хук, из-за которого это мнение трудно пропустить.
| Тема | Обычный Claude Code | С Superpowers |
|---|---|---|
| Откуда берётся воркфлоу | Вы выбираете каждую сессию: plan mode, соглашение в CLAUDE.md или вставленный промпт. | Хук старта сессии внедряет обязательный бутстрап скиллов, и эта последовательность становится поведением по умолчанию. |
| Планирование | Plan mode выдаёт план, вы его утверждаете, реализация начинается в том же контексте. | brainstorming → дизайн-документ → writing-plans превращают план в задачи по 2–5 минут с путями файлов и тестами. |
| Изоляция и исполнение | Worktree и сабагенты есть, но когда их использовать, решаете вы. | using-git-worktrees срабатывает сам после дизайна; дальше выбор между subagent-driven-development и executing-plans. |
| Контроль качества | Тесты и ревью вы просите сами либо настраиваете хуки и CI. | TDD, verification-before-completion и requesting-code-review срабатывают между задачами; критичные замечания блокируют продвижение. |
Где помогает
- Поведение по умолчанию меняется с «сразу писать код» на «сначала спросить» — главное практическое отличие и основа авторского анонса.
- Скиллы маленькие и читаемые: каждое поведение — markdown-файл, который можно открыть, сравнить в diff и поправить.
- Одна библиотека скиллов на разные харнессы: тот же репозиторий ставится в Claude Code, Codex, Cursor, Gemini CLI и другие.
Чем это стоит
- Больше токенов и ходов: вопросы, дизайн-документ, план и ревью по задачам случаются до первой строки продакшн-кода.
- Намеренно жёсткие взгляды: YAGNI, строгий TDD и обязательный вызов скиллов хороши для нового проекта, но тяжелы для срочной правки в легаси.
- Появляется ещё один объект для обновлений, а полная польза предполагает git-репозиторий и харнесс с сабагентами.
Когда сессия ведёт себя странно
Если скилл срабатывает не там, молчит там, где должен сработать, или агент игнорирует собственный план, в репозитории есть скилл diagnosing-superpowers именно для этого. Попросите в сессии — для прошлой добавьте «in session <id>» — и он прочитает транскрипт, доложит, что произошло, с доказательствами и при желании соберёт очищенный бандл для баг-репорта.
figure out what went wrong with superpowers in session <id>Телеметрия и как её отключить
README прямо пишет: необязательный визуальный компаньон в скилле brainstorming загружает логотип с сайта Prime Radiant, и в запросе есть версия Superpowers, но нет данных о проекте, промпте или агенте. Поставьте SUPERPOWERS_DISABLE_TELEMETRY в любое истинное значение, чтобы отключить; DISABLE_TELEMETRY и CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC от Claude Code тоже учитываются.