한 줄로 말하면
요즘 "바이브 코딩"이라는 말이 유행합니다. AI에게 "이런 앱 만들어줘"라고 말하면 코드가 뚝딱 나오는 시대죠. 문제는 AI가 종종 급하게, 확인 없이 코드를 쏟아낸다는 점입니다. 겉보기엔 돌아가지만 테스트가 없고, 보안 구멍이 있고, 나중에 손대기 어려운 코드가 쌓입니다.
agent-skills는 이 문제를 정면으로 다룹니다. AI 코딩 도구에 "시니어 개발자의 규율"을 얹어주는 규칙집이라고 생각하면 됩니다. 설치하면 AI가 마치 경력 10년차 개발자처럼 — 먼저 계획하고, 작게 쪼개고, 반드시 검증하고, 리뷰한 뒤에야 배포하도록 행동이 바뀝니다.
"그럴듯해 보인다"는 결코 충분하지 않다 — 모든 단계는 눈으로 확인할 수 있는 증거로 끝나야 한다.
누가 만들었나요?
만든 사람은 Addy Osmani입니다. 구글에서 크롬 개발자도구(Chrome DevTools) 팀을 이끄는 엔지니어링 리더로, 웹 개발자라면 한 번쯤 그의 책이나 글을 접했을 정도로 이 분야의 손꼽히는 전문가입니다. 즉, 이 규칙집은 아이디어 차원의 실험이 아니라 실제 프로덕션 현장에서 검증된 시니어의 작업 습관을 AI가 따라 하도록 옮겨 놓은 것입니다.
무엇이 달라지나요?
agent-skills를 얹기 전과 후, AI 코딩의 흐름이 이렇게 바뀝니다.
핵심은 6단계 워크플로우
agent-skills는 소프트웨어 개발을 여섯 단계로 나눕니다. 각 단계는 짧은 명령어(슬래시 커맨드)로 불러올 수 있습니다. 개발자가 아니어도 흐름만 보면 충분히 감이 옵니다.
| 단계 | 명령어 | 하는 일 |
|---|---|---|
| 정의 | /spec | 코드를 짜기 전에 "무엇을 만들지" 명세부터 작성 |
| 계획 | /plan | 큰 일을 작고 확인 가능한 작업들로 분해 |
| 구현 | /build | 얇게 한 조각씩, 테스트와 함께 만들기 |
| 검증 | /test | 실제로 작동하는지 테스트로 증명 |
| 리뷰 | /review | 합치기 전 품질·보안·성능 점검 |
| 배포 | /ship | 체크리스트를 통과한 뒤 안전하게 출시 |
이 여섯 단계 안에 총 24개의 세부 스킬이 들어 있습니다. "요구사항을 한 번에 한 질문씩 캐묻기", "공식 문서에 근거해 판단하기", "복잡한 코드를 단순하게 정리하기" 같은 시니어 개발자의 습관이 하나하나 규칙으로 담겨 있습니다.
눈에 띄는 세 가지 장치
어떻게 설치하나요?
거의 모든 AI 코딩 도구에서 쓸 수 있습니다. 가장 인기 있는 Claude Code라면 명령어 한 줄이면 끝입니다.
/plugin marketplace add addyosmani/agent-skills
내 AI 도구 확인
Claude Code, Cursor, Gemini CLI, Windsurf, GitHub Copilot 등 대부분의 AI 코딩 도구를 지원합니다.
스킬 설치
Claude Code는 위 명령어 한 줄, 다른 도구는 스킬 파일을 지정된 폴더에 복사하면 됩니다. README에 도구별 방법이 표로 정리되어 있습니다.
명령어로 부르기
이후 /spec, /plan, /build 같은 명령어로 원하는 단계를 부르면 AI가 그 규칙을 따라 일합니다.
비개발자에게도 의미가 있습니다. AI에게 코딩을 맡겨 앱이나 자동화 스크립트를 만들어 본 적이 있다면, agent-skills는 그 결과물의 품질을 눈에 띄게 끌어올려 줍니다. "빠르게 대충"이 아니라 "차근차근 제대로" 만들도록 AI의 습관 자체를 바꾸기 때문입니다.
솔직한 한계
느려질 수 있습니다. 계획·검증·리뷰 단계를 거치므로, 그냥 "코드 뽑아줘"보다 시간이 더 걸립니다. 대신 다시 고치는 시간이 줄어듭니다. 빠른 실험보다 오래 쓸 코드에 어울립니다.
AI 코딩 도구가 있어야 합니다. 이 스킬 자체는 단독 앱이 아니라, Claude Code나 Cursor 같은 도구 위에 얹는 규칙 모음입니다. 그런 도구를 먼저 쓰고 있어야 합니다.
영어 기반입니다. 스킬 문서와 명령어가 영어로 되어 있어, 세부 내용을 파악하려면 어느 정도 영어를 읽을 수 있으면 좋습니다.