# agent-skills: AI 코딩 에이전트를 시니어 엔지니어로 만드는 19개 오픈소스 스킬


# agent-skills: AI 코딩 에이전트를 시니어 엔지니어로 만드는 19개 오픈소스 스킬

> AI 코딩 에이전트는 기본적으로 최단 경로를 택합니다. 스펙, 테스트, 보안 리뷰를 건너뛰죠. agent-skills는 시니어 엔지니어가 프로덕션 코드에 적용하는 규율을 구조화된 워크플로우로 강제하는 오픈소스입니다.

Google Chrome DevRel 출신이자 현재 Anthropic에서 일하는 **Addy Osmani**가 만든 [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)는 AI 코딩 에이전트(Claude Code, Cursor, Gemini CLI, Copilot)가 시니어 엔지니어의 워크플로우를 따르도록 만든 프로덕션급 엔지니어링 스킬 19종입니다. 2026년 4월 기준 GitHub 스타 8,600개 이상을 기록하고 있습니다.

## 6단계 개발 라이프사이클

19개 스킬이 소프트웨어 개발의 전체 생명주기에 매핑됩니다.

```
DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
```

- **DEFINE**: idea-refine, spec-driven-development
- **PLAN**: planning-and-task-breakdown
- **BUILD**: incremental-implementation, TDD, context-engineering, frontend-ui, API design
- **VERIFY**: browser-testing, debugging-and-error-recovery
- **REVIEW**: code-review, code-simplification, security, performance
- **SHIP**: git-workflow, CI/CD, deprecation, documentation, shipping

## 핵심 설계 원칙

### 프로세스, 프로즈 아님

각 스킬은 참조 문서가 아니라 에이전트가 실제로 따르는 워크플로우입니다. 이전 단계의 산출물 없이는 다음 단계로 넘어갈 수 없습니다.

### 반합리화 (Anti-rationalization)

"나중에 테스트 추가할게요" 같은 변명을 사전 차단합니다. 각 스킬에 반론 테이블이 내장되어 있어서 AI 에이전트가 프로세스를 건너뛰려 할 때 근거를 제시합니다.

### 검증 비타협

모든 스킬이 증거 요구사항으로 끝납니다. "맞는 것 같다"는 통과 기준이 아닙니다. 테스트 결과, 벤치마크, 보안 스캔 리포트가 필요합니다.

### 점진적 공개

SKILL.md가 진입점이고, 세부 참조는 필요할 때만 로드합니다. AI 에이전트의 컨텍스트 윈도우를 효율적으로 사용하기 위한 설계입니다.

## Google 엔지니어링 문화의 코드화

| Google 원칙 | agent-skills 적용 |
|------------|-------------------|
| Hyrum's Law | API 설계 스킬에서 하위 호환성 강제 |
| Beyonce Rule | TDD 스킬에서 테스트 커버리지 요구 |
| Chesterton's Fence | 코드 단순화에서 삭제 전 이유 확인 |
| 트렁크 기반 개발 | Git 워크플로우에서 피처 브랜치 규칙 |

## 포함 내역

- **19개 스킬**: 전체 개발 라이프사이클 커버
- **7개 슬래시 커맨드**: /spec, /plan, /build, /test, /review, /code-simplify, /ship
- **3개 에이전트 페르소나**: code-reviewer, test-engineer, security-auditor
- **4개 체크리스트**: testing, security, performance, accessibility

## 설치 방법

Claude Code:
```bash
/plugin marketplace add addyosmani/agent-skills
```

Cursor: SKILL.md를 `.cursor/rules/`에 복사

Gemini CLI:
```bash
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
```

## 결론

AI 코딩 에이전트는 도구입니다. 시니어 엔지니어의 규율 없이 사용하면 기술 부채만 쌓입니다. agent-skills는 그 규율을 구조화한 오픈소스로, 누구나 무료로 사용할 수 있습니다.

**GitHub:** [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) (MIT License, 8,600+ stars)

## 참고 자료

- [agent-skills GitHub](https://github.com/addyosmani/agent-skills)
- [Addy Osmani - My LLM Coding Workflow](https://addyosmani.com/blog/ai-coding-workflow/)
- [Addy Osmani LinkedIn](https://www.linkedin.com/posts/addyosmani_ai-softwareengineering-programming-activity-7446081634577309696-iT-5)