AI 코딩 에이전트가 코드부터 쓰지 않게 만드는 스킬, Superpowers

AI 코딩 에이전트는 요청을 받으면 대개 바로 코드부터 칩니다. Superpowers는 그 순서를 바꿉니다. 무엇을 만들지 먼저 묻고, 계획을 세우고, 실패하는 테스트를 먼저 쓰고, 리뷰까지 마친 뒤에 코드를 남깁니다. 에이전트가 혼자 판단하기 어려운 부분을 절차로 묶어 둔 스킬 모음입니다.

GitHub 별 31만5,382개(2026년 11월 10일 기준). 2025년 10월 공개된 저장소가 1년 남짓 만에 코딩 에이전트용 스킬 가운데 최상위권에 올랐습니다. MIT 라이선스라 사내 프로젝트에 그대로 가져다 쓸 수 있습니다.

한 문장으로 줄이면 이렇습니다. "프롬프트를 길게 쓰는 대신, 상황마다 꺼내 쓰는 15개의 개발 절차서를 에이전트 책상에 꽂아 두는 것"입니다.

---

Superpowers가 바꾸는 것은 코드가 아니라 순서입니다

보통 코딩 에이전트는 이런 흐름으로 움직입니다. 요청을 받는다, 코드를 쓴다, 끝. 빠르지만 설계가 빠져 있고, 테스트는 나중에 붙이고, 리뷰는 사람 몫으로 남습니다.

Superpowers는 여기에 강제 절차를 넣습니다. 저장소 설명에 쓰인 표현 그대로, 이 스킬들은 제안이 아니라 필수 워크플로입니다. 에이전트는 작업을 시작하기 전에 관련 스킬이 있는지 먼저 확인하고, 있으면 그 절차를 따릅니다.

재미있는 건 이 절차가 사람이 읽기 좋은 문서로 되어 있다는 점입니다. 코드가 아니라 SKILL.md라는 마크다운 파일이고, 에이전트는 그 문서를 읽고 행동을 바꿉니다. 그래서 같은 저장소를 Claude Code, Codex, Cursor, Hermes Agent 어디에 붙여도 비슷하게 동작합니다.

안에는 무엇이 들어 있나: 15개 스킬, 네 묶음

저장소를 직접 클론해 세어 봤습니다. SKILL.md는 15개, 전체 파일은 236개입니다. 성격별로 묶으면 아래와 같습니다.

묶음	스킬	하는 일
테스트 (1)	test-driven-development	실패하는 테스트를 먼저 쓰고, 통과하는 최소 코드만 남깁니다. 테스트보다 먼저 쓴 코드는 삭제합니다.
디버깅 (3)	systematic-debugging verification-before-completion diagnosing-superpowers	원인 추적, 수정 확인, 세션 진단을 각각 맡습니다. "고친 것 같습니다"로 끝내지 않게 만드는 장치입니다.
협업 (9)	brainstorming writing-plans executing-plans subagent-driven-development dispatching-parallel-agents requesting-code-review receiving-code-review using-git-worktrees finishing-a-development-branch	설계, 계획, 구현, 리뷰, 브랜치 마무리까지 개발 한 사이클을 담당합니다. 이 저장소의 본체입니다.
메타 (2)	writing-skills using-superpowers	새 스킬을 만드는 법과, 세션 시작 시 전체 스킬을 깨우는 부트스트랩입니다.

에이전트가 실제로 밟는 일곱 단계

README의 기본 워크플로를 네 덩어리로 줄이면 아래와 같습니다. 각 단계는 앞 단계의 산출물이 있어야 다음으로 넘어갑니다.

1. 브레인스토밍 — 만들기 전에 무엇을 원하는지, 왜 원하는지 캐묻습니다. 작은 변경은 대화로 합의하고, 프로젝트는 설계 문서로 남깁니다.
2. 작업 공간 분리 — 새 브랜치와 워크트리를 만들고, 기존 테스트가 통과하는 상태인지 먼저 확인합니다.
3. 계획 작성 — 작업을 2~5분 단위로 쪼갭니다. 각 작업에는 파일 경로, 코드, 검증 방법이 붙습니다.
4. 구현 — 작업마다 새 서브에이전트를 붙이는 방식과, 한 세션에서 순차 실행하는 방식 중 하나를 고릅니다.
5. TDD — 구현 중에는 실패하는 테스트를 먼저 씁니다. 테스트 없이 쓴 코드는 지웁니다.
6. 리뷰 — 작업 사이사이 계획과 어긋난 부분을 심각도별로 정리합니다. 치명적인 문제는 진행을 막습니다.
7. 마무리 — 테스트를 확인하고 머지, PR, 보류, 폐기 중 하나를 결정한 뒤 워크트리를 정리합니다.

평소 비용은 작고, 열 때만 커집니다

스킬이 15개나 되면 컨텍스트를 다 잡아먹지 않을까 걱정하게 됩니다. 실제 크기를 재보면 그렇지 않습니다. 15개 SKILL.md의 설명 줄을 전부 합치면 2,319자, 약 580토큰입니다. 반면 본문을 전부 합치면 14만2,567자, 약 3만5,642토큰입니다.

즉 평소에는 580토큰짜리 목록만 보고, 실제로 필요한 스킬 하나를 고를 때만 본문을 엽니다. 이 구조를 점진적 공개(progressive disclosure)라고 부릅니다. 스킬을 많이 깔아도 비용이 선형으로 늘지 않는 이유입니다.

숫자는 영어 기준으로 글자 수를 4로 나눈 추정치입니다. 한글 문서라면 토큰이 더 많이 들 수 있습니다. 그래도 "목록은 가볍고 본문은 무겁다"는 비율은 그대로입니다.

설치는 하네스마다 다르고, 한 저장소로 끝납니다

같은 스킬 묶음을 여러 코딩 도구에 붙일 수 있습니다. 대표적인 네 가지입니다.

# Claude Code (공식 플러그인 마켓)
/plugin install superpowers@claude-plugins-official

# Codex CLI
/plugins
# → superpowers 검색 → Install Plugin

# Hermes Agent
hermes plugins install obra/superpowers --enable

# Antigravity
agy plugin install https://github.com/obra/superpowers

주의할 점이 하나 있습니다. Hermes Agent에는 압축(compaction) 이후 실행되는 훅이 없어서, 세션이 길어져 컨텍스트가 압축되면 부트스트랩이 사라질 수 있습니다. README도 이 경우 새 세션을 시작하라고 안내합니다.

비슷한 스킬과 비교하면

같은 시기에 주목받은 저장소들과 나란히 놓았습니다. 별 수는 2026년 11월 10일, 스킬 수는 저장소를 직접 세었습니다.

저장소	별	SKILL.md	라이선스	성격
obra/superpowers	315,382	15	MIT	개발 방법론 전체를 강제하는 프레임워크
mattpocock/skills	320,284	39	MIT	실무 개발자를 위한 스킬 모음. 프로젝트에 복사해 쓰는 방식
affaan-m/ECC	300,463	1,068	MIT	하네스 성능 최적화. 스킬·기억·보안을 함께 다룸
anthropics/skills	191,739	20	라이선스 파일 없음	공식 예제 성격. 문서·PDF·엑셀·프론트엔드 스킬 포함

숫자만 보면 네 저장소가 비슷해 보이지만 결이 다릅니다. Superpowers는 절차를, mattpocock/skills는 도구 상자를, ECC는 하네스 튜닝을, anthropics/skills는 공식 레퍼런스를 내세웁니다. 하나를 고르기보다, 팀에 필요한 결을 고르는 문제에 가깝습니다.

직접 써보면 걸리는 지점

문서가 친절하다고 해서 무조건 편한 도구는 아닙니다. 저장소를 뜯어보며 눈에 걸린 부분입니다.

• 강제성이 양날의 검입니다. "제안이 아니라 필수"라고 명시돼 있어서, 작은 오타 수정에도 절차를 요구할 수 있습니다. 가벼운 작업에는 오히려 무겁습니다.
• 서브에이전트 모드는 토큰을 더 씁니다. 작업마다 새 에이전트를 띄우고 리뷰까지 붙이니, 한 세션에서 처리하는 방식보다 비쌉니다. README도 "가장 철저한 대신 가장 비싼 방식"으로 설명합니다.
• 문서가 많습니다. SKILL.md 15개 본문이 14만 자를 넘습니다. 에이전트가 읽는 양이니 사람이 다 읽을 필요는 없지만, 동작을 이해하려면 구조를 익혀야 합니다.
• 하네스별 지원 차이가 있습니다. Claude Code, Codex, Hermes, Antigravity, Cursor 등 설치법이 따로 있고, 훅이나 플러그인 시스템이 다른 만큼 동작도 조금씩 다릅니다.

이런 사람에게 맞습니다

혼자 쓰는 단발성 코드 생성에는 과할 수 있습니다. 대신 팀의 개발 절차를 에이전트에게도 똑같이 적용하고 싶은 사람, 테스트를 먼저 쓰는 습관을 강제하고 싶은 사람, 리뷰 없이 넘어가는 일을 줄이고 싶은 사람에게는 출발점이 됩니다.

다음 글에서는 Superpowers의 개별 스킬 하나를 골라, 실제로 어떤 프롬프트와 파일 구조로 동작하는지 더 깊게 뜯어보겠습니다.

---

자료: github.com/obra/superpowers (README, LICENSE, 2026-11-10 조회) · 공개 당시 소개 글 · mattpocock/skills · anthropics/skills · affaan-m/ECC. 별 수와 스킬 수는 같은 날 저장소에서 직접 확인했습니다. 토큰 추정치는 글자 수를 4로 나눈 값입니다.