superpowers와 mattpocock/skills를 모두 사용해보고 알게 된 철학의 차이와 선택 방법

서론

Claude Code의 유명한 스킬 집합으로서 superpowers와 mattpocock/skills가 있다. 두 가지를 실제로 설치하여 사용해 보며 깨달은 점은, "어느 쪽이 더 뛰어난가"가 아니라 "애초에 해결하려는 문제가 다르다"는 것이었다.

도구 개요

superpowers는 obra가 공개한 Claude Code용 스킬 세트 모음(obra/superpowers)이다. SessionStart 후크(hook)를 통한 자동 주입과 병렬 서브 에이전트(parallel sub-agent) 실행을 특징으로 한다. 에이전트에게 규율을 강제하는 것을 중심 사상으로 삼고 있다.

mattpocock/skills는 TypeScript 전문가인 Matt Pocock이 만든 스킬 집합이다. DDD(도메인 주도 설계)・TDD(테스트 주도 개발)・아키텍처 등의 엔지니어링 기초를 스킬로 구현하였으며, 필요할 때만 수동으로 호출하도록 설계되어 있다.

철학의 차이

superpowers는 "에이전트에게 규율을 강제하는 장치"이며, mattpocock/skills는 "엔지니어링의 기초를 스킬로 구현한 것"이다.

관점	superpowers	mattpocock/skills
기동 방식	SessionStart hook이 매번 주입, 1% 규칙으로 강제 체크	수동 호출 (필요할 때만)
...	...	...

기동 방식이 상징적인 차이다. superpowers는 세션 시작 시 using-superpowers를 자동 주입하며, 이후의 모든 대화에서 스킬 적용 체크가 실행된다. mattpocock/skills는 후크를 가지지 않는다. /grill-with-docs나 /tdd를 필요할 때만 직접 호출한다.

결과물의 취급도 대조적이다. superpowers는 "계획서 → 실행 → 종료"의 매번 소비되는 모델로, 세션을 넘나드는 자산은 생성되지 않는다. mattpocock/skills는 CONTEXT.md・ADR(아키텍처 결정 기록)・GitHub Issues에 지식을 쌓아 나간다.

전체 스킬 비교표

superpowers와 mattpocock/skills 모두 조사 시점에서 각각 14개의 스킬을 보유하고 있다. TDD 스킬(test-driven-development와 tdd)은 양쪽 모두에 존재하지만, 그 외의 커버 영역은 거의 겹치지 않는다 (mattpocock/skills는 현재도 새로운 스킬이 지속적으로 추가되는 중이다).

superpowers (14개 스킬)

카테고리	스킬	개요
Testing	test-driven-development	RED-GREEN-REFACTOR를 강제
Debugging	systematic-debugging	4단계 근본 원인 프로세스
Debugging	verification-before-completion	수정 후 확인을 강제
Collaboration	brainstorming	소크라테스(Socratic) 방식으로 설계를 정밀 검토
Collaboration	writing-plans	파일 경로・완전한 코드・검증 단계가 포함된 작업 분해
Collaboration	executing-plans	배치 실행 + 인간 체크포인트
Collaboration	dispatching-parallel-agents	병렬 서브 에이전트 기동
Collaboration	requesting-code-review	리뷰 전 체크리스트
Collaboration	receiving-code-review	피드백 대응 프로세스
Collaboration	using-git-worktrees	독립 브랜치 병렬 개발
Collaboration	finishing-a-development-branch	merge/PR 판단 플로우
Collaboration	subagent-driven-development	작업마다 새로운 서브 에이전트 + 2단계 리뷰
Meta	writing-skills	스킬 작성 가이드
Meta	using-superpowers	시스템 도입 설명

mattpocock/skills (14개 스킬)

카테고리	스킬	개요
Engineering	diagnose
reproduce → minimise → hypothesise → fix 루프
Engineering	grill-with-docs
설계 검증 + CONTEXT.md + ADR 업데이트
Engineering	triage
Issue 상태 머신 (needs-triage → ready-for-agent / ready-for-human)
Engineering	improve-codebase-architecture
CONTEXT.md에 기반한 정기적 구조 개선
Engineering	setup-matt-pocock-skills
Issue 트래커 등의 초기 설정
Engineering	tdd
RED-GREEN-REFACTOR + 수직 슬라이스 (vertical slice) 단위
Engineering	to-issues
계획을 HITL/AFK로 분류된 수직 슬라이스 Issue로 변환
Engineering	to-prd
대화로부터 PRD를 합성하여 GitHub Issue 작성
Engineering	zoom-out
코드 전체상 파악 및 설명
Engineering	prototype
일회성 프로토타입 작성
Productivity	caveman
약 75% 토큰 절감 모드
Productivity	grill-me
비코드(non-code) 용도의 요구사항 인터뷰
Productivity	handoff
대화를 컴팩트한 인수인계 문서로 변환
Productivity	write-a-skill
스킬 작성 가이드

superpowers의 스킬은 "실행을 어떻게 관리할 것인가"에 집중하고 있다. 병렬 에이전트(parallel agents), git worktree, 서브 에이전트의 리뷰 루프(review loop) 등 모든 것이 "어떻게 움직일 것인가"에 대한 이야기다.

mattpocock/skills의 스킬은 "무엇을 만들지 정확히 결정하고, 이를 축적해 나가는 것"에 집중하고 있다. to-prd로 요구사항을 작성하고, to-issues로 수직 슬라이스(vertical slice)로 분해하며, triage로 실행 가능한 Issue를 정비한다.

CONTEXT.md라는 "축적되는 자산"

mattpocock/skills의 독창성은 CONTEXT.md에 있다. 프로젝트 고유의 도메인 어휘를 축적하는 파일로, 한 번 만들어두면 복리 효과를 낸다.

grill-with-docs로 설계 리뷰를 반복하는 동안, 프로젝트 고유의 어휘가 CONTEXT.md에 축적된다. 변수명, 함수명, 파일명이 일관되게 유지되며, 에이전트에 대한 지시 사항이 짧아진다.

karpathy-guidelines와의 궁합

Andrej Karpathy(전 OpenAI·Tesla의 저명한 AI 엔지니어)의 LLM 코딩에 관한 관찰을 바탕으로 만들어진 AGENTS.md 가이드라인인 "karpathy-guidelines" (multica-ai/andrej-karpathy-skills)는 AI 개발 커뮤니티에서 널리 참조되고 있다. Karpathy 본인이 공개한 리포지토리가 아니라, 그의 X 게시물로부터 파생된 것이다. 스킬은 단 하나뿐이지만, 총 22만 개 이상의 스타(star)를 기록하고 있으며, 그 본문은 많은 프로젝트의 AGENTS.md 코딩 규칙 섹션에 거의 동일한 텍스트로 전재 및 인용되고 있다. AGENTS.md를 작성하고 있는 사람은 이미 이 가이드라인의 영향 아래에 있는 경우가 많다.

이 가이드라인을 AGENTS.md에 채택하고 있다면, superpowers보다 mattpocock/skills가 더 궁합이 좋다.

mattpocock/skills와의 궁합: ◎

karpathy-guidelines의 각 규칙에 mattpocock/skills가 직접 대응한다.

karpathy-guidelines 규칙	mattpocock의 대응 스킬
Think Before Coding	grill-with-docs (코딩 전 한 문제씩 깊게 파고들기)
Simplicity First	composable 설계 (1개 스킬이 독립적이며, 호출하지 않으면 비용 0)
Surgical Changes	SessionStart 훅(hook) 없음 (필요할 때만 호출)
Goal-Driven Execution	tdd (tracer bullet) + diagnose (feedback loop 선행)
For trivial tasks, use judgment	호출하지 않으면 아무 일도 일어나지 않음

「For trivial tasks, use judgment.」라는 마지막 문장은 「판단을 개발자에게 맡긴다」는 의사 표시이다. mattpocock/skills는 훅(hook)을 갖지 않는 설계로 이를 체현하고 있다.

superpowers와의 상성: ✗ (직접적으로 모순됨)

superpowers의 using-superpowers

메타 스킬에는 다음과 같은 문장이 있다.

"If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill."

「판단을 맡긴다」 vs 「판단을 빼앗는다」의 직접적인 모순이다. 단순한 방향성의 차이가 아니라, 동일한 행동에 대해 정반대의 지시가 공존하게 된다.

superpowers의 토큰 소비 이미지

superpowers는 토큰 소비가 심하다는 이미지가 정착되어 있다. 구버전(v4.0.3 이전)에서는 세션마다 대량의 스킬을 사전에 로드했던 것이 그 배경에 있다.

현재 v5.1.0에서는 모든 스킬의 사전 로드가 폐지되었으며, Skill tool 호출 시에만 지연 로드(lazy load)된다. 상시 오버헤드는 using-superpowers SKILL.md의 약 1,350토큰뿐이다.

다만 「행동 오버헤드(action overhead)」는 남는다. <EXTREMELY_IMPORTANT> 태그로 「1%라도 가능성이 있다면 Skill invocation을 필수」로 강제하기 때문에, 단순한 질문에도 매번 스킬 체크 루프가 돌아간다. 이는 토큰 양의 문제가 아니라, 체감되는 「마찰(friction)」로 나타난다.

어느 것을 선택할 것인가

기능 커버리지의 대부분은 겹치지 않지만, 실용적인 공존은 어렵다. 이유는 기능의 중복이 아니라 철학의 충돌이다. superpowers의 1% 규칙 ("1%라도 가능성이 있다면 반드시 스킬을 호출하라")은 mattpocock 스킬에도 오작동(mis-fire)을 일으키며, 또한 양쪽 모두에 존재하는 TDD 스킬에서 RED-GREEN-REFACTOR의 구현 방침이 충돌한다. 둘 중 하나를 선택해야 한다.

GitHub Issues 기반으로 개발하고 있다 → mattpocock/skills. to-prd → to-issues → triage의 연계가 직접적으로 효과적임

AGENTS.md에 karpathy-guidelines가 포함되어 있다 → mattpocock/skills. 철학이 일치하여 마찰이 없음

병렬 서브 에이전트(sub-agent)를 사용한 대규모 실행 관리가 필요하다 → superpowers의 실행 계열 스킬에 가치가 있음

에이전트가 자기 판단으로 멋대로 나아가는 것을 방지하고 싶다 → superpowers. Iron Laws가 「확인 없이 진행하지 않음」, 「검증을 건너뛰지 않음」을 구조적으로 강제함

Discussion