에이전트는 기본적으로 가장 짧은 길로 간다. 스펙·테스트·보안 검토를 건너뛰는 그 길을, 시니어 엔지니어의 절차와 품질 게이트로 막아 주는 스킬 팩이다.
개요
Agent Skills는 Addy Osmani(저장소 Creator, 공유된 소개글은 “구글 크롬 개발팀에서 활동한” 인물로 소개)가 만든 “AI 코딩 에이전트용 프로덕션급 엔지니어링 스킬” 모음이다. 2026-10-31 수집 시점 지표는 스타 112,091개, 포크 11,729개, MIT, 생성 2026-02-15, 최신 릴리스 0.6.15다. 공유된 소개글의 “스타 약 11.2만”과 일치한다.
처음 정리한 2026-04-07에는 스킬 20개·명령 7개였고, 지금은 스킬 25개(수명주기 24개 + 메타 스킬 1개), 슬래시 명령 9개, 에이전트 페르소나 4개, 참조 체크리스트 7개로 늘었다. 늘어난 것은 요구사항 인터뷰(interview-me), 품질 기준 문서화(constraint-driven-development), 공식 문서 근거(source-driven-development), 적대적 재검토(doubt-driven-development), 관측성(observability-and-instrumentation) 스킬과 /constraints·/webperf 명령이다.
Claude Code, Codex, Cursor, Gemini CLI, Copilot 등 많은 에이전트에서 쓸 수 있다. 스킬이 순수 마크다운이라 시스템 프롬프트나 지침 파일을 받는 에이전트면 어디서나 동작한다.
슬래시 명령 (9개)
| 하는 일 | 명령 | 원칙 |
|---|---|---|
| 무엇을 만들지 정의 | /spec | 코드 전에 스펙 |
| 어떻게 만들지 계획 | /plan | 작고 원자적인 작업 |
| 점진적 구현 | /build | 한 번에 한 슬라이스 |
| 동작 증명 | /test | 테스트가 증거 |
| 품질 기준 설정 | /constraints | 한 번 정하고 어디서나 강제 |
| 머지 전 리뷰 | /review | 코드 건강 개선 |
| 웹 성능 감사 | /webperf | 최적화 전에 측정 |
| 코드 단순화 | /code-simplify | 영리함보다 명확함 |
| 프로덕션 배포 | /ship | 빠를수록 안전 |
Claude Code에서는 플러그인 명령으로 설치된다. /review처럼 기본 명령과 이름이 겹치면 /agent-skills:review로 부른다. 스킬은 작업 맥락에 따라 자동 활성화되기도 한다(API 설계 시 api-and-interface-design, UI 구현 시 frontend-ui-engineering 등). Copilot에서는 /spec 같은 수명주기 명령이 나타나지 않아 스킬 이름으로 직접 부른다.
/build auto — 계획 한 번 승인, 이후 자율 실행
/build는 다음 대기 작업 하나만 구현하고 멈춘다. /build auto(또는 all)는 계획이 없으면 만들고, 한 번 승인받은 뒤 모든 작업을 작업 사이 정지 없이 구현한다.
- 빨라지는 게 아니다. 작업당 속도는 같고, 작업 사이에 사람이 끼어드는 단계만 없어진다. 검증은 그대로여서 작업마다 테스트를 먼저 쓰고(RED → GREEN) 회귀·빌드를 확인한 뒤 작업당 커밋 하나를 남긴다. 어느 지점으로든 깨끗이 되돌릴 수 있다.
- 시작 조건이 엄격하다.
SPEC.md·docs/SPEC.md·spec/중 하나가 있어야 하고(README는 스펙이 아니다, 없으면/spec먼저), 작업 트리가 깨끗해야 한다. 작업별 커밋에 관련 없는 변경이 섞이면 되돌리기 보장이 깨지기 때문이다. - 승인은 분명해야 한다. “approve/go/yes”만 승인이고 “괜찮아 보이네요” 같은 애매한 답은 승인이 아니다. 이것이 유일한 사람 관문이다.
- 멈추는 경우. 테스트·빌드가 명확한 수정 없이 실패할 때, 스펙이 모호하거나 결정이 필요할 때, 인증·권한·파괴적 데이터 이전·결제·삭제·배포·비밀값처럼
git revert로 못 되돌리는 고위험 작업일 때다. 해결 뒤/build auto를 다시 부르면 다음 대기 작업부터 이어 간다.
25개 스킬
각 스킬은 단계, 검증 게이트, 합리화 반박 표를 갖춘 구조화된 워크플로다.
Meta — 어떤 스킬을 쓸지 결정
| 스킬 | 내용 |
|---|---|
| using-agent-skills | 들어온 작업을 알맞은 스킬 워크플로로 연결하고 공통 운영 규칙을 정의 |
Define — 무엇을 만들지 명확히
| 스킬 | 내용 |
|---|---|
| interview-me | 한 번에 한 질문씩, 신뢰도 약 95%까지 사용자가 진짜 원하는 것을 끌어내는 인터뷰 |
| idea-refine | 발산·수렴 사고로 모호한 아이디어를 구체적 제안으로 |
| spec-driven-development | 코드 전에 목표·명령·구조·코드 스타일·테스트·경계를 담은 PRD 작성 |
| constraint-driven-development | 품질 기준을 인터뷰해 CONSTRAINTS.md를 쓰고, 검사를 비용별로 배치하며, 에이전트가 검사를 끄거나 테스트를 건너뛰어 초록불을 만드는 행동을 잡는다 |
Plan — 쪼개기
| 스킬 | 내용 |
|---|---|
| planning-and-task-breakdown | 스펙을 수용 기준·의존 순서가 있는 작고 검증 가능한 작업으로 분해 |
Build — 구현
| 스킬 | 내용 |
|---|---|
| incremental-implementation | 얇은 수직 슬라이스(구현·테스트·검증·커밋), 피처 플래그, 롤백 친화 |
| test-driven-development | Red-Green-Refactor, 테스트 피라미드(80/15/5), DAMP > DRY, Beyonce Rule |
| context-engineering | 올바른 정보를 올바른 시점에 — 규칙 파일, 컨텍스트 패킹, MCP |
| source-driven-development | 프레임워크 결정을 공식 문서에 근거해 검증·인용하고 미검증 부분을 표시 |
| doubt-driven-development | 중대한 결정마다 새 컨텍스트에서 적대적으로 재검토(CLAIM → EXTRACT → DOUBT → RECONCILE → STOP), 사용자가 허락하면 다른 모델로 확대 |
| frontend-ui-engineering | 컴포넌트 구조, 디자인 시스템, 상태 관리, 반응형, WCAG 2.1 AA |
| api-and-interface-design | Contract-first, Hyrum’s Law, One-Version Rule, 에러 시맨틱, 경계 검증 |
Verify — 증명
| 스킬 | 내용 |
|---|---|
| browser-testing-with-devtools | Chrome DevTools MCP로 DOM·콘솔·네트워크·성능 런타임 데이터 확인 |
| debugging-and-error-recovery | 재현 → 지역화 → 축소 → 수정 → 가드 5단계, stop-the-line 규칙 |
Review — 머지 전 품질 게이트
| 스킬 | 내용 |
|---|---|
| code-review-and-quality | 5축 리뷰, 변경 크기(~100줄), 심각도 라벨(Nit/Optional/FYI) |
| code-simplification | Chesterton’s Fence, Rule of 500, 동작은 그대로 복잡도만 감소 |
| security-and-hardening | OWASP Top 10, 인증 패턴, 시크릿 관리, 의존성 감사, 3티어 경계 |
| performance-optimization | 측정 우선, Core Web Vitals, 번들 분석, 안티패턴 탐지 |
Ship — 배포
| 스킬 | 내용 |
|---|---|
| git-workflow-and-versioning | 트렁크 기반 개발, 원자적 커밋, 커밋을 저장 지점으로 쓰는 패턴 |
| ci-cd-and-automation | Shift Left, Faster is Safer, 피처 플래그, 품질 게이트 파이프라인 |
| deprecation-and-migration | 코드는 부채라는 관점, 의무/권고 deprecation, 좀비 코드 제거 |
| documentation-and-adrs | ADR, API 문서, 인라인 문서 — “왜”를 기록 |
| observability-and-instrumentation | 구조화 로그, RED 지표, OpenTelemetry 트레이싱, 증상 기반 알림 |
| shipping-and-launch | 출시 전 체크리스트, 피처 플래그 수명주기, 단계적 롤아웃, 롤백, 모니터링 |
페르소나와 체크리스트
- 페르소나 4개:
code-reviewer(5축 리뷰),test-engineer(테스트 전략, Prove-It 패턴),security-auditor(위협 모델링, OWASP),web-performance-auditor(Core Web Vitals 감사,/webperf로 실행). 저장소 비교 문서에 따르면/ship이 이들을 병렬로 돌려 go/no-go로 합친다. 한 페르소나가 다른 페르소나를 부르지 않는다는 규칙이 있다. - 참조 체크리스트 7개: Definition of Done, 테스트 패턴, 보안, 성능, 접근성, 관측성, 오케스트레이션 패턴. 스킬이 필요할 때만 불러온다.
설치
# 가장 빠른 길 — 어느 에이전트든 (skills CLI, 70개 이상 에이전트)
npx skills add addyosmani/agent-skills # 25개 전부
npx skills add addyosmani/agent-skills --list # 설치 전 둘러보기
npx skills add addyosmani/agent-skills --skill code-review-and-quality
# Claude Code (마켓플레이스)
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
# Codex (CLI v0.122+)
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
# Gemini CLI
gemini skills install https://github.com/addyosmani/agent-skills.git --path skillsCursor·Windsurf·OpenCode·Copilot·Kiro·Antigravity·Command Code는 각자 전용 설정 문서가 있다. 이미 코드베이스가 있다면 처음부터 전체 수명주기를 쓰기보다 검증 중심으로 점진 도입하라고 안내한다(Adoption Guide).
구조적 특징
- 절차 중심: 설명문보다 단계·체크포인트·종료 기준이 중심이다.
- 합리화 반박(anti-rationalization): “테스트는 나중에” 같은 에이전트의 흔한 핑계를 반박하는 표와 Red Flags가 모든 스킬에 있다.
- 검증 필수: “맞아 보인다”가 아니라 테스트·빌드·런타임 결과 같은 증거를 요구한다.
- 점진적 공개(progressive disclosure):
SKILL.md가 진입점이고 보조 자료는 필요할 때만 로드해 토큰 사용을 줄인다. - 저장소 안 3단계 eval: 구조 검사, 스킬 설명문의 라우팅 충돌 검사(CI에서 결정론적으로 실행), 실제 에이전트 실행 트레이스 채점. 저장소 자신의 서술이다.
한계와 쓰기 전에 알 것
- 개별 스킬만 설치하면 공유 체크리스트가 빠진다.
npx skills add --skill ...은skills/<name>/만 복사해 저장소 수준references/가 없다. 스킬은 동작하지만 보조 체크리스트 경로가 끊긴다(이슈 361로 추적 중). 전체 저장소 설치가 안전하다. - Claude Code 마켓플레이스 설치는 SSH로 클론한다. SSH 키가 없으면
Permission denied (publickey)가 나므로 HTTPS URL로 추가하거나 git 설정으로 SSH URL을 HTTPS로 바꿔야 한다. - 도구별 지원 격차. Copilot에는 수명주기 슬래시 명령이 안 나타나고, Antigravity CLI의 일부 릴리스에서는 명령 래퍼가 발견되지 않아 스킬을 직접 불러야 한다.
/build auto는 스펙과 깨끗한 작업 트리를 전제한다. 스펙 없이 “알아서 만들어 줘”가 되는 모드가 아니다.- 효과 검증은 저자 측 자료다. 비교 문서(Superpowers·Matt Pocock 스킬 대비)와 eval 설명은 저장소 자신의 서술이고, 이 노트는 직접 설치해 돌려 보지 않았다. 스킬 본문과 eval은 읽지 않았다.
- 스타 수는 인기 지표일 뿐 품질 보증이 아니다.
공유된 소개글과 README 대조
공유된 소개글의 “25개 스킬과 9개 명령어”, “MIT 라이선스”, “/build auto는 계획을 한 번 승인하면 작업별 코딩·테스트를 이어 가고 문제가 생기면 멈춘다”는 모두 README·build.md와 일치한다. “구글 크롬 개발팀에서 활동”은 README에 없는 소개이고 이 노트는 확인하지 못했다(2026-04 노트에는 같은 서술이 있었다). 소개글의 “Cursor 등에서 사용”도 맞다. 다만 Cursor는 플러그인이 아니라 skills/를 .cursor/skills/로 동기화하는 방식이고(저장소에 .cursor/ 폴더는 없다), npx skills add로도 설치할 수 있다.
관련 노트
- 2026-05-21-superpowers — 저장소 비교 문서가 맞세우는 자율·서브에이전트 중심 방법론 스킬 팩
- 2026-03-21-superpowers-openspec-workflow — Superpowers와 OpenSpec을 엮은 워크플로
- 2026-04-22-claude-code-skills-gap — 스킬 도입의 격차
- 2026-03-29-memento-skills — 에이전트가 에이전트를 설계하는 스킬 프레임워크
- 2026-10-31-github-bam-bam-2-solo-skills — 같은 날 정리한 다른 스킬 모음(1인 사업가 업무 자동화)
- Claude Code 활용 전반은 moc-claude-code를 본다.
출처
- GitHub: https://github.com/addyosmani/agent-skills
- 저자: Addy Osmani