agent-skills
무엇인가
agent-skills는 소프트웨어를 만들 때 시니어 엔지니어가 적용하는 워크플로·품질 게이트·모범 사례를 스킬 파일로 인코딩한 묶음이다. 요구사항 정제, 스펙 작성, 구현, 테스트 주도 디버깅, 리뷰, 배포 판단이라는 문제 영역을 규율 대상으로 삼는다.
어떻게 동작하나
스킬은 저장소의 skills/ 디렉터리에 개별 단위로 놓이고, 루트 references/ 디렉터리에 공유 체크리스트를 둔다. 에이전트는 작업 내용에 따라 스킬을 자동으로 발동시킨다. API를 설계하면 api-and-interface-design이, UI를 만들면 frontend-ui-engineering이 붙는 식이다. 여기에 /spec·/plan·/build·/test·/review·/ship 슬래시 명령이 개발 생애주기 단계마다 알맞은 스킬을 활성화한다. /build auto는 승인된 계획을 한 번에 실행하되 각 태스크를 테스트 주도로 개별 커밋하고 실패나 위험 단계에서 멈춘다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 CLAUDE.md 한 파일에 규칙을 몰아넣는 방식과 달리, 스킬을 단계별로 분리하고 발동 조건을 작업 종류에 연결한다. 규칙이 하나의 긴 문서가 아니라 재사용 가능한 단위로 쪼개져 필요한 시점에만 로드되고, 슬래시 명령이 그 조합을 대신 선택한다.
어떻게 쓰나
가장 빠른 설치는 npx skills add addyosmani/agent-skills이며, --list로 먼저 훑거나 --skill <이름>으로 개별 스킬만 받을 수 있다. Claude Code에서는 /plugin marketplace add addyosmani/agent-skills 후 /plugin install agent-skills@addy-agent-skills로 마켓플레이스 설치를 하거나, 저장소를 클론해 claude --plugin-dir로 로컬 플러그인으로 띄운다. 설치 후 /spec 같은 슬래시 명령을 호출하는 것이 첫 사용이다.
전제와 한계
skills CLI는 Claude Code·Cursor·Codex·Copilot·Cline 등 여러 에이전트에 설치되지만, 개별 스킬만 npx로 설치하면 저장소 루트의 references/ 디렉터리가 복사되지 않아 공유 체크리스트 경로를 쓸 수 없다. 이 이식성 문제는 추적 중이며, 전체 저장소 통합이나 클론, 체크리스트 수동 복사로 우회한다. Codex 네이티브 플러그인은 Codex CLI v0.122 이상이 필요하다.