Agent Skills

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

스킬은 시니어 엔지니어가 소프트웨어를 만들 때 사용하는 워크플로, 품질 게이트, 모범 사례를 담고 있습니다. 이 스킬들은 AI 에이전트가 개발의 모든 단계에서 일관되게 따르도록 패키징되어 있습니다.

DEFINE PLAN BUILD VERIFY REVIEW SHIP
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
│Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
└──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
/spec /plan /build /test /review /ship

Commands
개발 라이프사이클에 대응하는 9개의 슬래시 커맨드. 각 커맨드는 적절한 스킬을 자동으로 활성화합니다.

무엇을 하는지
커맨드
핵심 원칙

무엇을 만들지 정의
/spec
코드보다 스펙 먼저

어떻게 만들지 계획
/plan
작고 원자적인 작업

점진적으로 구축
/build
한 번에 한 조각씩

작동함을 증명
/test
테스트가 곧 증명

품질 기준 설정
/constraints
한 번 정하고, 어디서나 강제

머지 전 리뷰
/review
코드 건강 개선

웹 성능 감사
/webperf
최적화 전에 측정

코드 단순화
/code-simplify
영리함보다 명료함

프로덕션 배포
/ship
빠를수록 안전

Claude Code에서는 플러그인 커맨드로 설치됩니다. /review처럼 내장 커맨드와 이름이 같은 경우, 네임스페이스 형식을 사용하세요: /agent-skills:review .

스펙이 존재한 뒤 수동 단계를 줄이고 싶으신가요? /build는 계획을 자동 생성하고 승인된 한 번의 패스에서 모든 작업을 구현합니다 — 계획을 한 번 승인하면 자율적으로 실행됩니다. 이는 작업 사이의 사람 개입을 제거할 뿐, 검증은 제거하지 않습니다: 모든 작업은 여전히 테스트 주도로 진행되고 개별적으로 커밋되며, 실패나 위험한 단계에서는 일시 중지합니다.

스킬은 또한 무엇을 하고 있는지에 따라 자동으로 활성화됩니다 — API를 설계하면 api-and-interface-design 이, UI를 구축하면 frontend-ui-engineering 이 활성화되는 식입니다.

Quick Start
가장 빠른 경로 — 어떤 에이전트든, 한 개의 커맨드. 오픈 스킬 CLI는 70개 이상의 에이전트(Claude Code, Cursor, Codex, Copilot, Cline 등)에 설치합니다:

npx skills add addyosmani/agent-skills # install all 25 skills
npx skills add addyosmani/agent-skills --list # browse before installing
또는 개별 스킬을 받으세요:

npx skills add addyosmani/agent-skills --skill code-review-and-quality # five-axis review before merge
npx skills add addyosmani/agent-skills --skill interview-me # requirements interrogation, one question at a time
npx skills add addyosmani/agent-skills --skill test-driven-development # red-green-refactor, enforced

스킬 하나만 설치하시나요? 스킬별 npx 설치는
skills/<name>/ 만 복사하고, 저장소 수준의 references/ 디렉터리는 복사하지 않습니다. 스킬은 여전히
작동하지만, 보충용 공유 체크리스트 경로는 사용할 수 없습니다. 전체 저장소 통합을 사용하거나, 저장소를 클론하거나, 필요한 체크리스트를
설치된 스킬 내부의 references/ 디렉터리에 복사하세요. 이 이식성 격차는
#361 에서 추적되고 있습니다.

네이티브 통합을 선호하시나요? 아래에서 도구를 선택하세요.

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
Windows나 macOS에서 /plugin install이 여전히 [email protected]: Permission denied (publickey)로 실패한다면, 권장 해결 방법은 Git을 한 번 설정해 서브프로세스 클론에 대해 GitHub SSH URL을 HTTPS로 재작성하도록 하는 것입니다:

git config --global url. " https://github.com/ " .insteadOf [email protected]:

로컬 / 개발:

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

Cursor
워크플로 스킬은 .cursor/skills/ 아래에(agent-skills/skills/ 에서 동기화), 짧은 정책은 .cursor/rules/*.mdc 에 두세요 — 전체 스킬을 rules에 붙여넣지 마세요. 두 디렉터리 모두 프로젝트에 위치하며, 이 저장소는 .cursor/ 폴더를 제공하지 않습니다. docs/cursor-setup.md 를 참고하세요.

Antigravity CLI
스킬과 서브에이전트를 위한 네이티브 플러그인으로 설치하세요. 영향을 받는 Antigravity CLI 릴리스에서는 레거시 커맨드 TOML이 변환된 것으로 보고되지만 해당 래퍼 커맨드는 검색되지 않습니다. 기반이 되는 네임스페이스 스킬을 직접 호출하세요. docs/antigravity-setup.md 를 참고하세요.

저장소에서 설치:

agy plugin install https://github.com/addyosmani/agent-skills.git
로컬 클론에서 설치:

git clone https://github.com/addyosmani/agent-skills.git
agy plugin install ./agent-skills

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/

Windsurf
스킬 내용을 Windsurf rules 설정에 추가하세요. docs/windsurf-setup.md 를 참고하세요.

OpenCode
스킬을 .opencode/skills/ (또는 ~/.config/opencode/skills/ )에 복사하고, 프로젝트 로컬 AGENTS.md 를 추가한 뒤, 에이전트 주도 실행을 위해 내장 skill 도구를 사용하세요. 선택적 슬래시 커맨드는 .opencode/commands/ 아래에 추가할 수 있습니다.

docs/opencode-setup.md 를 참고하세요.

GitHub Copilot
agents/ 의 에이전트 정의를 Copilot 페르소나로 사용하고, 스킬 내용을 .github/copilot-instructions.md 에 넣으세요. 라이프사이클 슬래시 커맨드( /spec , /plan , /build , /test , /review , /ship )는 Claude Code 커맨드이며 Copilot에는 나타나지 않습니다. 대신 스킬을 이름으로 호출하세요( /spec-driven-development , …). docs/copilot-setup.md 를 참고하세요.

독립형 copilot CLI를 사용하시나요? 플러그인으로 설치하세요 — docs/copilot-cli-setup.md 를 참고하세요.

Kiro IDE & CLI
Kiro용 스킬은 ".kiro/skills/" 아래에 있으며 Project 또는 Global 수준에 저장할 수 있습니다. Kiro는 Agents.md도 지원합니다. Kiro 문서는 https://kiro.dev/docs/skills/ 를 참고하세요.

Codex
네이티브 Codex 플러그인으로 설치하세요(Codex CLI v0.122+):

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
첫 번째 커맨드는 마켓플레이스를 등록하고, 두 번째는 플러그인을 설치합니다. Codex는 .codex-plugin/plugin.json 을 통해 루트 skills/ 디렉터리를 직접 읽습니다. 설치 후에는 채팅에서 @ 를 사용해 스킬을 호출하세요(예: @spec-driven-development ). 로컬 설치와 문제 해결은 docs/codex-setup.md 를 참고하세요.

Command Code
내장 cmd skills 커맨드로 네이티브 설치하세요. Command Code는 저장소를 클론하고, 모든 SKILL.md 를 검색한 뒤, .commandcode/skills/ 에 설치합니다:

cmd skills add addyosmani/agent-skills # pick skills to install (project)
cmd skills add addyosmani/agent-skills --global # install for all projects (~/.commandcode/skills/)
cmd skills add addyosmani/agent-skills -s spec-driven-development # install a specific skill
설치된 스킬은 TUI 슬래시 메뉴에 표시됩니다(예: /spec-driven-development ). docs/commandcode-setup.md 를 참고하세요.

Other Agents
스킬은 순수 Markdown입니다 - 시스템 프롬프트나 명령 파일을 받아들이는 모든 에이전트에서 작동합니다. docs/getting-started.md 를 참고하세요. 팩을 설치하지만 위에 나열되지 않은 호스트는 docs/other-hosts.md 에 있습니다.

Adoption
이미 설치하셨나요? 팩을 어떻게 배포할지는 코드베이스에 따라 다릅니다. Adoption Guide는 두 가지 경로를 다룹니다: 그린필드 프로젝트를 위한 첫날부터의 전체 라이프사이클, 또는 기존 코드베이스를 위한 점진적이고 검증 우선의 롤아웃.

All 25 Skills
위의 커맨드는 진입점입니다. 팩에는 총 25개의 스킬이 포함되어 있습니다 — 24개의 라이프사이클 스킬과 using-agent-skills 메타 스킬. 각 스킬은 단계, 검증 게이트, 반합리화 표를 갖춘 구조화된 워크플로입니다. 어떤 스킬이든 직접 참조할 수도 있습니다.

Meta - 어떤 스킬이 적용되는지 발견

Skill
What It Does
Use When

using-agent-skills
들어오는 작업을 올바른 스킬 워크플로에 매핑하고 공유 운영 규칙을 정의
세션을 시작하거나 어떤 스킬이 적용되는지 결정할 때

Define - 무엇을 만들지 명확히

Skill
What It Does
Use When

interview-me
사용자가 원한다고 생각하는 것이 아니라 실제로 원하는 것을 끌어내는 한 번에 한 질문 인터뷰, 약 95% 확신에 도달할 때까지
요청이 불충분하게 명시되었거나, 사용자가 "interview me" / "grill me"를 호출할 때

idea-refine
막연한 아이디어를 구체적인 제안으로 바꾸는 구조화된 발산/수렴 사고
탐색이 필요한 대략적인 개념이 있을 때

spec-driven-development
코드 작성 전에 목표, 커맨드, 구조, 코드 스타일, 테스팅, 경계를 다루는 PRD 작성
새 프로젝트, 기능, 또는 중요한 변경을 시작할 때

constraint-driven-development
합리적인 기본 임계값으로 품질 기준을 인터뷰하고, CONSTRAINTS.md를 작성하며, 각 검사를 비용별로 배치하고, 에이전트가 통과를 위해 검사를 침묵시키거나 테스트를 건너뛰는 것을 잡아냄
작성된 표준이 없거나, 에이전트가 누구도 읽지 않는 것보다 많은 결과물을 만들 때

Plan - 분해하기

Skill
What It Does
Use When

planning-and-task-breakdown
스펙을 수용 기준과 의존성 순서를 갖춘 작고 검증 가능한 작업으로 분해
스펙이 있고 구현 가능한 단위가 필요할 때

Build - 코드 작성

Skill
What It Does
Use When

incremental-implementation
얇은 수직 슬라이스 - 구현, 테스트, 검증, 커밋. 기능 플래그, 안전한 기본값, 롤백 친화적 변경
둘 이상의 파일을 건드리는 모든 변경

test-driven-development
Red-Green-Refactor, 테스트 피라미드(80/15/5), 테스트 크기, DRY보다 DAMP, Beyonce Rule, 브라우저 테스팅
로직 구현, 버그 수정, 또는 동작 변경 시

context-engineering
적절한 정보를 적절한 시점에 에이전트에 제공 - rules 파일, 컨텍스트 패킹, MCP 통합
세션 시작, 작업 전환, 또는 출력 품질이 떨어질 때

source-driven-development
모든 프레임워크 결정을 공식 문서에 근거 - 검증, 출처 인용, 미검증 항목 표시
어떤 프레임워크나 라이브러리에 대해 권위 있고 출처가 인용된 코드를 원할 때

doubt-driven-development
진행 중인 모든 비자명한 결정에 대한 적대적 신선 컨텍스트 리뷰 - CLAIM → EXTRACT → DOUBT → RECONCILE → STOP, 선택적 사용자 승인 교차 모델 에스컬레이션 포함
판돈이 높거나(프로덕션, 보안, 되돌릴 수 없음), 익숙하지 않은 코드에서 작업하거나, 자신 있는 출력을 지금 검증하는 것이 나중에 디버깅하는 것보다 저렴할 때

frontend-ui-engineering
컴포넌트 아키텍처, 디자인 시스템, 상태 관리, 반응형 디자인, WCAG 2.1 AA 접근성
사용자 대면 인터페이스를 구축하거나 수정할 때

api-and-interface-design
계약 우선 설계, Hyrum의 법칙, One-Version Rule, 오류 의미론, 경계 검증
API, 모듈 경계, 또는 공개 인터페이스를 설계할 때

Verify - 작동함을 증명

Skill
What It Does
Use When

browser-testing-with-devtools
라이브 런타임 데이터를 위한 Chrome DevTools MCP - DOM 검사, 콘솔 로그, 네트워크 트레이스, 성능 프로파일링
브라우저에서 실행되는 무엇이든 구축하거나 디버깅할 때

debugging-and-error-recovery
5단계 트리아지: 재현, 국소화, 축소, 수정, 보호. Stop-the-line 규칙, 안전한 폴백
테스트가 실패하거나, 빌드가 깨지거나, 동작이 예상과 다를 때

Review - 머지 전 품질 게이트

Skill
What It Does
Use When

code-review-and-quality
5축 리뷰, 변경 크기(~100줄), 심각도 라벨(Nit/Optional/FYI), 리뷰 속도 규범, 분할 전략
어떤 변경이든 머지하기 전

code-simplification
Chesterton's Fence, Rule of 500, 정확한 동작을 보존하면서 복잡성 감소
코드는 작동하지만 읽거나 유지하기가 필요 이상으로 어려울 때

security-and-hardening
OWASP Top 10 예방, 인증 패턴, 시크릿 관리, 의존성 감사, 3계층 경계 시스템
사용자 입력, 인증, 데이터 저장, 또는 외부 통합을 다룰 때

performance-optimization
측정 우선 접근 - Core Web Vitals 목표, 프로파일링 워크플로, 번들 분석, 안티패턴 탐지
성능 요구사항이 있거나 회귀가 의심될 때

Ship - 자신 있게 배포

Skill
What It Does
Use When

git-workflow-and-versioning
트렁크 기반…