Agent Skills (Addy Osmani): 명세부터 배포까지 다루는 25개 엔지니어링 스킬
명세·계획·구현·테스트·검토·배포 전 과정을 구조화한 25개 엔지니어링 스킬 묶음이다. 단계별 절차와 검증 증거, 품질 관문, 생략 방지 지침을 Markdown으로 제공해 여러 코딩 에이전트에서 같은 개발 규율을 적용하게 돕는다. 현재 Claude 플러그인 매니페스트 버전은 0.6.15다.
주요 기능
- 25개 스킬: 24개 생명주기 스킬과 using-agent-skills 메타 스킬
- 9개 진입 명령: /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify, /ship
- 4개 전문 검토 페르소나: 코드·테스트·보안·웹 성능
- TDD, 작은 수직 단위 구현, 공식 문서 기반 개발, 요구사항 인터뷰, 보안·접근성·관측성·배포 체크리스트
- /build auto는 계획 승인 후 작업별 테스트·커밋을 진행하고 실패·위험 단계에서 중지하도록 설계
구조
공유 skills/ 워크플로, agents/ 전문 페르소나, references/ 공용 체크리스트와 호스트별 플러그인·명령 어댑터로 구성돼요. 현재 Claude 플러그인 매니페스트는 0.6.15이며 session-start 훅은 기본 연결되지 않습니다.
누구에게 쓸모 있나요
AI 코딩 에이전트 개발 절차를 정리하려는 개발자·팀.
설치 전 준비
- 지원 스킬/플러그인 호스트 필요. Codex 네이티브 플러그인은 CLI 0.122 이상.
- npx 설치는 Node.js/npm 환경 필요. 스킬의 이식 가능한 핵심은 Markdown이고 각 호스트별 설정이 다름.
- 옵션 session-start.sh는 bash/jq 필요. 현재 plugin.json에 해당 훅이 연결되어 있지 않으며 네이티브 스킬 라우팅이 없는 호스트에만 별도 연결하도록 코드 주석에 안내.
- Claude Code·Codex·Cursor·Gemini·Antigravity·Windsurf·OpenCode·Copilot·Kiro·Command Code 등.
- 호스트마다 명령·탐색 경로가 달라요.
설치 방법
Skills CLI 범용
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
npx skills add addyosmani/agent-skills
npx skills add addyosmani/agent-skills --list개별 스킬 예
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
npx skills add addyosmani/agent-skills --skill code-review-and-qualityClaude Code
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsCodex CLI 0.122+
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills로컬 Claude 개발
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skillsGemini CLI
공식 문서의 설치 예시이며 이번 조사에서 실행하지 않았어요.
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills사용 방법
- Claude Code에서 /spec → /plan → /build → /test → /review → /ship 등 필요한 단계 실행.
- 내장 명령과 충돌하면 /agent-skills:review처럼 네임스페이스 사용.
- Codex에서는 @spec-driven-development 등 @로 스킬 호출.
- Cursor는 .cursor/skills/에 워크플로를 넣고 짧은 정책만 .cursor/rules/*.mdc에 유지. 전체 스킬을 rules에 붙여넣지 않도록 안내.
비용과 API 키
MIT 무료 배포. 호스트 모델 요금과 실제 개발·테스트·배포 인프라 비용은 별도이며 고정 요금 미명시.
라이선스
루트 LICENSE에서 MIT를 확인했어요. Copyright (c) 2025 Addy Osmani. 사용·수정·상업적 재배포가 허용되며 저작권 고지와 라이선스 사본 유지, 무보증 조건을 준수해야 해요.
주의사항과 알려진 이슈
- 개별 npx 스킬 설치는 저장소 최상위 references/를 복사하지 않아 공용 체크리스트 경로를 잃을 수 있음. 전체 저장소 설치·복사 등으로 보완하는 공식 경고(#361).
- 호스트마다 슬래시 명령 지원이 다름. Copilot에는 Claude 생명주기 명령이 그대로 나타나지 않으며 Antigravity 일부 버전은 wrapper 발견 문제 존재.
- 워크플로 지침이지 샌드박스·보안 경계 또는 코드 품질 보증은 아님. 검토·테스트 증거와 호스트 권한 제어를 별도로 유지.
- /build auto나 /ship은 실제 파일 변경·커밋·배포에 이어질 수 있으므로 허용 범위, 비밀정보, 배포 대상 및 승인 정책을 먼저 정할 것.
- README의 SSH→HTTPS 우회 예시 git config –global은 Git 전역 설정을 바꾸므로 필요한 경우에만 이해하고 사용.
확인 범위
확인 날짜: 2026-11-05
확인 커밋: 301b02b12bff98e4688e6984af6556802322bbde
확인한 범위: 공식 GitHub API·README·LICENSE를 읽고 main 커밋 SHA에 고정한 README와 blob 일치 확인. 설치·실행 테스트는 하지 않음. 공개·비보관 상태이며 원래 요청한 저장소 이름과 일치해요.
확인 한계: 대상 프로그램 설치·실행·모델 호출은 하지 않았어요. 호환성·품질·성능·전체 보안 감사 및 별도 배포 채널 최신성은 미검증이에요.