한 줄 정의
agent-skills는 Claude Code·Cursor·Gemini CLI 같은 AI 코딩 에이전트가 요구사항 정리부터 배포까지 시니어 엔지니어의 작업 순서와 품질 기준을 따라 하도록 묶어둔 GitHub 스킬 패키지야. Addy Osmani가 만들었고 MIT 라이선스로 공개돼 있어.
실제로 무엇을 하나
agent-skills는 소프트웨어 개발 흐름을 24개 스킬로 나눠서, 에이전트가 각 단계에서 무엇을 확인하고 무엇을 증거로 남겨야 하는지 정해둬. 슬래시 명령으로 단계를 부르는 구조야 — 요구사항 정리(spec), 작업 분해(plan), 구현(build), 테스트(test), 리뷰(review), 배포(ship). 각 스킬 안에는 거쳐야 할 절차랑 통과 기준이 들어 있고, “테스트 통과 같은 근거가 있어야 완료로 표시”하는 게이트가 박혀 있어.
전문가 역할도 4종 따로 둬. 코드 리뷰어, 보안 점검, 테스트 엔지니어, 웹 성능 점검을 해당 단계에서 부르고, 테스트·보안·성능·접근성용 참고 체크리스트도 같이 묶여 있어. Claude Code에서는 /plugin marketplace add addyosmani/agent-skills로 등록한 뒤 설치하고, Cursor·Gemini CLI·Copilot·Windsurf에도 같은 스킬을 붙일 수 있어.
왜 중요한가
AI 코딩 에이전트의 약점은 데모는 잘 도는데 실제 코드베이스에선 요구사항 확인이나 계획, 코드 리뷰 같은 단계를 건너뛴다는 거야. agent-skills는 그 빈 단계를 선택이 아니라 거쳐야 하는 체크포인트로 바꿔서, 에이전트가 내놓는 결과의 품질을 일정하게 잡으려는 시도야. 같은 스킬을 여러 도구에서 쓸 수 있으니까, 도구를 바꿔도 작업 방식은 그대로 유지돼.
주의해서 볼 점
agent-skills는 MCP 서버 같은 실행 프로토콜이 아니라, 에이전트한테 읽히는 절차 문서 묶음이야. 그래서 단일 도구(tool)보다 GitHub 저장소 자체가 정체성인 project로 봐야 해. 스타·라이선스·릴리스가 도입 판단의 1차 정보거든.
Cursor 같은 에이전트 도구와는 층이 달라. 도구는 코드를 읽고 쓰는 실행 환경이고, agent-skills는 그 도구 위에 얹는 작업 규칙이야. 그리고 스킬이 단계를 강제하도록 설계됐다는 거지, 에이전트가 항상 그대로 따른다는 보장은 아니야. 24개를 한 번에 다 넣기보다 자주 빼먹는 단계부터 붙여보고 판단하는 게 안전해.