AI가 코드를 잘 짜는 것과, 일을 잘하는 것은 다르다
AI 코딩 도구를 써본 사람은 안다 — 코드 조각은 잘 만드는데, 일하는 방식이 아쉽다. 테스트 없이 완료를 선언하고, 디버깅은 증상만 땜질하고, 계획 없이 큰 작업에 뛰어든다. 이 간극을 메우는 것이 개발 워크플로우 스킬이다. 좋은 개발자의 작업 습관을 지시문으로 만들어, AI가 그 습관대로 일하게 강제하는 것이다.
이 글은 유명 스킬 도감 ①(문서·업무 자동화 편)의 후편으로, GitHub에서 별을 많이 받은 저장소들에 수록된 개발·워크플로우 스킬 50개를 정리했다. 저장소 지도와 설치 방법은 ①편에서 다뤘으므로, 여기서는 목록에 집중한다.
선정 기준은 ①편과 같다 — 별 많은 저장소에 수록되어 관리되고 있을 것. 같은 기능의 스킬이 컬렉션마다 다른 이름으로 존재하는 경우가 많아, 일부는 대표 명칭으로 적었다.
50선 ②: 개발·워크플로우 편
A. 공식 개발 스킬 — 3개
Anthropic이 직접 공개한 개발용 스킬. ①편의 문서 스킬들과 같은 저장소에 있다.
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 1 | mcp-builder | MCP 서버(외부 서비스 연결 모듈)를 규격에 맞게 제작 | anthropics/skills |
| 2 | webapp-testing | 웹앱을 실제로 띄워 화면·동작을 검증 | anthropics/skills |
| 3 | artifacts-builder | 인터랙티브 웹 결과물(아티팩트) 제작 품질 향상 | anthropics/skills |
B. 작업 방법론 스킬 (superpowers) — 11개
이 컬렉션의 발상이 재미있다. 특정 기술이 아니라 숙련 개발자의 작업 원칙을 스킬로 만들었다. “코드를 어떻게 짜는가”가 아니라 “일을 어떤 순서와 기준으로 하는가”를 가르친다.
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 4 | test-driven-development | 구현 전에 실패하는 테스트부터 쓰게 강제 | obra/superpowers |
| 5 | systematic-debugging | 증상 땜질 대신 단계적 근본 원인 추적 | obra/superpowers |
| 6 | root-cause-tracing | 오류를 발생 지점까지 역추적 | obra/superpowers |
| 7 | verification-before-completion | ”완료” 선언 전에 실제 동작 검증을 강제 | obra/superpowers |
| 8 | requesting-code-review | 리뷰 요청 전 자가 점검 목록 수행 | obra/superpowers |
| 9 | receiving-code-review | 리뷰 피드백을 방어 없이 반영하는 절차 | obra/superpowers |
| 10 | using-git-worktrees | Git 워크트리로 작업 공간을 분리해 병렬 작업 | obra/superpowers |
| 11 | subagent-driven-development | 하위 에이전트에게 작업을 나눠 맡기는 분업 | obra/superpowers |
| 12 | dispatching-parallel-agents | 독립 작업을 병렬 에이전트로 동시 처리 | obra/superpowers |
| 13 | condition-based-waiting | 무작정 대기 대신 조건 충족을 확인하며 대기 | obra/superpowers |
| 14 | defense-in-depth | 한 겹 검증이 아닌 다층 검증 습관 | obra/superpowers |
C. 공식 벤더 스킬 — 11개
서비스 운영사가 직접 만든 스킬들. “그 서비스를 가장 잘 아는 팀”이 만들었다는 것이 강점이고, VoltAgent 컬렉션이 이 계열을 모아두었다.
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 15 | Vercel 배포 스킬 | Next.js 프로젝트 규칙 준수·배포 워크플로우 | Vercel 공식 (VoltAgent 수록) |
| 16 | Stripe 연동 스킬 | 결제 API 연동을 공식 패턴대로 구현 | Stripe 공식 (VoltAgent 수록) |
| 17 | Cloudflare Workers 스킬 | Workers(서버 없이 돌아가는 함수) 개발·배포 규칙 | Cloudflare 공식 (VoltAgent 수록) |
| 18 | Netlify 배포 스킬 | 사이트 빌드·배포 설정 | Netlify 공식 (VoltAgent 수록) |
| 19 | Sentry 오류 분석 스킬 | 수집된 오류를 진단하고 수정 제안 | Sentry 공식 (VoltAgent 수록) |
| 20 | Expo 모바일 스킬 | React Native 앱 개발·빌드 규칙 | Expo 공식 (VoltAgent 수록) |
| 21 | Hugging Face 스킬 | 모델·데이터셋 검색과 활용 | Hugging Face 공식 (VoltAgent 수록) |
| 22 | Figma 스킬 | 디자인 파일을 읽어 코드로 변환 | Figma 공식 (VoltAgent 수록) |
| 23 | Google Stitch 스킬 | 디자인-투-코드 워크플로우 연결 | Google Labs (VoltAgent 수록) |
| 24 | DuckDB 스킬 | 파일 기반 데이터 쿼리·분석·문서 검색 | DuckDB 공식 (VoltAgent 수록) |
| 25 | Trail of Bits 보안 스킬 | 보안 전문 기업의 코드 감사 절차 적용 | Trail of Bits 공식 (VoltAgent 수록) |
D. 코드 품질·리뷰 — 8개
커뮤니티 컬렉션(rohitg00 툴킷, VoltAgent 등)에서 공통적으로 발견되는 정석 스킬 유형이다. 이름은 컬렉션마다 다르지만 기능은 수렴한다.
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 26 | code-review | 체크리스트 기반 코드 리뷰 수행 | 커뮤니티 컬렉션 공통 |
| 27 | refactoring | 안티패턴 탐지와 단계적 리팩터링 | 커뮤니티 컬렉션 공통 |
| 28 | conventional-commits | 커밋 메시지를 규약(타입·범위·요약)대로 작성 | 커뮤니티 컬렉션 공통 |
| 29 | changelog-generator | 커밋 이력에서 변경 로그 자동 생성 | 커뮤니티 컬렉션 공통 |
| 30 | readme-generator | 프로젝트 구조를 읽고 README 초안 작성 | 커뮤니티 컬렉션 공통 |
| 31 | api-documentation | 코드에서 API 문서 생성·갱신 | 커뮤니티 컬렉션 공통 |
| 32 | unit-test-writer | 기존 코드에 단위 테스트 보강 | 커뮤니티 컬렉션 공통 |
| 33 | debugging-checklist | 오류 유형별 진단 절차 체크리스트 | 커뮤니티 컬렉션 공통 |
E. 웹·프론트엔드 — 6개
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 34 | frontend-design | 완성도 높은 UI 산출물 제작 가이드 | 커뮤니티 컬렉션 공통 |
| 35 | react-best-practices | React 컴포넌트 설계 규칙 적용 | 커뮤니티 컬렉션 공통 |
| 36 | nextjs-patterns | Next.js 라우팅·렌더링 패턴 준수 | 커뮤니티 컬렉션 공통 |
| 37 | tailwind-styling | Tailwind CSS 유틸리티 규칙 기반 스타일링 | 커뮤니티 컬렉션 공통 |
| 38 | e2e-testing | Playwright 등으로 사용자 시나리오 자동 테스트 | 커뮤니티 컬렉션 공통 |
| 39 | accessibility-check | 웹 접근성(스크린리더·키보드 탐색) 점검 | 커뮤니티 컬렉션 공통 |
F. 데이터·인프라 — 6개
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 40 | sql-optimization | 느린 쿼리 진단·인덱스 제안 | 커뮤니티 컬렉션 공통 |
| 41 | database-migration | 스키마 변경을 안전한 마이그레이션으로 작성 | 커뮤니티 컬렉션 공통 |
| 42 | docker-setup | 컨테이너 설정(Dockerfile·compose) 작성 | 커뮤니티 컬렉션 공통 |
| 43 | kubernetes-manifests | 쿠버네티스 배포 설정 작성·점검 | 커뮤니티 컬렉션 공통 |
| 44 | terraform-iac | 인프라를 코드로 정의(IaC)하는 규칙 적용 | 커뮤니티 컬렉션 공통 |
| 45 | ci-cd-pipeline | GitHub Actions 등 자동 빌드·배포 파이프라인 구성 | 커뮤니티 컬렉션 공통 |
G. 보안 — 5개
| # | 스킬 | 하는 일 | 출처 |
|---|---|---|---|
| 46 | ffuf-web-fuzzing | 웹 퍼저 ffuf를 연동해 취약점 탐색·결과 분석 | ComposioHQ/awesome-claude-skills |
| 47 | security-review | 코드의 보안 취약점(주입·인증 결함 등) 점검 | 커뮤니티 컬렉션 공통 |
| 48 | dependency-audit | 의존 패키지의 알려진 취약점 점검 | 커뮤니티 컬렉션 공통 |
| 49 | secret-scanning | 코드에 노출된 API 키·비밀번호 탐지 | 커뮤니티 컬렉션 공통 |
| 50 | GitHub Automation | 이슈·PR·저장소 작업 자동화 | ComposioHQ/awesome-claude-skills |
어디부터 시작할까: 추천 조합
50개를 다 깔면 안 된다는 것은 ①편에서 말했다. 개발용으로 시작한다면 이 조합을 권한다.
- 최소 조합 (3개): verification-before-completion + systematic-debugging + conventional-commits. “완료 검증, 제대로 된 디버깅, 읽을 수 있는 커밋”만으로 작업 품질이 눈에 띄게 달라진다
- 팀 작업 조합 (+2개): requesting-code-review + changelog-generator
- 내 스택 공식 스킬 1개: 쓰는 서비스(Vercel·Stripe·Cloudflare 등)의 공식 스킬이 있다면 그것부터. 문서를 뒤지는 시간이 크게 줄어든다
주의할 점도 있다. 방법론 스킬은 작업 속도를 늦춘다. 테스트 먼저, 계획 먼저, 검증 먼저 — 전부 단계를 추가하는 스킬이다. 일회성 실험이나 간단한 스크립트 작업에는 과하다. 빠른 실험용 폴더에서는 끄고, 오래 유지할 프로젝트에서 켜는 식의 구분을 권한다.
흔한 실수
- 보안 스킬을 허가 없는 대상에 사용 — ffuf 같은 취약점 탐색 도구는 내가 소유하거나 테스트 허가를 받은 시스템에만 쓴다. 남의 서비스에 돌리는 것은 불법이다
- 방법론 스킬끼리 충돌 — “계획 먼저” 스킬과 “즉시 실행” 성격의 지시가 섞이면 AI가 혼란스러워한다. 방법론 계열은 한 철학의 컬렉션으로 통일하는 것이 낫다
- 벤더 스킬의 버전 불일치 — 공식 스킬도 서비스 업데이트보다 늦을 수 있다. 스킬이 시키는 패턴이 최신 문서와 다르면 공식 문서를 우선하자
- “커뮤니티 공통” 스킬의 품질 편차 — D–F 카테고리의 유형들은 컬렉션마다 완성도 차이가 크다. 별 수와 최근 커밋 날짜, SKILL.md의 구체성을 보고 고르자
체크리스트
- 방법론 스킬과 기술 스킬의 차이를 설명할 수 있다
- 최소 조합 3개 중 필요한 것을 골라 설치해봤다
- 내 기술 스택의 공식 벤더 스킬이 있는지 확인했다
- 보안 스킬의 사용 범위(허가받은 대상만)를 이해했다
- 빠른 실험과 유지 프로젝트에서 스킬 적용을 구분한다
이것으로 유명 스킬 도감 2부작이 끝났다. ①편(문서·업무 자동화)과 ②편(개발·워크플로우)의 100개 중 지금 내 반복 작업에 닿는 것 3–5개부터 시작하자. 스킬을 직접 만드는 법이 궁금하다면 Skill 소개와 제작·활용으로 돌아가면 된다.