애디 오스마니가 공개한 AI 코딩 에이전트용 프로덕션 스킬 10.1만 개 스타
AI 코딩 에이전트가 시니어 엔지니어처럼 일하게 하려면 워크플로와 품질 게이트를 코드로 심어야 합니다. 이 자료는 스펙 작성부터 배포까지 9단계 슬래시 커맨드와 자동 빌드 모드로 그 체계를 바로 적용하는 법을 보여줍니다.
애디 오스마니가 정리한 agent-skills 저장소는 AI 코딩 에이전트가 단순 코드 생성을 넘어 설계·계획·테스트·리뷰·배포까지 엔지니어링 전 과정을 일관되게 수행하게 만드는 스킬셋입니다. 10.1만 개 스타가 증명하듯 현업에서 바로 쓸 수 있는 실전 패키지입니다.
agent-skills가 무엇인가요
애디 오스마니가 공개한 agent-skills는 AI 코딩 에이전트가 현업 엔지니어처럼 일하도록 돕는 프로덕션급 스킬 모음이에요. 2026년 2월에 처음 만들어져 이번 달(2026년 10월)까지 꾸준히 업데이트되고 있으며, 현재 10.1만 개 스타와 10,584개 포크를 기록 중입니다. MIT 라이선스로 공개돼 누구나 자유롭게 쓸 수 있어요.
저장소의 핵심은 개발 라이프사이클에 맞춘 9가지 슬래시 커맨드입니다. 각 커맨드는 "무엇을 만들지 정의"(/spec)부터 "프로덕션에 배포"(/ship)까지 전 과정을 커버하며, 관련 스킬을 자동으로 활성화해 줍니다.
| 단계 | 커맨드 | 핵심 원칙 |
|---|---|---|
| 무엇을 만들지 정의 | /spec | Spec before code |
| 어떻게 만들지 계획 | /plan | Small, atomic tasks |
| 점진적으로 구현 | /build | One slice at a time |
| 작동 증명 | /test | Tests are proof |
| 품질 기준 설정 | /constraints | Decide it once, enforce it everywhere |
| 머지 전 리뷰 | /review | Improve code health |
| 웹 성능 감사 | /webperf | Measure before you optimize |
| 코드 단순화 | /code-simplify | Clarity over cleverness |
| 프로덕션 배포 | /ship | Faster is safer |
특히 `/build auto` 옵션을 쓰면 스펙이 확정된 뒤 계획 수립부터 전체 태스크 구현까지 한 번에 자동 실행됩니다. 사람 개입을 태스크 사이가 아닌 검증 시점으로만 줄여주며, 모든 태스크는 여전히 테스트 주도·개별 커밋으로 진행되고 위험 단계에서는 자동으로 멈춥니다.
- 주 언어: JavaScript
- 태그: agent-skills, antigravity, claude-code, codex, cursor, skills
- 라이선스: MIT
왜 이 스킬셋을 쓰나요
애디 오스마니가 공개한 agent-skills는 시니어 엔지니어가 실제 현장에서 반복하는 워크플로·품질 게이트·베스트 프랙티스를 9가지 슬래시 명령어와 스킬로 포장한 저장소예요. 10.1만 개 스타와 10,584개 포크를 기록하며, 이미 수많은 개발자가 '에이전트에게 시니어 수준의 판단력을 이식하고 싶다'는 니즈로 이 스킬셋을 찾고 있음을 보여줘요.
시니어 엔지니어의 사고 과정을 에이전트에 이식하는 이유
AI 코딩 에이전트는 코드를 '작성'하는 데는 강하지만, '무엇을·어떤 순서로·어떤 기준으로' 만들지 결정하는 엔지니어링 판단은 약한 편이에요. agent-skills는 "/spec → /plan → /build → /test → /review → /ship" 같은 개발 라이프사이클 전 단계를 명령어 하나씩으로 매핑해, 에이전트가 매번 같은 품질 게이트를 통과하도록 강제해요. 결과적으로 '사람마다 다른 코드 스타일', '테스트 누락', '성능 측정 없는 배포' 같은 편차를 원천 차단할 수 있어요.
| 단계 | 명령어 | 시니어 엔지니어의 핵심 원칙 |
|---|---|---|
| 요구사항 정의 | /spec | Spec before code |
| 계획 수립 | /plan | Small, atomic tasks |
| 증분 구현 | /build | One slice at a time |
| 검증 | /test | Tests are proof |
| 품질 기준 | /constraints | Decide once, enforce everywhere |
| 코드 리뷰 | /review | Improve code health |
| 웹 성능 감사 | /webperf | Measure before you optimize |
| 단순화 | /code-simplify | Clarity over cleverness |
| 배포 | /ship | Faster is safer |
특히 `/build auto`는 계획 승인 한 번으로 모든 태스크를 테스트 주도·개별 커밋으로 자율 실행하게 해줘요. 사람 개입을 '태스크 사이 이동'에서 '실패·위험 단계에서만 일시정지'로 줄여, 검증은 유지하면서 속도만 높이는 구조예요. 이처럼 시니어의 '판단 루틴'을 스킬로 캡슐화했기에, 팀에 새 에이전트를 들여도 온보딩 없이 즉시 일관된 품질을 낼 수 있는 게 가장 큰 이점이에요.
- 품질 게이트를 코드가 아닌 스킬·명령어로 버전 관리 가능
- 신규 팀원·에이전트 모두 동일한 워크플로로 시작
/constraints로 아키텍처 결정 사항을 전역 강제해 드리프트 방지- MIT 라이선스로 **상용·비상용 자유롭게 포크·확장 가능
설치와 기본 사용 단계
저장소를 로컬에 내려받고 의존성을 설치한 뒤 여섯 단계 워크플로를 한 번 돌려보면 됩니다. 먼저 터미널에서 저장소를 복제하고 폴더로 이동하세요.
git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills
npm install설치가 끝나면 AI 에이전트(Claude Code, Cursor, Codex 등)에게 슬래시 명령어를 순서대로 말하면 됩니다. 각 명령어는 개발 수명주기의 한 단계에 대응하며, 내부적으로 해당 단계에 필요한 스킬을 자동으로 활성화합니다.
1. 명세 작성
/spec— 무엇을 만들지 정의합니다. '코드 전에 명세' 원칙에 따라 요구사항을 구조화합니다.2. 계획 수립
/plan— 작고 원자적인 태스크로 분해합니다. 실행 가능한 단위로 쪼개는 것이 핵심입니다.3. 증분 구현
/build— 한 번에 한 슬라이스씩 구현합니다. 원하면/build auto로 계획 승인 후 자율 실행을 맡길 수도 있습니다.4. 검증
/test— 테스트로 동작을 증명합니다. 모든 태스크는 테스트 주도 방식으로 커밋됩니다.5. 리뷰
/review— 코드 건강성을 점검합니다. 머지 전 품질 게이트 역할을 합니다.6. 배포
/ship— 프로덕션 배포 준비까지 완료합니다. '빠른 것이 안전하다'는 원칙을 따릅니다.
이 흐름을 한 번 돌려보면 시니어 엔지니어의 워크플로·품질 게이트·베스트 프랙티스가 에이전트에게 어떻게 내재화되는지 바로 체감할 수 있습니다.
핵심 커맨드 한눈에 보기
애디 오스마니가 공개한 agent-skills는 10.1만 개 스타를 받은 프로덕션급 스킬셋으로, 개발 라이프사이클 전 단계를 아홉 가지 슬래시 커맨드로 매핑했어요. 각 커맨드는 시니어 엔지니어가 반복하는 품질 게이트·워크플로·베스트 프랙티스를 자동으로 활성화해 AI 에이전트가 현업 엔지니어처럼 일하게 돕습니다.
| 단계 | 커맨드 | 핵심 원칙 |
|---|---|---|
| 무엇을 만들지 정의 | /spec | Spec before code |
| 어떻게 만들지 계획 | /plan | Small, atomic tasks |
| 점진적으로 빌드 | /build | One slice at a time |
| 작동 증명 | /test | Tests are proof |
| 품질 기준 고정 | /constraints | Decide it once, enforce it everywhere |
| 머지 전 리뷰 | /review | Improve code health |
| 웹 성능 감사 | /webperf | Measure before you optimize |
| 코드 단순화 | /code-simplify | Clarity over cleverness |
| 프로덕션 배포 | /ship | Faster is safer |
이 아홉 커맨드와 /build auto만 익혀두면, 스펙 작성부터 배포까지 일관된 엔지니어링 품질을 AI 에이전트에게 위임할 수 있어요.
주의할 점과 한계
agent-skills는 MIT 라이선스로 공개되어 상업적 이용·수정·재배포가 자유롭지만, 라이선스 원문과 저작권 고지를 그대로 포함해야 합니다. 저장소는 8개월 전(2026년 2월) 처음 만들어졌고 이번 달(2026년 10월)에도 업데이트가 이어지고 있어, 최신 버전을 쓰려면 주기적으로 git pull 로 동기화하는 습관이 필요해요.
| 체크 포인트 | 설명 | 권장 주기 |
|---|---|---|
| 라이선스 고지 유지 | MIT 원문·저작권 표기 포함 여부 | 배포·릴리스마다 |
| 업스트림 동기화 | 최신 스킬·버그픽스 반영 | 주 1회 이상 |
| 자동화 경계 확인 | /build auto 가 멈추는 조건·수동 승인 지점 | 스프린트 시작 전 |
| 품질 게이트 실행 | 테스트·린트·보안·웹퍼프 통과 여부 | 매 커밋·PR 시 |
스타 10.1만 개, 포크 1만 584개 규모라 커뮤니티 논의·이슈·PR 이 활발합니다. 주요 변경사항은 릴리스 노트와 CHANGELOG.md 를 통해 공지되니, 워치(Watch) 설정이나 GitHub 알림을 켜두면 최신 스킬·명령어 변화를 놓치지 않고 실무에 반영할 수 있어요.
자주 묻는 질문
Q. 상용 제품에 그대로 써도 되나요? A. MIT 라이선스라 가능합니다. 단, 라이선스 전문과 저작권 표시를 배포물에 포함하세요.
Q. `/build auto` 가 모든 걸 대신해 주나요? A. 계획 수립·실행·테스트·커밋까지 자동화하지만, 실패·보안 이슈·성능 저하 감지 시 자동으로 멈추고 사람 승인을 기다립니다.
Q. 스킬셋 업데이트는 얼마나 자주 나오나요? A. 저장소 생성 8개월 전(2026년 2월) 이후 지속 커밋 중이며, 이번 달(2026년 10월)에도 업데이트됐습니다. 주 단위 동기화를 권장해요.
정리: 지금 바로 적용해보기
앞서 살펴본 agent-skills를 지금 바로 내 프로젝트에 적용해보자. 저장소를 내려받고 의존성을 설치한 뒤 첫 스펙을 작성해 배포까지 마치는 최소 루틴을 10분 안에 끝낼 수 있다. 아래 단계를 순서대로 따라 하면 된다.
1. 저장소 복제 및 진입1분
터미널에서 저장소를 복제하고 폴더로 이동한다.
2. 의존성 설치2분
프로젝트 루트에서 패키지 매니저로 의존성을 설치한다. (npm, pnpm, yarn 중 평소 쓰는 것을 사용)
3. 첫 스펙 작성3분
/spec명령으로 만들고 싶은 기능을 간단히 적는다. 예: "로그인 페이지에 이메일·비밀번호 검증과 에러 메시지 표시를 추가해줘."4. 계획 수립1분
/plan명령으로 스펙을 작은 원자 단위 태스크로 쪼갠다. 자동 생성을 원하면/plan auto를 써도 된다.5. 구현·테스트·리뷰 한 번에2분
/build auto를 실행하면 계획 승인 후 태스크별로 테스트 주도 구현·커밋·리뷰가 순차 진행된다. 실패하거나 위험 단계가 있으면 자동으로 멈춘다.6. 품질 게이트·배포1분
/constraints로 품질 기준을 확정하고,/review→/ship순으로 실행해 프로덕션 배포까지 마무리한다.
git clone https://github.com/addyosmani/agent-skills.git
cd agent-skills
npm install # 또는 pnpm install / yarn install
# 이후 AI 에이전트(Claude Code, Cursor, Codex 등)에서 /spec → /plan → /build auto → /review → /ship 순서로 실행이 루틴을 한 번 돌려보면 agent-skills가 시니어 엔지니어 워크플로를 어떻게 자동화하는지 바로 체감할 수 있다. 다음 프로젝트부터는 스펙 작성 3분, 나머지 7분만 투자해 배포까지 끝내보자.