claudekit / tools / agent-skills
[ Plugin · Development ]

Agent Skills

시니어 엔지니어가 소프트웨어를 만들 때 쓰는 워크플로, 품질 게이트, 모범 사례를 24개 스킬로 인코딩한 플러그인. Define, Plan, Build, Verify, Review, Ship의 수명주기 단계로 조직되어 있고, API를 설계하면 `api-and-interface-design`이 뜨는 식으로 작업 내용에 따라 자동 활성화됩니다. "Process, not prose" — 에이전트가 읽는 참고 문서가 아니라 따라야 하는 워크플로이며, 모든 스킬이 테스트 통과나 런타임 데이터 같은 증거 요구사항을 포함합니다.

addyosmani/agent-skills ·published ·updated
$ /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개 스킬이 개발 수명주기 단계로 조직되어 있습니다.

단계스킬 수예시
Define3interview-me, idea-refine, spec-driven-development
Plan1planning-and-task-breakdown
Build7test-driven-development, context-engineering, frontend-ui-engineering, api-and-interface-design
Verify2browser-testing-with-devtools, debugging-and-error-recovery
Review4code-review-and-quality, code-simplification, security-and-hardening, performance-optimization
Ship6git-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개

사용 방법

  1. 마켓플레이스를 추가하고 플러그인을 설치합니다 — /plugin marketplace add addyosmani/agent-skills && /plugin install agent-skills@addy-agent-skills
  2. 평소처럼 작업합니다 — 스킬은 작업 내용에 따라 자동 활성화됩니다. API를 설계하면 api-and-interface-design이, UI를 만들면 frontend-ui-engineering이 뜹니다.
  3. 단계를 직접 밟고 싶으면 슬래시 명령을 사용합니다 — /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만 실행하면 찾지 못합니다.
  • 증거 기반 검증 — 모든 스킬이 “통과하는 테스트”나 “런타임 데이터” 같은 증거 요구사항을 명시합니다. 에이전트가 “다 됐습니다”라고 말로만 보고하는 패턴을 막는 장치입니다.
§ 5

See also

same category · curated
[01]
[MCP] ARTEMIS · 자연어 지시를 Android 자동화로 바꾸는 오픈소스 에이전트. MCP 서버로 Claude Code에 연결하면 실기기나 에뮬레이터에서 앱을 조작해 테스트를 진행하고, 스크린샷과 Logcat 로그를 받아 옵니다. 기기 조작은 ARTEMIS가 자체 LLM으로 백그라운드에서 수행합니다.
tool · claudekit.io / tools / artemis
[02]
[Tool] Claude Quickstarts · Claude API로 배포 가능한 애플리케이션을 빠르게 만들기 위한 프로젝트 모음. 고객 지원 에이전트, 금융 데이터 분석, computer use, 브라우저 자동화, Claude Managed Agents 기반 Slack, Linear, Sentry 연동 앱까지 바로 실행할 수 있는 예제를 제공합니다. 일부 퀵스타트는 Claude Code가 설정 과정을 안내합니다.
tool · claudekit.io / tools / claude-quickstarts
[03]
[Tool] Worktrunk · AI 에이전트를 병렬로 돌리기 위한 git worktree 관리 CLI. 브랜치 이름만으로 worktree를 만들고, 전환하고, 정리하며, `wt switch -c -x claude feat` 한 줄로 새 worktree에서 Claude Code를 바로 실행합니다. Claude Code 플러그인을 설치하면 `wt list`에 세션 상태가 표시되고, 에이전트가 만드는 worktree도 Worktrunk 규칙을 따릅니다.
tool · claudekit.io / tools / worktrunk
§ 6

자주 묻는 질문

자주 묻는 질문
§ 6.1
Agent Skills는 무엇인가요?
시니어 엔지니어의 워크플로, 품질 게이트, 모범 사례를 24개 스킬로 인코딩한 플러그인입니다. Define, Plan, Build, Verify, Review, Ship의 개발 수명주기 단계로 조직되어 있고, 작업 내용에 따라 자동 활성화됩니다.
§ 6.2
어떤 환경에서 동작하나요?
Claude Code, Cursor, Antigravity CLI, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, Kiro를 지원하며, Markdown 지시 파일을 받는 일반 에이전트에도 적용할 수 있습니다. 도구별 설정 가이드가 docs/에 있습니다.
§ 6.3
어떻게 설치하나요?
Claude Code에서는 마켓플레이스를 추가한 뒤 설치합니다: `/plugin marketplace add addyosmani/agent-skills && /plugin install agent-skills@addy-agent-skills`. 로컬 개발용으로는 리포를 클론해 `claude --plugin-dir`로 지정합니다.
§ 6.4
스킬은 어떻게 발동되나요?
작업 내용에 따라 자동 활성화됩니다 — API를 설계하면 api-and-interface-design이, UI를 만들면 frontend-ui-engineering이 뜹니다. /spec, /plan, /build, /test, /review, /code-simplify, /ship 같은 슬래시 명령으로 직접 호출할 수도 있습니다.
§ 6.5
스킬 외에 무엇이 포함되나요?
specialist persona 에이전트 4개(code-reviewer, test-engineer, security-auditor, web-performance-auditor), 참고 체크리스트 4개(testing, security, performance, accessibility), 세션 수명주기 hooks가 함께 들어 있습니다.
§ 6.6
무료로 사용할 수 있나요?
MIT 라이선스 오픈소스로 무료입니다.