Agent Skills: 소프트웨어 개발 생명주기 전체를 커버하는 AI 코딩 에이전트용 프로덕션급 20개 엔지니어링 스킬 모음

9bow · 4월 22, 2026, 3:30오전

Agent Skills 소개

AI 코딩 에이전트는 코드 작성 자체에는 뛰어나지만, 프로덕션 품질의 소프트웨어 개발에 요구되는 체계적인 프로세스를 따르는 데는 종종 단점을 보입니다. 명세 없이 바로 구현에 뛰어들거나, 테스트를 건너뛰거나, 보안 고려 없이 코드를 작성하는 등의 "지름길"을 택하는 경향이 있습니다. Google Chrome DevRel 엔지니어링 리더인 Addy Osmani가 공개한 agent-skills는 이 문제를 정면으로 해결합니다. 소프트웨어 개발 생명주기(SDLC, Software Development Life Cycle) 전체를 아우르는 20개의 구조화된 엔지니어링 워크플로우를 제공하며, 각 스킬은 Google의 엔지니어링 문화에서 검증된 모범 사례들을 AI 에이전트가 실행 가능한 형태로 담아냈습니다. 2026년 4월 기준 GitHub에서 16,400개 이상의 스타를 기록하고 있습니다.

Agent Skills 프로젝트의 핵심 철학은 "방법론을 산문(prose)이 아닌 프로세스로 담아야 한다"는 것입니다. Hyrum의 법칙(Hyrum's Law), 테스트 피라미드(Test Pyramid), 체스터턴의 울타리(Chesterton's Fence), 트렁크 기반 개발(Trunk-based Development) 같은 검증된 소프트웨어 공학 원칙들이 추상적인 가이드라인이 아닌, AI 에이전트가 단계별로 실행할 수 있는 구체적인 워크플로우로 내장되어 있습니다. 또한 각 스킬에는 에이전트가 흔히 택하는 지름길을 방지하기 위한 "반-합리화 테이블(anti-rationalization table)"이 포함되어 있어, 에이전트가 왜 특정 단계를 건너뛰면 안 되는지를 명확히 이해하도록 합니다.

agent-skills의 6단계 개발 생명주기와 20개 스킬

agent-skills는 소프트웨어 개발의 전체 생명주기를 6개 단계로 구분하고, 각 단계에 해당하는 스킬들을 제공합니다. 7개의 슬래시 커맨드(/spec, /plan, /build, /test, /review, /code-simplify, /ship)로 워크플로우를 활성화할 수 있습니다.

DEFINE(정의) 단계: 코딩에 앞서 명세(specification)를 먼저 작성하는 것을 강제합니다. 아이디어 정제(idea refinement)와 명세 주도 개발(specification-driven development) 스킬이 포함됩니다. 에이전트가 요구사항을 충분히 이해하지 않은 채 구현에 뛰어드는 것을 방지합니다.

PLAN(계획) 단계: 수락 기준(acceptance criteria)과 함께 작업을 세분화하는 계획 수립 스킬을 제공합니다. 큰 기능을 구현 가능한 단위로 분해하고, 각 단위의 완료 기준을 명확히 합니다.

BUILD(구현) 단계: 점진적 구현(incremental implementation), 테스트 주도 개발(TDD), 컨텍스트 엔지니어링, 소스 주도 개발, 프론트엔드 UI 엔지니어링, API 설계 스킬을 포함합니다. 가장 많은 6개의 스킬이 포함된 단계입니다.

VERIFY(검증) 단계: DevTools를 활용한 브라우저 테스팅과 디버깅/오류 복구 스킬을 제공합니다. 구현된 기능이 실제로 의도대로 동작하는지 확인하는 프로세스를 담고 있습니다.

REVIEW(리뷰) 단계: 코드 리뷰, 복잡도 감소, 보안 강화, 성능 최적화 스킬을 제공합니다. 단순히 동작하는 코드를 넘어, 유지보수 가능하고 안전한 코드를 만드는 프로세스입니다.

SHIP(배포) 단계: Git 워크플로우, CI/CD 자동화, 감가상각 패턴(deprecation patterns), 문서화/ADR(Architecture Decision Records), 런치 절차 스킬을 포함합니다. 코드를 프로덕션에 안전하게 배포하기 위한 전체 과정을 다룹니다.

3개의 전문가 페르소나

agent-skills는 기본 스킬 외에 특정 역할에 특화된 3개의 전문가 에이전트 페르소나도 제공합니다. code-reviewer는 시니어 스태프 엔지니어(Senior Staff Engineer) 관점에서 코드 품질을 리뷰합니다. test-engineer는 QA 엔지니어 관점에서 테스트 커버리지와 테스트 품질을 평가합니다. security-auditor는 보안 취약점을 전문적으로 탐지합니다. 이 페르소나들은 특정 검토가 필요할 때 호출할 수 있어, 하나의 에이전트가 다양한 전문가 역할을 수행하는 것보다 더 깊이 있는 피드백을 제공합니다.

지원 플랫폼 및 설치

agent-skills는 다양한 AI 코딩 에이전트 플랫폼을 지원합니다. Claude Code, Cursor, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, Kiro IDE는 물론, 마크다운 형식의 시스템 프롬프트를 지원하는 모든 플랫폼에서 사용 가능합니다.

# Claude Code 마켓플레이스를 통한 설치
/plugin marketplace add addyosmani/agent-skills

# 또는 GitHub에서 직접 클론
git clone https://github.com/addyosmani/agent-skills ~/.claude/skills/agent-skills

# Cursor의 경우 .cursorrules에 포함
# Gemini CLI의 경우 GEMINI.md에 포함

# 스킬 사용 예시 (Claude Code에서)
/spec            # 명세 작성부터 시작
/plan            # 작업 계획 수립
/build           # 점진적 구현
/test            # 테스트 및 검증
/review          # 코드 리뷰
/code-simplify   # 복잡도 감소
/ship            # 프로덕션 배포

agent-skills와 일반 프롬프트의 차이

일반적인 AI 코딩 프롬프트는 "이 기능을 구현해줘"처럼 목표만을 지정합니다. 반면 agent-skills는 목표뿐만 아니라 과정과 품질 게이트(quality gate)까지 명시합니다. 예를 들어 /build 스킬은 구현을 시작하기 전에 명세가 존재하는지 확인하고, 구현 중에는 테스트를 함께 작성하며, 완료 전에는 엣지 케이스를 검토합니다. 이를 통해 에이전트가 단순히 동작하는 코드를 빠르게 생성하는 것이 아니라, 프로덕션에 배포 가능한 수준의 코드를 만들도록 안내합니다.

라이선스

Agent Skills프로젝트는 MIT 라이선스로 공개되어 있어 개인, 팀, 도구 등에서 자유롭게 사용할 수 있습니다.

agent-skills 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~