agent-skills 사용법, Addy Osmani 에이전트 스킬 설치

결론부터 말하면 Addy Osmani의 agent-skills는 AI 코딩 에이전트용 프로덕션급 엔지니어링 스킬 묶음이에요. Claude Code, Cursor, Codex 등에 넣고 스펙·설계·빌드·테스트·리뷰 흐름을 돌릴 수 있습니다. GitHub 별은 약 10.5만(2026-10-12 기준), 라이선스는 MIT예요.

agent-skills — Production-grade engineering skills for AI coding agents

agent-skills란, 라이프사이클 엔지니어링 스킬

한 줄로 그림을 그리는 스킬이 아니라, 소프트웨어를 만드는 전 과정을 스킬로 나눈 팩이에요. README 기준 스킬은 모두 25개입니다. 라이프사이클 24개와 using-agent-skills 메타 스킬이 들어 있어요.

만든 이는 Addy Osmani(@addyosmani)이고, 협업에는 Federico Bartoli, Joan León이 있습니다. 저장소는 github.com/addyosmani/agent-skills예요.

설계 포인트는 README에 적힌 그대로예요. 프로세스 워크플로에 반합리화(anti-rationalization) 표와 검증 게이트를 두고, Hyrum's Law, Beyonce Rule, Chesterton's Fence 같은 Google 엔지니어링 문화 개념을 스킬 안에 심어 두었다고 합니다.

에이전트 스킬 설치 방법 (npx skills add)

전체 팩을 한 번에 넣는 기본 명령은 이거예요.

npx skills add addyosmani/agent-skills

목록만 보려면 이렇게 합니다.

npx skills add addyosmani/agent-skills --list

README에 따르면 Skills CLI는 70개 이상 에이전트에 설치할 수 있어요. skills.sh에도 같은 팩을 찾아볼 수 있습니다.

Claude Code · Codex 플러그인 설치

Claude Code 플러그인으로 넣는 방법(README):

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

SSH가 안 되면 HTTPS URL로 marketplace를 추가하는 대안이 README에 나와 있어요.

Codex(CLI v0.122 이상)는 아래처럼 합니다.

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

슬래시 커맨드 9개와 /build auto

README에 적힌 슬래시 커맨드는 9개예요.

커맨드	역할(요약)
/spec	스펙
/plan	계획
/build	빌드
/test	테스트
/constraints	제약
/review	리뷰
/webperf	웹 성능
/code-simplify	코드 단순화
/ship	출시

/build auto는 계획을 한 번 승인하면 자율 태스크 루프로 이어집니다. 그래도 실패나 위험 단계에서는 멈춘다고 README에 적혀 있어요.

클로드 코드 스킬 · 단건 설치 주의

스킬을 하나만 npx skills add로 고르면, 그 스킬 폴더만 복사되고 저장소의 references/는 같이 안 옵니다. README·이슈 #361에 나온 주의점이에요. 레퍼런스가 필요한 스킬이면 전체 팩 설치를 쓰는 편이 안전합니다.

설치한 뒤에는 스펙 → 계획 → 빌드 → 테스트 → 리뷰처럼 단계마다 커맨드를 걸면 됩니다. 에이전트가 “대충 넘어가도 된다”고 합리화하지 못하게 표와 게이트가 붙어 있는 구조예요.

함께 보면 좋은 글

• Anatomy 사용법, Claude Code 아이소메트릭 스킬
• Claude Dashboards

---

출처: github.com/addyosmani/agent-skills (README), X https://x.com/alannnfx/status/2109205523308654854, skills.sh