핵심 요약
- Superpowers는 15개의 조합 가능한 스킬(브레인스토밍, 계획, 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 → 계획 작성 → 서브에이전트 또는 인라인 실행 + TDD → 리뷰 → 브랜치 마무리입니다. 에이전트는 모든 작업 전에 관련 스킬이 있는지 먼저 확인합니다.
저장소 상태는 2026-11-11에 확인했습니다. GitHub 스타 315,938개, 최신 릴리스 v7.0.2(2026-11-03), 최신 커밋 22f0b463. 스타 수는 매일 바뀌므로 스냅숏으로 읽어 주세요. 이 페이지의 설치 명령, 스킬 이름, 버전 번호는 위 출처에서 그대로 옮긴 것이며 의역하지 않았습니다.
Superpowers란 무엇인가
Superpowers는 MIT 라이선스의 오픈소스 플러그인(작성 시점 v7.0.2)으로, Claude Code에 또 하나의 도구가 아니라 소프트웨어 개발 방법론을 넣습니다. 모델도, API 프록시도, 포크도 아닙니다. 15개 스킬과, 에이전트가 그 스킬을 찾아 따르도록 만드는 부트스트랩의 조합입니다.
스킬은 SKILL.md가 들어 있는 폴더입니다. name과 description이 있는 YAML 프런트매터와 그 아래 markdown 지시로 이루어집니다. description이 트리거이며 Claude Code가 이를 읽고 적용 여부를 판단합니다. Superpowers는 세션 시작 훅으로 using-superpowers 부트스트랩을 주입하므로, 코드를 쓴 뒤가 아니라 답하기 전에 스킬을 찾습니다.
Prime Radiant의 Jesse Vincent(obra)가 만들었고 2025-10-09에 공개되었습니다. Anthropic이 Claude Code 플러그인 시스템을 내놓은 바로 그날입니다. 같은 저장소가 Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode 등에도 설치됩니다. 하나의 스킬 라이브러리를 여러 하네스에서 쓰는 셈입니다.
- 버전
- v7.0.2 · 2026-11-03
- 최신 커밋
- 22f0b463
- 라이선스
- MIT
Claude Code에 Superpowers 설치하기
공식적으로 지원되는 두 가지 경로이며, 둘 다 저장소 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를 종료하고 다시 실행해야 세션 시작 훅이 부트스트랩을 주입합니다.
- 3전체 워크플로에는 git 저장소가 필요합니다. worktree 단계에서 별도 브랜치를 만들고, 마무리 단계에서 병합·PR·폐기 중 선택하게 됩니다.
다른 하네스도 같은 저장소에서
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의 동작을 실제로 바꾸는 부분입니다. README의 Basic Workflow에 있는 7단계에, 어떤 작업 전이든 관련 스킬을 먼저 확인한다는 규칙이 더해집니다.
- 1
brainstorming
무엇이든 만들기 전에 정말 원하는 것과 그 이유를 질문으로 끌어내고, 이해한 내용을 다시 말해 교정받습니다. 작은 변경보다 큰 일은 설계 문서로 남습니다.
- 2
using-git-worktrees
설계가 승인되면 새 브랜치에 격리된 작업 공간을 만들고, 프로젝트 설정을 실행하고, 테스트 기준선이 깨끗한지 확인한 뒤에 코드를 건드립니다.
- 3
writing-plans
승인된 설계를 2~5분짜리 작은 작업으로 쪼개고, 각 작업에 정확한 파일 경로와 완전한 코드, 검증 절차를 붙입니다.
- 4
subagent-driven-development 또는 executing-plans
실행 방식은 두 가지입니다. 작업마다 새 서브에이전트를 붙이고 매번 리뷰하거나(가장 철저), 현재 세션에서 인라인으로 구현하고 마지막에 브랜치 전체를 한 번 리뷰합니다(가장 저렴).
- 5
test-driven-development
구현 중에는 RED-GREEN-REFACTOR를 지킵니다. 실패하는 테스트를 쓰고, 실패하는 걸 보고, 최소한의 코드를 쓰고, 통과하는 걸 보고, 커밋합니다. 테스트보다 먼저 쓴 코드는 삭제됩니다.
- 6
requesting-code-review
작업 사이사이 계획과 대조해 리뷰하고, 문제는 심각도별로 보고합니다. Critical은 진행을 막습니다.
- 7
finishing-a-development-branch
마지막에 테스트를 검증하고, 병합·PR·유지·폐기 선택지를 제시한 뒤 선택을 실행하고 worktree를 정리합니다.
v7.0.2의 15개 스킬 전체
폴더 이름은 에이전트가 대조에 쓰는 식별자라 번역하지 않았습니다. 각 설명은 커밋 22f0b463 시점 해당 스킬의 프런트매터를 요약한 것입니다.
테스트
test-driven-development
먼저 테스트를 쓰고 실패를 확인한 뒤, 통과할 만큼만 코드를 씁니다. 테스트 안티패턴 참고 자료가 함께 들어 있습니다.
디버깅
systematic-debugging
버그, 실패한 테스트, 예상 밖 동작에 대해 수정을 제안하기 전에 4단계 근본 원인 절차를 밟습니다. 증상만 고치는 것은 실패로 봅니다.
verification-before-completion
작업이 끝났다·고쳤다·통과했다고 말하기 전에 검증 명령을 실행하고 출력을 읽습니다.
diagnosing-superpowers
세션이 이상하게 흘러갔을 때 기록을 읽고 줄 단위 근거로 무슨 일이 있었는지 보고하며, 필요하면 정제한 번들을 버그 리포트용으로 묶습니다.
협업
brainstorming
창작 작업 전에 반드시 사용. 질문으로 의도를 끌어내고, 만들기 전에 이해를 다시 말해 확인받습니다.
writing-plans
스펙을 코드베이스를 본 적 없는 엔지니어도 실행할 수 있는 계획으로 바꿉니다. 작업마다 정확한 파일, 이름, 시그니처, 테스트를 명시합니다.
executing-plans
인라인 실행. 현재 세션에서 작업을 하나씩 구현하고 마지막에 브랜치 전체를 새 컨텍스트로 한 번 리뷰합니다.
subagent-driven-development
작업마다 새 구현 서브에이전트를 붙이고 매번 스펙과 품질을 리뷰하며, 마지막에 브랜치 전체를 폭넓게 리뷰합니다.
dispatching-parallel-agents
공유 상태도 순서 의존도 없는 독립 작업이 둘 이상일 때, 순차 처리 대신 각각에 맞춘 컨텍스트를 구성해 병렬로 위임합니다.
requesting-code-review
정확히 구성한 컨텍스트를 가진 리뷰 서브에이전트를 보내, 문제를 마지막이 아니라 작업 사이에 드러냅니다.
receiving-code-review
리뷰 피드백 처리법: 구현 전에 검증하고, 가정하지 말고 물어보며, 겉치레 동의는 하지 않습니다.
using-git-worktrees
격리된 작업 공간을 확보합니다. 플랫폼 기본 worktree 도구를 우선하고, 없을 때만 수동 git worktree로 내려갑니다.
finishing-a-development-branch
테스트를 검증하고 환경을 판별해 병합·PR·유지·폐기를 제시하고, 선택을 실행한 뒤 정리합니다.
메타
writing-skills
프로세스 문서에 TDD를 적용해 스킬을 만들고 고칩니다. 스킬이 실제로 발동하는지 시험하는 방법도 포함합니다.
using-superpowers
부트스트랩 스킬. 스킬을 찾는 법, 불러오는 법, 왜 어떤 응답보다 먼저 호출해야 하는지를 다룹니다.
Superpowers와 기본 Claude Code 비교
기본 Claude Code에도 플랜 모드, 네이티브 스킬, 서브에이전트, worktree, 플러그인이 있습니다. Superpowers는 새 부품을 더하는 게 아니라 "언제 그것을 쓸지"에 대한 주장과, 그 주장을 건너뛰기 어렵게 만드는 훅을 더합니다.
| 항목 | 기본 Claude Code | Superpowers 설치 후 |
|---|---|---|
| 워크플로의 출처 | 세션마다 직접 고릅니다. 플랜 모드, CLAUDE.md 관례, 또는 붙여 넣는 프롬프트. | 세션 시작 훅이 필수 스킬 부트스트랩을 주입해 그 순서가 기본값이 됩니다. |
| 계획 | 플랜 모드가 계획을 만들고 승인하면 같은 컨텍스트에서 구현이 시작됩니다. | brainstorming → 설계 문서 → writing-plans를 거쳐 계획이 파일 경로와 테스트를 갖춘 2~5분 작업이 됩니다. |
| 격리와 실행 | worktree와 서브에이전트가 있지만 언제 쓸지는 직접 정합니다. | 설계 후 using-git-worktrees가 자동으로 돌고, subagent-driven-development와 executing-plans 중 하나를 고르게 됩니다. |
| 품질 관문 | 테스트와 리뷰를 직접 요청하거나 훅과 CI를 스스로 붙입니다. | TDD, verification-before-completion, requesting-code-review가 작업 사이에 발동하고, 리뷰의 Critical은 진행을 막습니다. |
효과가 있는 지점
- 기본값이 "먼저 코드 쓰기"에서 "먼저 묻기"로 바뀝니다. 실용적으로 가장 큰 차이이며 작성자의 공개 글 중심이기도 합니다.
- 스킬이 작고 읽기 쉽습니다. 모든 동작이 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에 참 값을 넣으면 꺼집니다. Claude Code의 DISABLE_TELEMETRY와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC도 존중됩니다.