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]
[Tool] Paseo · 내 컴퓨터에 데몬을 띄우고 데스크톱, 폰, 웹, 터미널 어디서든 접속해 코딩 에이전트를 굴리는 자체 호스팅 오케스트레이터. Claude Code를 비롯한 여러 CLI 에이전트를 손대지 않고 그대로 실행하며, 모바일 앱은 데스크톱과 같은 기능을 제공한다.
tool · claudekit.io / tools / paseo
[02]
[Tool] Orca · 여러 코딩 에이전트를 병렬로 굴리는 ADE(Agent Development Environment) 데스크톱 앱. 각 에이전트를 격리된 git worktree에서 동시에 실행하고, 결과를 나란히 비교해 원하는 것을 골라 머지한다. Claude Code, Codex, Grok 등 30여 개 CLI 에이전트를 자신의 구독으로 그대로 사용한다.
tool · claudekit.io / tools / orca
[03]
[Skill] Matt Pocock's Skills · Matt Pocock이 자기 .claude 디렉토리에서 실제로 쓰는 Claude Code 스킬 모음. 정렬(grilling), 스펙, TDD, 코드 리뷰, 버그 진단, 아키텍처 개선 등 실전 엔지니어링 워크플로를 20여 개 스킬로 묶었다. skills.sh로 편집 가능하게 설치하거나 플러그인으로 읽기 전용 설치한다.
tool · claudekit.io / tools / mattpocock-skills
§ 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 라이선스 오픈소스로 무료입니다.