addyosmani/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

명령어

개발 수명주기에 매핑되는 8개의 슬래시 명령어입니다. 각 명령어는 올바른 스킬을 자동으로 활성화합니다.

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

스킬은 또한 수행 중인 작업에 따라 자동으로 활성화됩니다. API 설계 시 api-and-interface-design 트리거, UI 구축 시 frontend-ui-engineering 트리거 등입니다.

빠른 시작

<details> <summary><b>Claude Code (권장)</b></summary>

마켓플레이스 설치:

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

SSH 오류? 마켓플레이스는 SSH를 통해 리포지토리를 복제합니다. GitHub에 SSH 키가 설정되어 있지 않으면 SSH 키 추가하거나 전체 HTTPS URL을 사용하여 HTTPS 복제를 강제하세요:

```bash

/plugin marketplace add https://github.com/addyosmani/agent-skills.git

/plugin install agent-skills@addy-agent-skills

```

로컬 / 개발:

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

</details>

<details> <summary><b>Cursor</b></summary>

SKILL.md를 .cursor/rules/에 복사하거나 전체 skills/ 디렉토리를 참조하세요. docs/cursor-setup.md를 참조하세요.

</details>

<details> <summary><b>Antigravity CLI</b></summary>

스킬, 서브에이전트, 슬래시 명령어를 위한 네이티브 플러그인으로 설치하세요. 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

</details>

<details> <summary><b>Gemini CLI</b></summary>

자동 검색을 위한 네이티브 스킬로 설치하거나 지속적 컨텍스트를 위해 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/

</details>

<details> <summary><b>Windsurf</b></summary>

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

</details>

<details> <summary><b>OpenCode</b></summary>

AGENTS.md와 skill 도구를 통해 에이전트 기반 스킬 실행을 사용합니다.

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

</details>

<details> <summary><b>GitHub Copilot</b></summary>

agents/의 에이전트 정의를 Copilot 페르소나로 사용하고 스킬 내용을 .github/copilot-instructions.md에 사용하세요. docs/copilot-setup.md를 참조하세요.

</details>

<details> <summary><b>Kiro IDE & CLI </b></summary> Kiro용 스킬은 ".kiro/skills/" 아래에 있으며 프로젝트 또는 글로벌 수준으로 저장할 수 있습니다. Kiro는 또한 Agents.md를 지원합니다. Kiro 문서 https://kiro.dev/docs/skills/ 를 참조하세요. </details>

<details> <summary><b>Codex / 기타 에이전트</b></summary>

스킬은 일반 Markdown입니다. 시스템 프롬프트나 명령 파일을 허용하는 모든 에이전트와 함께 작동합니다. docs/getting-started.md를 참조하세요.

</details>

전체 24개 스킬

위 명령어는 진입점입니다. 패키지에는 총 24개의 스킬이 포함되어 있습니다. 23개의 수명주기 스킬과 using-agent-skills 메타 스킬입니다. 각 스킬은 단계, 검증 게이트, 반합리화 테이블이 있는 구조화된 워크플로우입니다. 또한 모든 스킬을 직접 참조할 수 있습니다.

메타 - 적용되는 스킬 찾기

정의 - 구축할 내용 명확히 하기

계획 - 분할하기

구축 - 코드 작성

검증 - 작동 증명

검토 - 병합 전 품질 게이트

출시 - 확신을 가지고 배포

에이전트 페르소나

[...생략...]