addyosmani/agent-skills

이것이 무엇인가

Agent Skills는 AI 코딩 어시스턴트(Claude Code, Cursor, Copilot, Codex, Gemini 등)에게 전문 소프트웨어 엔지니어링 관행을 따르는 방법을 가르치는 즉시 사용 가능한 워크플로(스킬이라고 함) 모음입니다. 각 스킬은 Markdown 파일로, 단계별 프로세스, 품질 게이트, 에이전트가 지름길을 택하지 못하게 하는 '반합리화' 테이블을 정의합니다.

왜 중요한가

AI 기반 코드 어시스턴트는 스니펫 작성에 능숙해지고 있지만, 여전히 시니어 엔지니어의 규율(스펙 작성, 작업을 작은 작업으로 분해, 테스트, 리뷰, 안전한 출시)이 부족합니다. 이러한 스킬을 에이전트에 연결하면 모든 모범 사례를 수동으로 상기시킬 필요 없이 일관된 프로덕션 등급 출력을 얻을 수 있습니다.

핵심 아이디어

수명 주기에 매핑된 슬래시 명령 – /spec, /plan, /build, /test, /review, /ship 등 – 각각 적절한 스킬 세트를 트리거합니다.
25개의 구체적인 스킬이 전체 개발 수명 주기를 다룹니다(아이디어 정제, 스펙 기반 개발, 테스트 기반 개발, 보안 강화, 성능 감사, CI/CD, 관찰 가능성 등).
페르소나 에이전트(코드 리뷰어, 테스트 엔지니어, 보안 감사자, 웹 성능 감사자)를 호출하여 전문가 피드백을 받을 수 있습니다.
휴대용 Markdown 형식 – 시스템 프롬프트나 지시 파일을 수용할 수 있는 모든 에이전트에서 작동합니다.
자동 모드 – /build auto는 계획을 만들고 승인된 한 번의 패스에서 모든 작업을 실행하지만 실패 시 일시 중지합니다.

시작 방법

전체 팩 설치는 일반 skills CLI를 사용합니다(70개 이상의 에이전트에서 작동):
```
npx skills add addyosmani/agent-skills   # 25개 스킬 모두 설치
```

또는 단일 스킬을 설치합니다. 예:

npx skills add addyosmani/agent-skills --skill test-driven-development

특정 에이전트의 경우 제공된 설정 블록(Claude Code, Cursor, Antigravity CLI, Gemini, Codex 등)을 따르세요. 대부분은 리포지토리를 클론하고 에이전트의 플러그인/스킬 디렉토리를 skills/ 폴더로 지정합니다.
에이전트의 채팅 UI에서 슬래시 명령(/spec, /plan, /build, …)을 사용하여 워크플로를 실행합니다.

누가 사용할까

엔지니어링 팀: AI 어시스턴트가 기존 코드 리뷰, 테스트, 배포 표준을 존중하도록 하려는 팀.
도구 빌더: Claude, Cursor, Copilot 등의 플러그인을 만들고 엔지니어링 모범 사례 프롬프트의 기성 라이브러리가 필요한 사람.
개인 개발자: 품질이나 보안을 희생하지 않고 AI 도움을 받을 구조화된 방법을 찾는 사람.

제한 사항 / 미해결 문제

단일 스킬을 설치하면 해당 skills/<name>/ 폴더만 복사됩니다. references/의 공유 체크리스트는 누락됩니다. 이 이식성 격차는 issue #361에서 추적됩니다.
일부 에이전트는 추가 구성이 필요합니다(예: Claude 마켓플레이스용 SSH 키, Cursor 또는 Kiro의 특정 폴더 규칙).
리포지토리는 워크플로를 제공하지만 호스트 에이전트가 이를 강제하는 데 의존합니다. 효과는 기본 모델의 준수에 달려 있습니다.

TL;DR: Agent Skills는 25개의 Markdown 정의 엔지니어링 워크플로를 번들로 제공하여 인기 있는 AI 코딩 에이전트에 연결하면 간단한 슬래시 명령으로 규율 있고 프로덕션 준비가 된 개발 프로세스를 제공합니다.