Addy Osmani의 agent-skills: AI 코딩 에이전트 스킬 24개 완전 정리 (2026)

agent-skills는 2026년 2월 15일에 공개된 지 118일 만에 GitHub 스타 56,810개를 돌파한 오픈소스 프로젝트예요. AI 코딩 에이전트가 소프트웨어를 제대로 만들 수 있도록 6단계 라이프사이클과 24개의 실전 스킬을 담았습니다. 이 글에서 agent-skills가 뭔지, 어떻게 쓰는지, 그리고 커뮤니티의 솔직한 반응까지 한 번에 정리해 드릴게요.

Addy Osmani가 누구인가요?

Addy Osmani는 구글에서 14년간 Chrome 개발자 경험(DevEx) 팀을 이끈 엔지니어예요. 지금은 Google Cloud AI 디렉터로 자리를 옮겨 Gemini, Vertex AI 등 AI 개발자 도구 분야를 책임지고 있습니다. 개발자라면 한 번쯤 들어봤을 Learning JavaScript Design Patterns의 저자이기도 해요.

그가 개발자들 사이에서 이름을 알린 건 웹 성능 분야 덕분이에요. web-vitals, PageSpeed Insights 툴링, Puppeteer 같은 굵직한 프로젝트에 기여해 왔죠. 그런 그가 AI 코딩 에이전트를 위한 워크플로우 표준화에 뛰어든 게 바로 agent-skills예요.

agent-skills가 뭔가요?

agent-skills란: AI 코딩 에이전트가 소프트웨어를 만드는 전 과정을 6단계 라이프사이클로 정리하고, 각 단계에 필요한 작업 절차를 "스킬" 단위로 묶은 오픈소스 모음집입니다. MIT 라이선스로 누구나 자유롭게 쓸 수 있어요.

핵심은 6단계 라이프사이클이에요.

  • DEFINE — 요구사항 명확화 및 스펙 작성
  • PLAN — 태스크 분해 및 구현 계획 수립
  • BUILD — 한 번에 한 조각씩 점진적 구현
  • VERIFY — 테스트와 디버깅으로 동작 검증
  • REVIEW — 코드 품질·보안·단순화 점검
  • SHIP — 배포 및 릴리스 자동화

이 라이프사이클에 맞춰 23개의 라이프사이클 스킬과 1개의 메타 스킬(using-agent-skills)로 구성된 총 24개 스킬이 준비되어 있어요. 서브에이전트도 4개(code-reviewer, security-auditor, test-engineer, web-performance-auditor)가 포함됩니다.

SKILL.md 오픈 표준의 의미

agent-skills가 단순한 스크립트 모음이 아닌 이유는 SKILL.md 오픈 표준을 따르기 때문이에요.

SKILL.md는 Anthropic이 2025년 10월 16일 처음 공개하고, 2025년 12월 18일 오픈 표준으로 확장한 포맷이에요. 구조는 이렇게 생겼어요.

---
name: test-driven-development
description: Drives development with tests. Use when implementing any logic...
---

그 아래에 마크다운으로 절차를 서술하는 방식이에요. YAML frontmatter에 name과 description을 적고, 나머지는 자연어로 쓰는 거죠.

MCP(Model Context Protocol)가 AI 모델과 외부 도구 연결의 표준이 됐다면, SKILL.md는 AI 에이전트의 작업 방식 표준이 되고 있어요. 2026년 3월 기준으로 Claude Code, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf 등 32개 도구와 호환됩니다. Anthropic이 MCP에 이어 또 한 번 산업 표준화를 시도하는 셈이에요.

대표 스킬 톺아보기

24개 스킬 중 실전에서 자주 쓰이는 것들을 소개할게요.

spec-driven-development: 코드를 짜기 전에 스펙 문서를 먼저 작성하는 스킬이에요. 요구사항이 불명확한 상태에서 에이전트가 엉뚱한 코드를 만드는 걸 방지해 줍니다.

planning-and-task-breakdown: 복잡한 기능을 구현 가능한 작은 단위로 쪼개는 스킬이에요. PLAN 단계의 핵심으로, 전체 작업이 얼마나 걸릴지 가시화해 주죠.

test-driven-development: TDD를 에이전트와 함께 실천하는 스킬이에요. 테스트를 먼저 작성하고, 그 테스트를 통과하는 코드를 만드는 RED→GREEN→REFACTOR 사이클을 따릅니다.

code-simplification: 동작하는 코드를 더 읽기 쉽게 만드는 스킬이에요. "영리함보다 명료함"이 원칙이고, /code-simplify 커맨드로 바로 실행할 수 있어요.

security-and-hardening: REVIEW 단계에서 보안 취약점을 점검하는 스킬이에요. security-auditor 서브에이전트와 함께 동작합니다.

interview-me: 에이전트가 한 번에 한 질문씩 인터뷰 형식으로 요구사항을 끌어내는 스킬이에요. 막연한 아이디어를 구체적인 스펙으로 바꾸는 데 유용해요.

슬래시 커맨드도 8개(/spec, /plan, /build, /test, /review, /code-simplify, /ship, /webperf)가 있어서 각 단계를 직접 호출할 수 있어요.

설치하고 써보기

Claude Code 사용자라면 마켓플레이스에서 바로 설치할 수 있어요.

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Gemini CLI 사용자는 이렇게 설치해요.

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

설치 후에는 스킬이 작업 컨텍스트를 보고 자동으로 활성화돼요. API 설계 작업을 하면 api-and-interface-design 스킬이 자동으로 붙는 방식이에요. /spec부터 /ship까지 슬래시 커맨드로 라이프사이클 단계를 직접 호출할 수도 있어서, 스킬 이름을 일일이 기억하지 않아도 되는 게 장점이에요.

무조건 좋기만 할까요?

Hacker News 커뮤니티의 반응은 긍정과 비판이 섞여 있어요.

긍정적인 쪽에서는 "스킬이 프롬프트보다 낫다", "에이전트 워크플로우를 체계화하는 실용적인 접근"이라는 평가가 많아요. 특히 SKILL.md 오픈 표준이 AI 도구들 사이의 호환성을 높인다는 점을 환영했죠. 56,810개의 스타가 그 관심을 잘 보여줘요.

반면 "Agent Skills are all Slop"이라는 비판 스레드도 있었어요. 구조화된 스킬이 정말 결과물 품질을 높이는지, LLM의 신뢰성 한계를 절차로 가릴 수 있는지에 대한 회의적인 시각이에요.

둘 다 일리 있는 이야기예요. agent-skills는 에이전트가 체계 없이 날뛰는 문제를 해결하는 데 집중하기 때문에, 이미 정교하게 튜닝된 워크플로우가 있는 팀에는 불필요할 수 있어요.

마무리

agent-skills는 AI 코딩 에이전트를 처음 진지하게 도입하려는 팀에게 좋은 출발점이에요. 6단계 라이프사이클은 에이전트와 개발자가 같은 언어로 대화할 수 있게 해주고, SKILL.md 표준은 도구가 바뀌어도 워크플로우를 이어갈 수 있게 해줍니다.

2026년 6월 13일 기준으로 GitHub에서 무료로 사용할 수 있어요. 팀의 AI 코딩 워크플로우를 체계화하고 싶다면 한 번 설치해 보세요.

관련 글: 퀀텀점프클럽 블로그에서 Claude Code와 AI 에이전트 활용법을 더 확인할 수 있어요.

자주 묻는 질문 (FAQ)

Q: agent-skills 사용은 유료인가요?

agent-skills 자체는 MIT 라이선스 무료 오픈소스예요. 다만 Claude Code나 Gemini CLI 같은 플랫폼의 API 비용은 해당 서비스 정책을 따릅니다.

Q: Claude Code 없이도 쓸 수 있나요?

네. Gemini CLI, Cursor, OpenCode, GitHub Copilot, Windsurf 등 2026년 3월 기준 32개 도구에서 SKILL.md 표준을 지원해요.

Q: SKILL.md 표준은 누가 만들었나요?

Anthropic이 2025년 10월 16일 처음 공개하고 2025년 12월 18일 오픈 표준으로 확장했어요. MCP(Model Context Protocol)에 이은 Anthropic의 AI 에이전트 표준화 작업이에요.

Q: 스킬이 자동으로 활성화된다고 했는데, 어떻게 동작하나요?

에이전트가 현재 작업 컨텍스트를 분석해서 가장 적합한 스킬을 자동 선택해요. 예를 들어 API 설계 작업 중이면 api-and-interface-design 스킬이 자동으로 활성화됩니다. 슬래시 커맨드(/spec, /plan 등)로 수동 호출도 가능해요.

참고 자료