Agent Skills: 스펙부터 출시까지 여섯 단계로 묶은 스킬 26개
같은 모델·같은 저장소로 비교한 실험에서 446개 테스트를 끝까지 돌려 숨은 문제를 찾아낸 스킬 묶음
- 누가
- Addy Osmani가 만들고 Federico Bartoli, Joan León이 함께 관리해요. AI 코딩 에이전트에게 실제 서비스 코드를 맡기는 사람을 위한 것이에요.
- 언제
- 2026년 2월 15일에 공개됐고, 최신 릴리스는 2026년 11월 18일의 0.6.17이에요.
- 어디서
- Claude Code, Codex, Cursor, Gemini CLI, Antigravity CLI, GitHub Copilot, OpenCode 등에서 쓰고, 스킬은 내 저장소에 Markdown으로 설치돼요.
이게 불편했어요
에이전트에게 기능을 맡기면 스펙 없이 코드부터 쓰고, 테스트는 나중에 하겠다고 하고, 돌려 보지도 않은 채 다 됐다고 해요. 그래서 일을 시킬 때마다 스펙 먼저, 테스트 먼저, 리뷰 먼저라는 말을 똑같이 다시 적어야 했어요.
그래서 이렇게 풀어요
Agent Skills는 그 잔소리를 정의·계획·구현·검증·리뷰·출시 여섯 단계의 스킬로 적어 두고, 단계마다 슬래시 명령을 붙였어요. 이 모음만의 장치는 스킬마다 들어 있는 핑계 표예요. 에이전트가 단계를 건너뛸 때 흔히 대는 말과 그 반박이 미리 적혀 있고, 스킬의 끝은 테스트 통과나 빌드 출력 같은 증거를 요구해요. 스킬이 제때 불리는지 재는 평가도 저장소 안에 함께 들어 있어요.

이걸로 만든 사람들

같은 모델, 같은 저장소, 같은 프롬프트로 Superpowers와 Agent Skills를 나란히 돌려 기능 하나를 만들었어요. Agent Skills 쪽은 첫 코드 변경이 4분 빨랐고, 검증을 7회 하면서 마지막에 446개 테스트 전체를 돌렸어요.
The result was a 4-minute faster first code change (8 vs 12 minutes) without affecting total execution time.
이 모음의 스킬 세 개에 평가 묶음을 만들어, 모델이 바뀐 뒤에도 스킬이 약속한 대로 듣는지 쟀어요. code-review-and-quality는 그대로였고, 나머지 둘에서는 나빠진 사례가 나왔다고 표와 함께 올렸어요.
For our first report I wrote eval suites for three skills from this repo (code-review-and-quality, git-workflow-and-versioning, documentation-and-adrs)
안에서는 이렇게 돌아가요
- 1
- 2
Claude Code → SPEC.md
SPEC.md 저장목표, 명령, 프로젝트 구조, 코드 스타일, 테스트 전략, 경계 여섯 영역을 적어 저장소 루트에 둬요.skills/spec-driven-development/SKILL.md - 3
SPEC.md → tasks/plan.md
/plan → tasks/plan.md스펙을 완료 조건과 의존 순서가 붙은 작은 작업으로 쪼개요.skills/planning-and-task-breakdown/SKILL.md - 4
tasks/plan.md → Claude Code
/build: RED → GREEN → 커밋다음 작업 하나를 골라 실패하는 테스트, 최소 구현, 전체 테스트, 빌드, 커밋 순서로 끝내고 멈춰요..claude/commands/build.md - 5
Claude Code → code-reviewer 외 페르소나 2개
/ship: 페르소나 3개 동시 실행code-reviewer, security-auditor, test-engineer가 각자 컨텍스트에서 같은 변경을 따로 봐요..claude/commands/ship.md - 6
code-reviewer 외 페르소나 2개 → Ship Decision: GO | NO-GO
보고서 3개 → GO | NO-GO메인 에이전트가 보고서를 합쳐 막는 문제, 권장 수정, 롤백 계획이 든 결정문 하나를 내요..claude/commands/ship.md
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 에이전트에게 실제 서비스에 들어갈 기능을 맡기는데, 단계마다 사람이 확인하고 싶을 때
- 스펙과 테스트 없이 코드부터 나오는 것이 불안할 때
- 출시 전에 코드 리뷰, 보안 감사, 테스트 점검을 한 번에 돌리고 싶을 때
- 여러 에이전트 도구를 쓰는 팀이 같은 작업 순서를 맞추고 싶을 때
이건 안 돼요
- 스킬 하나만 npx로 설치하면 저장소의 references/ 체크리스트는 따라오지 않아요(README, 이슈 #361).
- /spec부터 /ship까지의 슬래시 명령은 Claude Code 명령이라, GitHub Copilot에서는 스킬 이름으로 불러야 해요.
- /build auto는 작업 사이에 사람이 끼어드는 일만 줄여요. 작업 하나가 빨라지지는 않아요.
- 직접 돌려 본 것이 아니라 README와 저장소의 명령·스킬 파일을 읽고 정리했어요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요