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] Ollaya · 결정 모델(decision model)을 로컬에서 내려받아 실행하는 도구. 문의, 이메일, 프롬프트 같은 입력을 받아 분류, 점수, 예/아니오 질문에 확률과 함께 밀리초 단위로 답합니다. MCP 서버와 에이전트 스킬을 함께 제공해 Claude Code가 빠른 판단을 로컬 모델에 맡길 수 있습니다.
tool · claudekit.io / tools / ollaya
[02]
[MCP] Mobile MCP · iOS, Android의 시뮬레이터, 에뮬레이터, 실기기를 AI 에이전트가 직접 조작하게 해주는 MCP 서버. 앱 화면의 접근성 트리를 읽어 탭, 스와이프, 입력, 앱 설치를 수행하며 기기 로그와 크래시 리포트도 가져옵니다.
tool · claudekit.io / tools / mobile-mcp
[03]
[Plugin] Ponytail · 에이전트가 코드를 쓰기 전에 7단계 사다리를 거치게 만드는 플러그인. 이게 꼭 있어야 하나, 코드베이스에 이미 있나, 표준 라이브러리로 되나를 차례로 확인해 먼저 걸리는 단계에서 멈춥니다. 검증, 오류 처리, 보안, 접근성은 줄이지 않습니다.
tool · claudekit.io / tools / ponytail
§ 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 라이선스 오픈소스로 무료입니다.