AI 코딩 에이전트를 위한 프로덕션급 엔지니어링 스킬

AI 코딩 에이전트를 위한 프로덕션급 엔지니어링 스킬

스킬은 소프트웨어 구축 시 세련된 엔지니어들이 사용하는 워크플로우, 품질 게이트, 그리고 모범 사례를 인코딩합니다. 이 스킬들은 개발의 모든 단계에서 AI 에이전트가 이를 일관되게 따르도록 패키징됩니다.

DEFINE PLAN BUILD VERIFY REVIEW SHIP
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
...

개발 라이프사이클에 대응하는 7 개의 슬래시 명령어입니다. 각 명령어는 올바른 스킬을 자동으로 활성화합니다.

수행 중인 작업	명령어	핵심 원칙
구축할 것을 정의	/spec	코딩 전 스펙 작성
구축 방법 계획	/plan	작고 원자적인 작업
점진적으로 구축	/build	한 번에 한 조각
작동 증명	/test	테스트는 증명
병합 전 검토	/review	코드 건강 개선
코드를 단순화	/code-simplify	명확성보다 지혜
프로덕션 출시	/ship	빠름이 안전함

스킬은 수행 중인 작업에 따라 자동으로 활성화되기도 합니다. API 를 설계하면 api-and-interface-design 스킬이, UI 를 구축하면 frontend-ui-engineering 스킬이 활성화됩니다.

Claude Code (추천)

마켓플레이스 설치:

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

SSH 오류? 마켓플레이스는 레포지토리를 SSH 를 통해 복제합니다. GitHub 에 SSH 키가 설정되지 않은 경우, SSH 키를 추가하거나 HTTPS URL 을 사용하여 HTTPS 복제를 강제로 수행하세요:
/plugin marketplace add https://github.com/addyosmani/agent-skills.git /plugin install agent-skills@addy-agent-skills

로컬 / 개발:

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Cursor

어떤 SKILL.md 파일을 .cursor/rules/ 폴더에 복사하거나, 전체 skills/ 디렉토리를 참조하세요. docs/cursor-setup.md 를 참고하세요.

Gemini CLI

자동 발견을 위해 네이티브 스킬로 설치하거나, 지속적 컨텍스트를 위해 GEMINI.md 에 추가하세요. docs/gemini-cli-setup.md 를 참고하세요.

레포지토르에서 설치:

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

로컬 복제본에서 설치:

gemini skills install ./agent-skills/skills/

OpenCode

AGENTS.md 와 skill 도구를 통해 에이전트 구동 스킬 실행을 사용합니다.

GitHub Copilot

agents/ 에서 정의된 에이전트를 Copilot 페르소나로, 스킬 콘텐츠는 .github/copilot-instructions.md 에 사용하세요. docs/copilot-setup.md 를 참고하세요.

Kiro IDE & CLI

Kiro 의 스킬은 ".kiro/skills/" 아래에 위치하며, 프로젝트 또는 글로벌 레벨에 저장할 수 있습니다. Kiro 는 Agents.md 도 지원합니다. https://kiro.dev/docs/skills/ 에서 Kiro 문서를 참조하세요.

Codex / 기타 에이전트

스킬은 일반 Markdown 파일입니다. 시스템 프롬프트나 지시 파일을 받는 모든 에이전트와 작동합니다. docs/getting-started.md 를 참고하세요.

위 명령어는 진입점입니다. 그 아래에서는 20 개의 스킬을 활성화합니다. 각 스킬은 단계, 검증 게이트, 반합리화 테이블이 있는 구조화된 워크플로우입니다. 또한 어떤 스킬도 직접 참조할 수 있습니다.

스킬	기능	사용 시점
idea-refine	모호한 아이디어를 구체적인 제안으로 전환하기 위한 구조화된 발산/수렴적 사고	대략적인 개념이 탐구가 필요할 때
spec-driven-development	코드 작성 전 목표, 명령어, 구조, 코드 스타일, 테스트, 경계를 포함한 PRD 작성	새로운 프로젝트, 기능, 또는 중요한 변경 사항 시작 시

Skill	What It Does	Use When
planning-and-task-breakdown	스펙을 수용 기준과 의존성 순서를 포함한 작은 검증 가능한 작업으로 분해합니다	스펙이 있고 구현 가능한 단위를 필요로 할 때

Skill	What It Does	Use When
incremental-implementation	얇은 수직 슬라이스 - 구현, 테스트, 검증, 커밋. 기능 플래그, 안전한 기본값, 롤백 친화적인 변경 사항	한 파일 이상을 만나는 모든 변경 사항에 대해
...

Skill | What It Does | Use When |
|---|---|
| browser-testing-with-devtools | Chrome DevTools MCP 를 통한 실시간 런타임 데이터 - DOM 검사, 콘솔 로그, 네트워크 추적, 성능 프로파일링 | 브라우저에서 실행되는 모든 것을 구축하거나 디버깅할 때 |
| debugging-and-error-recovery | 5 단계 트라이어지: 재현, 로컬라이제이션, 축소, 수정, 보호. 라인 스탑 규칙, 안전한 대안 | 테스트가 실패하거나 빌드가 깨지거나 행동이 예상과 다를 때 |

| Skill | What It Does | Use When |
|---|---|
| code-review-and-quality | 5 축 리뷰, 변경 크기 (~100 줄), 심각도 라벨 (Nit/Optional/FYI), 리뷰 속도 규범, 분할 전략 | 어떤 변경 사항을 병합하기 전에 |
| ... |

Skill | What It Does | Use When |
|---|---|
| git-workflow-and-versioning | 트렁크 기반 개발, 원자 커밋, 변경 크기 (~100 줄), 커밋-스ave 포인트 패턴 | 어떤 코드 변경 사항도 (항상) |
| ... | 아키텍처 결정 변경, API 변경 또는 기능 배포 시 |

shipping-and-launch | 사전 출시 체크리스트, 기능 플래그 라이프사이클, 단계적 롤아웃, 롤백 절차, 모니터링 설정 | 프로덕션에 배포를 준비할 때 |

Pre-configured specialist personas for targeted reviews:

| Agent | Role | Perspective |
|---|---|
| code-reviewer | Senior Staff Engineer |

Google 의 엔지니어링 문화에서 비롯된 모범 사례가 스킬에 내장되어 있습니다 — Software Engineering at Google 와 Google's engineering practices guide 에서의 개념을 포함합니다. API 설계에는 Hyrum's Law, 테스트에는 Beyonce Rule 과 test pyramid, 코드 리뷰에서는 change sizing 과 review speed norms, 단순화에는 Chesterton's Fence, git workflow 에는 trunk-based development, CI/CD 에는 Shift Left 과 feature flags, 그리고 코드를 부채 (liability) 로 간주하는 전용 폐기 스킬을 포함합니다. 이는 추상적인 원칙이 아닙니다 — 에이전트가 따르는 단계별 워크플로우에 직접적으로 내장되어 있습니다.

스킬은 구체적 (작동 가능한 단계, 모호한 조언이 아님), 검증 가능 (명확한 종료 기준과 증거 요구사항 포함), 전투 검증됨 (실제 워크플로우 기반), 그리고 최소적 (에이전트를 안내하기 위해 필요한 것만) 이어야 합니다.

형식 규격은 docs/skill-anatomy.md 를, 가이드라인은 CONTRIBUTING.md 를 참조하세요.

MIT — 프로젝트, 팀, 도구에서 이 스킬을 사용하세요.