$ /plugin marketplace add addyosmani/agent-skills && /plugin install agent-skills@addy-agent-skills copy
Addy Osmani(Google에서 Gemini와 Google Cloud를 담당하는 Director)가 만든 오픈소스 프로젝트(
addyosmani/agent-skills).
왜 필요한가?
코딩 에이전트는 코드를 빠르게 만들어내지만, 시니어 엔지니어가 일하는 방식 — 스펙을 먼저 다듬고, 테스트로 검증하고, 보안과 성능을 점검한 뒤 배포하는 절차 — 를 스스로 따르지는 않습니다. 프롬프트로 매번 지시하면 누락이 생기고, 긴 가이드 문서를 컨텍스트에 넣어도 에이전트가 참고만 하고 지나치기 쉽습니다.
Agent Skills는 그 절차를 24개 스킬로 인코딩합니다. 설계 철학은 “Process, not prose” — 에이전트가 읽는 참고 문서가 아니라 따라야 하는 워크플로입니다. 모든 스킬에 테스트 통과나 런타임 데이터 같은 증거 요구사항이 있고(“Verification is non-negotiable”), 에이전트가 절차를 건너뛸 때 흔히 대는 핑계와 그 반박을 정리한 anti-rationalization 테이블도 포함합니다.
구성
24개 스킬이 개발 수명주기 단계로 조직되어 있습니다.
| 단계 | 스킬 수 | 예시 |
|---|---|---|
| Define | 3 | interview-me, idea-refine, spec-driven-development |
| Plan | 1 | planning-and-task-breakdown |
| Build | 7 | test-driven-development, context-engineering, frontend-ui-engineering, api-and-interface-design |
| Verify | 2 | browser-testing-with-devtools, debugging-and-error-recovery |
| Review | 4 | code-review-and-quality, code-simplification, security-and-hardening, performance-optimization |
| Ship | 6 | git-workflow-and-versioning, ci-cd-and-automation, documentation-and-adrs, shipping-and-launch |
스킬 외에 다음이 함께 들어 있습니다.
- specialist persona 에이전트 4개 — code-reviewer, test-engineer, security-auditor, web-performance-auditor
- 참고 체크리스트 4개 — testing-patterns, security-checklist, performance-checklist, accessibility-checklist
- hooks — 세션 수명주기 처리
- 도구별 슬래시 명령 — Claude Code용 7개(
.claude/commands/), Gemini CLI용 7개, Antigravity용 8개
사용 방법
- 마켓플레이스를 추가하고 플러그인을 설치합니다 —
/plugin marketplace add addyosmani/agent-skills && /plugin install agent-skills@addy-agent-skills - 평소처럼 작업합니다 — 스킬은 작업 내용에 따라 자동 활성화됩니다. API를 설계하면
api-and-interface-design이, UI를 만들면frontend-ui-engineering이 뜹니다. - 단계를 직접 밟고 싶으면 슬래시 명령을 사용합니다 —
/spec,/plan,/build,/test,/review,/code-simplify,/ship.
알아두면 좋은 점
- MIT 라이선스 —
addyosmani/agent-skills오픈소스 프로젝트입니다. - Claude Code 전용이 아님 — Cursor(
.cursor/rules/에 SKILL.md 복사), Windsurf(rules 설정), OpenCode(AGENTS.md와 skill 도구), GitHub Copilot(.github/copilot-instructions.md) 등 도구별 설정 방법이docs/에 정리되어 있습니다. - 마켓플레이스 이름 주의 — 설치 시 플러그인 식별자는
agent-skills@addy-agent-skills입니다. 마켓플레이스 추가(/plugin marketplace add) 없이 install만 실행하면 찾지 못합니다. - 증거 기반 검증 — 모든 스킬이 “통과하는 테스트”나 “런타임 데이터” 같은 증거 요구사항을 명시합니다. 에이전트가 “다 됐습니다”라고 말로만 보고하는 패턴을 막는 장치입니다.