에이전트 스킬

26K stars를 넘은 Addy Osmani의 Agent Skills는 AI 코딩 에이전트가 명세 작성, 테스트 선행, 리뷰 가능한 PR, 신뢰 경계 검토 같은 시니어 엔지니어링 절차를 건너뛰지 못하게 만드는 Markdown 기반 워크플로 스캐폴딩이다.

스킬은 참조 문서가 아니라 단계 순서, 체크포인트 증거, 종료 기준을 가진 실행 절차에 가깝다. 저장소는 20개 스킬을 Define / Plan / Build / Verify / Review / Ship의 6단계와 /spec, /plan, /build, /test, /review, /ship, /code-simplify의 7개 slash command로 묶는다.

핵심 원칙은 다음과 같다.

• 산문보다 프로세스: 에세이보다 실행 가능한 워크플로를 넣는다.
• anti-rationalization tables: "이 작업은 너무 단순하다" 같은 변명에 미리 반박을 둔다.
• 검증은 종료 기준: 테스트 통과뿐 아니라 런타임 동작, 로그, 리뷰 승인을 증거로 삼는다.
• progressive disclosure: 필요한 스킬만 로드해 컨텍스트 오염을 줄인다.
• scope discipline: 요청받은 범위만 건드리고 인접 시스템은 건드리지 않는다.

글은 이 구조를 Google의 design doc, code review, trunk-based development, feature flags, DAMP 테스트 철학 같은 공개 엔지니어링 관행과 연결한다. Claude Code, Cursor, Gemini CLI, Codex, Aider, Windsurf, OpenCode 등에 Markdown 파일로 이식할 수 있으며, 설치하지 않아도 AGENTS.md와 팀 런북에 반합리화 방지 규칙, 검증 기준, 점진적 공개를 가져다 쓸 수 있다고 정리한다.