agent-skills: AI 코딩 에이전트를 시니어 엔지니어로 만드는 19개 오픈소스 스킬

AI 코딩 에이전트는 기본적으로 최단 경로를 택합니다. 스펙, 테스트, 보안 리뷰를 건너뛰죠. agent-skills는 시니어 엔지니어가 프로덕션 코드에 적용하는 규율을 구조화된 워크플로우로 강제하는 오픈소스입니다.

Google Chrome DevRel 출신이자 현재 Anthropic에서 일하는 Addy Osmani가 만든 addyosmani/agent-skills는 AI 코딩 에이전트(Claude Code, Cursor, Gemini CLI, Copilot)가 시니어 엔지니어의 워크플로우를 따르도록 만든 프로덕션급 엔지니어링 스킬 19종입니다. 2026년 4월 기준 GitHub 스타 8,600개 이상을 기록하고 있습니다.

6단계 개발 라이프사이클

19개 스킬이 소프트웨어 개발의 전체 생명주기에 매핑됩니다.

DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP

• DEFINE: idea-refine, spec-driven-development
• PLAN: planning-and-task-breakdown
• BUILD: incremental-implementation, TDD, context-engineering, frontend-ui, API design
• VERIFY: browser-testing, debugging-and-error-recovery
• REVIEW: code-review, code-simplification, security, performance
• SHIP: git-workflow, CI/CD, deprecation, documentation, shipping

핵심 설계 원칙

프로세스, 프로즈 아님

각 스킬은 참조 문서가 아니라 에이전트가 실제로 따르는 워크플로우입니다. 이전 단계의 산출물 없이는 다음 단계로 넘어갈 수 없습니다.

반합리화 (Anti-rationalization)

"나중에 테스트 추가할게요" 같은 변명을 사전 차단합니다. 각 스킬에 반론 테이블이 내장되어 있어서 AI 에이전트가 프로세스를 건너뛰려 할 때 근거를 제시합니다.

검증 비타협

모든 스킬이 증거 요구사항으로 끝납니다. "맞는 것 같다"는 통과 기준이 아닙니다. 테스트 결과, 벤치마크, 보안 스캔 리포트가 필요합니다.

점진적 공개

SKILL.md가 진입점이고, 세부 참조는 필요할 때만 로드합니다. AI 에이전트의 컨텍스트 윈도우를 효율적으로 사용하기 위한 설계입니다.

Google 엔지니어링 문화의 코드화

포함 내역

• 19개 스킬: 전체 개발 라이프사이클 커버
• 7개 슬래시 커맨드: /spec, /plan, /build, /test, /review, /code-simplify, /ship
• 3개 에이전트 페르소나: code-reviewer, test-engineer, security-auditor
• 4개 체크리스트: testing, security, performance, accessibility

설치 방법

Claude Code:

/plugin marketplace add addyosmani/agent-skills

Cursor: SKILL.md를 .cursor/rules/에 복사

Gemini CLI:

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

결론

AI 코딩 에이전트는 도구입니다. 시니어 엔지니어의 규율 없이 사용하면 기술 부채만 쌓입니다. agent-skills는 그 규율을 구조화한 오픈소스로, 누구나 무료로 사용할 수 있습니다.

GitHub: addyosmani/agent-skills (MIT License, 8,600+ stars)

참고 자료

• agent-skills GitHub
• Addy Osmani - My LLM Coding Workflow
• Addy Osmani LinkedIn