이 글은 Claude Opus 5 를 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.


에이전트 스킬(Agent Skills)이 자리를 잡으면서, 어떤 스킬을 깔아 두느냐가 코딩 에이전트의 성격을 결정하게 되었습니다. 지금 가장 많이 쓰이는 두 묶음이 obra/superpowers 와 mattpocock/skills 입니다.

이 블로그에서는 Superpowers 플러그인 가이드 4부작으로 superpowers 를 이미 다뤘습니다. 이 시리즈는 그 후속 이며, 이번에는 정반대 설계를 가진 묶음을 옆에 놓습니다.

방법은 두 가지입니다. 두 저장소의 원본 SKILL.md 를 전부 읽었고, 두 플러그인을 실제로 설치해 상시 토큰 비용과 훅 구조를 쟀습니다. 소개 글이나 요약이 아니라, 실제로 에이전트에게 주입되는 텍스트와 실제로 지불되는 비용이 기준입니다.

먼저 정정합니다#

이 글은 같은 날 발행했던 단일 비교글 “superpowers 와 grill-me” 를 대체합니다. 그 글에는 범주 오류 가 있었습니다. 스킬 14개짜리 프레임워크와 스킬 한 개를 나란히 놓고, 첫 절에서 “사실 이 둘은 같은 급이 아닙니다” 라고 해명하며 시작했습니다.

비교 글을 열자마자 비교 대상이 아니라고 써야 한다면 프레임이 잘못 잡힌 것입니다. 올바른 짝은 둘 중 하나입니다.

  • 스킬 대 스킬: brainstorming vs grill-me
  • 묶음 대 묶음: superpowers vs mattpocock/skills

이 시리즈는 후자를 택했습니다. 그리고 프레임을 바꾸자마자 이전 글의 핵심 수치가 뒤집혔습니다. 3절이 그 이야기입니다.


1. 두 묶음의 정체#

obra/superpowersmattpocock/skills
저자Jesse Vincent (obra)Matt Pocock
라이선스MITMIT
스타277,636236,911
최초 커밋2025-10-092026-02-03
플러그인 버전4.0.31.2.3
등록 스킬17개 (별칭 3개 포함)25개
에이전트1 (code-reviewer)0
훅1 (SessionStart)0
자기 정의“complete software development methodology”“Skills for Real Engineers”

스타 수는 2026-08-26 에 GitHub API 로 조회한 값입니다. 감이 안 잡히는 숫자라 같은 시점에 다른 저장소도 조회했는데, facebook/react 가 247,903, microsoft/vscode 가 189,607, anthropics/claude-code 가 143,023 이었습니다. 에이전트 스킬 저장소 두 개가 리액트와 VS Code 사이에 들어가 있습니다.

마지막 줄의 자기 정의가 이 시리즈 전체의 예고편입니다. 한쪽은 방법론 이라 부르고, 다른 쪽은 도구 모음 이라 부릅니다.


2. 왜 “프레임워크 대 스킬 하나” 가 틀렸나#

grill-me 는 mattpocock 묶음에서 가장 유명한 스킬이라 자주 대표로 불립니다. 그런데 그 묶음은 스킬 한 개짜리가 아닙니다. 25개이고, 개발 흐름을 처음부터 끝까지 덮습니다.

증거는 저장소 안에 있습니다. ask-matt 이라는 스킬이 있는데, 하는 일이 “어떤 스킬을 써야 하는지 알려 주는 라우터” 입니다. 그 문서가 전체 흐름을 이렇게 적어 놓았습니다.

The main flow: idea → ship The route most work travels. You have an idea and want it built.

그리고 그 아래에 /grill-with-docs → (필요하면 /prototype 우회) → /to-spec → /to-tickets → /implement → /tdd → /code-review 라는 경로가 단계별로 적혀 있습니다. 여기에 /triage, /diagnosing-bugs, /wayfinder 세 개의 진입 램프(on-ramp) 가 본류에 합류합니다.

즉 양쪽 다 완결된 워크플로를 가지고 있습니다. 차이는 그 워크플로를 어디에 적어 두었느냐 입니다. superpowers 는 에이전트에게 주입하고, mattpocock 은 사용자가 물어보는 문서에 적어 둡니다. 이 차이 하나가 두 묶음의 거의 모든 것을 설명하며, Part 2의 주제입니다.


3. 총량은 같고 배치가 반대입니다#

이 시리즈에서 가장 놀란 수치입니다. 두 묶음의 실제 분량을 wc 로 셌습니다.

superpowers 4.0.3mattpocock/skills 1.2.3
SKILL.md 합계2,949줄 (92,922바이트)1,599줄 (116,048바이트)
보조 문서0줄1,346줄 (73,773바이트)
총합2,949줄2,945줄

4줄 차이입니다. 이전 글에서 “84배 차이” 라고 썼던 것은 프레임워크 전체와 스킬 한 개를 비교한 결과였고, 제대로 짝을 맞추자 거의 같은 분량 이 되었습니다.

차이는 크기가 아니라 배치 였습니다.

flowchart TD
    subgraph MP["mattpocock/skills — 많은 수의 작은 파일"]
        direction TB
        M1["SKILL.md 25개<br/>평균 64줄"]
        M2["implement 15줄<br/>research 12줄<br/>wait-what 7줄"]
        M3["보조 md 1,346줄<br/>필요할 때만 읽음"]
        M1 --> M2
        M1 --> M3
    end
    subgraph SP["superpowers — 적은 수의 큰 파일"]
        direction TB
        S1["SKILL.md 14개<br/>평균 211줄"]
        S2["test-driven-development<br/>371줄"]
        S3["writing-skills<br/>655줄"]
        S4["보조 문서 0개<br/>모든 내용이 SKILL.md 안에"]
        S1 --> S2
        S1 --> S3
        S1 --> S4
    end
    style S1 fill:#87CEEB,color:#000000
    style S3 fill:#FF9999,color:#000000
    style M1 fill:#FFD700,color:#000000
    style M3 fill:#90EE90,color:#000000

superpowers 스킬 하나의 평균이 211줄, mattpocock 은 64줄입니다. 3.3배 차이입니다.

그리고 mattpocock 쪽은 내용의 46%(1,346줄)를 SKILL.md 바깥의 보조 문서 에 두었습니다. tdd 스킬이 좋은 예입니다. 본체는 38줄이고, 예제는 tests.md, 모킹 지침은 mocking.md 로 분리되어 있습니다. 스킬 본문은 짧게 유지하고 깊은 내용은 필요할 때만 읽게 하는 구조입니다.

superpowers 는 반대입니다. 보조 문서가 0개이고 test-driven-development 한 파일에 371줄이 들어 있습니다.

두 저장소의 자기 서술과 정확히 일치합니다.

These skills are designed to be small, easy to adapt, and composable. — mattpocock/skills README

Superpowers is a complete software development methodology. — obra/superpowers README


4. 단계별 대응표#

25개와 17개를 개발 흐름에 늘어놓고 맞춰 봤습니다.

단계superpowersmattpocock/skills
진입점using-superpowers — 훅으로 강제 주입ask-matt — 사용자가 묻는 라우터
아이디어 정리brainstorminggrill-me · grilling · grill-with-docs
큰 작업 지도—wayfinder
도메인 언어—domain-modeling · codebase-design
사전 검증—prototype · research
계획·명세writing-plansto-spec · to-tickets
작업공간 격리using-git-worktrees—
구현subagent-driven-development · executing-plansimplement
TDDtest-driven-developmenttdd
코드 리뷰requesting-code-review · receiving-code-review + code-reviewer 에이전트code-review
디버깅systematic-debuggingdiagnosing-bugs
완료 검증verification-before-completion—
병합·마무리finishing-a-development-branchresolving-merge-conflicts
이슈 관리—triage
세션 인계—handoff
병렬 처리dispatching-parallel-agents—
메타 (스킬 작성)writing-skillswriting-for-agents
대화 교정—wait-what

중간이 거의 채워집니다. 아이디어 정리부터 코드 리뷰까지, 두 묶음은 같은 문제들을 같은 순서로 다룹니다.


5. 양쪽이 비워 둔 자리#

대응표의 빈칸이 이 시리즈에서 가장 흥미로운 부분입니다. 없는 것이 있는 것보다 많은 것을 말합니다.

superpowers 에 없는 것#

prototype — 말로 답할 수 없는 질문을 코드로 답하는 단계입니다. mattpocock 쪽은 이걸 흐름의 정식 분기로 둡니다. grill-me 저자는 “어떤 질문은 대화로 답할 수 없다(ungrillable). 그때는 캐묻기를 멈추고 버릴 프로토타입을 만들어 보고 오라” 고 명시합니다.

superpowers 는 brainstorming 에서 설계를 확정하고 곧장 writing-plans 로 갑니다. “생각만으로는 못 정하는 것이 있다” 를 흐름에 넣지 않았습니다.

wayfinder — 한 세션에 담기지 않는 규모를 다루는 스킬입니다. superpowers 는 큰 작업도 brainstorming → writing-plans 한 줄로 처리합니다.

triage · handoff — 내가 만들지 않은 이슈를 처리하는 것, 그리고 대화를 다른 세션에 넘기는 것. 둘 다 혼자 처음부터 끝까지 만드는 시나리오에는 필요 없는 것들 입니다.

mattpocock 에 없는 것#

verification-before-completion — “증거 없이 완료를 주장하지 말라” 는 규율입니다. superpowers 는 이걸 139줄짜리 독립 스킬로 둡니다.

using-git-worktrees — 구현 전에 격리된 작업 공간을 만드는 단계입니다. mattpocock 의 implement 는 그냥 “현재 브랜치에 커밋하라” 로 끝납니다.

dispatching-parallel-agents — 서브에이전트 병렬 실행. superpowers 는 subagent-driven-development 240줄로 자율 실행을 밀어붙이는데, mattpocock 의 implement 는 15줄 입니다.

빈칸이 그리는 그림#

정리하면 이렇습니다.

  • superpowers 가 채운 자리 는 에이전트를 자율적으로 오래 돌리기 위한 안전장치 입니다. 격리·검증·병렬 실행.
  • mattpocock 이 채운 자리 는 사람이 판단을 붙잡고 있기 위한 도구 입니다. 프로토타입·지도·라우터·인계.

한쪽은 에이전트를 믿고 오래 맡기려 하고, 다른 쪽은 사람이 계속 개입할 수 있게 만들려 합니다. 이 시리즈가 확인하려는 가설이 이것입니다.


6. 시리즈 구성#

Part내용
1이 글. 지형도 — 정체·규모·단계별 대응표·양쪽의 빈칸
2발동 — 훅 한 개가 만드는 차이. using-superpowers vs ask-matt, 상시 토큰 비용, 설치 실측
3계획 단계 — brainstorming vs grilling 계열, 그리고 prototype 의 부재
4구현·검증 단계 — TDD 에서 두 저장소가 정면으로 충돌하는 지점
5철학과 선택 — 저자들의 반박, 의식 비용, 언제 무엇을 쓸 것인가

References#

1차 자료

측정값

  • 스타 수와 저장소 지표는 2026-08-26T04:02Z 에 GitHub API 로 조회 한 값이며 실시간으로 변합니다.
  • 대조군: freeCodeCamp/freeCodeCamp 454,613 · facebook/react 247,903 · microsoft/vscode 189,607 · anthropics/claude-code 143,023.
  • 줄 수·바이트는 wc 실측입니다. mattpocock 쪽 합계는 플러그인에 등록된 25개 만 셌습니다. 저장소에는 in-progress·misc 등 등록되지 않은 스킬이 더 있습니다.
  • 스킬 개수·에이전트·훅은 claude plugin details 출력이며 버전이 오르면 달라집니다.

이 블로그의 관련 글

밝혀 둘 것

  • 이 시리즈는 설계와 설치 비용 비교 입니다. 두 묶음을 실제 프로젝트에 적용해 여러 세션을 돌린 장기 사용기가 아닙니다.
  • 이 글은 같은 날 발행했던 단일 비교글을 대체하며, 그 URL 은 이 글로 연결됩니다.