2026년 Claude Code는 「채팅되는 터미널」에서 편성 가능한 Agent 플랫폼으로 진화했습니다. 격차를 만드는 건 모델 버전보다 Skills를 제대로 깔았는지인 경우가 많습니다.
Skill은 AI용 「운영 매뉴얼」로 이해하면 됩니다. /grill-me 같은 Slash 명령을 입력하면 Claude가 매뉴얼 절차대로 움직입니다——요구사항을 먼저 맞추고, 테스트를 먼저 쓰고, 큰 요구를 작은 작업으로 나누는 절차입니다.
문제는 skills.sh에 이미 수천 개의 Skill이 있고 이름은 영어가 많다는 점입니다. 본문은 각 Skill이 무엇을 하는지·설치할지부터 정리하고 한 번에 설치할 명령을 붙입니다. mattpocock 단일 패키지 설계를 깊이 보고 싶다면 당사 《mattpocock/skills가 AI 코딩 협업을 재정의》와 함께 읽어보세요.
아래 각 Skill마다 복붙용 npx skills add ... 명령을 붙였습니다. skills.sh 카드와 동일하므로 터미널에 그대로 붙이면 됩니다.
1. Skills란 무엇인가, Rules와 차이
한 줄로: Skill은 「필요할 때 호출하는 워크플로」, Rules는 「항상 적용되는 프로젝트 규칙」입니다.
비유하면 Rules는 회사 근무 규정, Skill은 「요구 문서 쓰기」「테스트 돌리기」「Code Review」 각 SOP——필요할 때만 펼칩니다. 기술적으로 각 Skill은 폴더이고 안의 SKILL.md가 절차를 정의하며 /스킬명으로 실행합니다.
| 메커니즘 | 쉬운 이해 | 언제 쓰이나 |
|---|---|---|
| Rules / CLAUDE.md | 프로젝트 「가사」: 코드 스타일, 디렉터리, 금지 사항 | 거의 매 대화에 포함 |
| Skills | 재사용 「업무 절차」: 요구 정렬, 테스트, 작업 분할 | /xxx 입력 또는 Claude가 필요 판단 시 |
| Claude Code 내장 | 공식 기본: 코드 리뷰, 디버그 루프 | /code-review, /debug 등 |
실무 배치: Rules로 하한선, Skills로 절차. Rule에 「force push 금지」, Skill /git-guardrails-claude-code는 위험한 Git 명령 직전에 브레이크를 겁니다.
2. 한 번에 설치: 명령 복사만 하면 됨
Skill을 수동 다운로드할 필요 없습니다. 커뮤니티 표준 skills CLI(npx skills)가 GitHub 패키지를 Claude Code 디렉터리에 동기화합니다(Cursor, Codex도 지원).
skills.sh 각 카드에 복사 가능한 npx skills add ...가 있습니다——본문 명령도 공식과 동일합니다.
2.1 기본 형식
# 단일 Skill(전역 + 확인 스킵 + Claude Code 지정)
npx skills add owner/repo@skill-name -g -y -a claude-code
# 패키지 전체(대화형 선택 또는 --all)
npx skills add owner/repo -g -y -a claude-code
# 현재 프로젝트만(.claude/skills/ Git 공유)
npx skills add owner/repo@skill-name -y -a claude-code2.2 주요 옵션
| 옵션 | 의미 |
|---|---|
-g, --global | ~/.claude/skills/에 설치. 모든 프로젝트 사용 |
-y, --yes | 확인 건너뛰기. 스크립트 일괄 설치에 적합 |
-a claude-code | Claude Code만(cursor, codex도 지정 가능) |
-s skill-name | 대형 패키지에서 특정 Skill만 |
--copy | symlink 대신 복사(환경에 따라 필요) |
3. 0층: 메타 Skill(먼저 이 둘)
코드를 쓰는 게 아니라 Skill을 찾고 만드는 층입니다. 먼저 깔아 두면 이후 본문을 덜 찾아봅니다.
find-skills —— Skills 앱 스토어
무엇을 하나: Claude Code 대화 안에서 skills.sh Skill을 검색·설치. 「스토어 보고 명령 복사」를 터미널 안으로.
언제 쓰나: 「보안 감사」「SEO」「DB」류를 깔고 싶은데 저장소 이름을 모를 때. 몇 달마다 새 Skill 업데이트에도.
한 번에 설치: 아래를 터미널에 복사(skills.sh 공식과 동일).
npx skills add vercel-labs/skills@find-skills -g -y -a claude-codeskill-creator —— 자체 Skill 뼈대
무엇을 하나: Anthropic 공식 형식으로 팀 전용 Skill을 처음부터 작성(배포 절차, Review 체크리스트 등). 팀 내부만 또는 GitHub 공개.
언제 쓰나: 매주 Claude에게 같은 설명을 반복해 /our-deploy 같은 명령으로 고정하고 싶을 때.
한 번에 설치: 아래를 터미널에 복사.
npx skills add anthropics/skills@skill-creator -g -y -a claude-code4. 1층: 엔지니어링 규율(mattpocock/skills)
mattpocock/skills는 GitHub Star 10만급 패키지. Matt Pocock(Total TypeScript)이 일상 쓰던 절차를 공개한 것입니다. AI의 「듣지 않고 코딩」「테스트 없음」「파일 수십 개 일괄 수정」을 막는 게 핵심입니다.
서드파티 패키지 하나만 고른다면 여기. 아래는 「요구→구현」 순으로 각 Skill 소개——용도를 이해한 뒤 단독 설치를 고르세요.
패키지 일괄 설치
일괄 설치: 아래 복사. 완료 후 반드시 /setup-matt-pocock-skills로 저장소 설정.
npx skills add mattpocock/skills -g -y -a claude-code설치 후 저장소 루트에서 /setup-matt-pocock-skills를 반드시 실행. GitHub/Linear 중 Issue 관리 방식, 팀 용어 위치, 문서 디렉터리를 알려줍니다. 안 하면 Issue 분해가 팀 습관과 어긋납니다.
4.1 요구 정렬 —— 코딩 전에 맞추기
| 명령 | 무엇을 하나 | 전형적 상황 |
|---|---|---|
/grill-me |
시니어 동료처럼 요구를 깊이 질문: 경계, 예외, 인수 기준. 코드는 바로 안 건드림. | 신기능·핵심 변경인데 요구가 한 줄일 때 |
/grill-with-docs |
질문하며 합의를 CONTEXT.md와 ADR에 기록. |
「우리는 이걸 XXX라고 부른다」를 기억시키고 싶을 때 |
/to-prd |
맞춘 내용을 PRD로 정리하고 GitHub Issue 자동 생성. | 기획/상사와 합의 후 팀 공유 문서가 필요할 때 |
/to-issues |
PRD를 독립 배포 가능한 작은 Issue로 분할(세로 슬라이스). | 일정·분담 또는 Issue 단위 AI 구현 시 |
4.2 구현과 품질 —— 검증 가능한 변경
| 명령 | 무엇을 하나 | 전형적 상황 |
|---|---|---|
/tdd |
실패 테스트 → 최소 구현 → 리팩터. 수백 줄 한 번에 쓰고 안 돌아가는 걸 방지. | 비즈니스 로직, 버그 수정, 단위 테스트 가능 모듈 |
/diagnose |
재현 → 범위 축소 → 가설 → 검증 → 수정 → 회귀 고정 절차. | 간헐 버그, 성능, 동시성 |
/improve-codebase-architecture |
모듈 경계 모호, 네이밍 불일치, 분리 누락을 스캔해 제안. | 릴리스 전, 격주 아키텍처 점검 |
/git-guardrails-claude-code |
Git 실행 전 force push, hard reset 등 차단. | 프로덕션 브랜치, AI가 main 망가뜨린 적 있는 팀 |
4.3 효율과 협업
| 명령 | 무엇을 하나 | 전형적 상황 |
|---|---|---|
/caveman |
극단적으로 짧게 응답. 장황함을 줄여 대략 75% token 절약. | 긴 세션, 비용 민감, 결과만 원할 때 |
/handoff |
대화·진행·미완료를 인수인계 문서로 압축. | 오늘 반, 내일 계속, Claude Code에서 Cursor로 전환 시 |
/setup-matt-pocock-skills |
최초 설정: Issue 플랫폼, 라벨, 문서 경로. 일괄 설치 후 필수. | mattpocock/skills 막 설치한 직후 |
일상 체인: 신기능은 /grill-with-docs로 정렬 → /to-issues로 분할 → 각 작업을 /tdd로 구현. 자세한 흐름은 당사 mattpocock 심층 글 참고.
단독 설치: 필요한 줄만 복사(skills.sh 카드와 동일 형식).
npx skills add mattpocock/skills@grill-me -g -y -a claude-code
npx skills add mattpocock/skills@tdd -g -y -a claude-code
npx skills add mattpocock/skills@to-issues -g -y -a claude-code5. 2층: 서브에이전트 편성(obra/superpowers)
obra/superpowers는 다른 문제를 다룹니다: 작업이 너무 커서 Agent 하나로는 엉킨다. 계획 → 서브에이전트 병렬 → 통합 검수——프로젝트 매니저형입니다.
역할 분담: mattpocock은 일상 코딩 규율, superpowers는 대형 요구 분할·병렬. 함께 써도 됩니다.
패키지 일괄
한 번에 설치: 아래 복사.
npx skills add obra/superpowers -g -y -a claude-code| 명령 | 무엇을 하나 | 전형적 상황 |
|---|---|---|
/brainstorming |
대형 요구를 안 도출·비교·리스크 확인 후 착수. 「관리자 페이지 만들어」로 즉시 코딩 방지. | 요구 모호, 기술 선택 다수, 다모듈 신규 |
/writing-plans |
선택안을 단계별 실행 계획으로: 각 단계 작업, 의존, 검수. | 방향 확정 후 추적 가능한 작업 목록이 필요할 때 |
/subagent-driven-development |
하위 작업을 여러 서브 Agent에 병렬(프론트, API, 테스트), 본체가 통합. | 변경 범위 넓고 모듈 독립, 총 시간 단축 원할 때 |
/test-driven-development |
mattpocock /tdd와 유사한 별도 TDD. 하나 고르거나 혼용 가능. |
테스트부터 구현 주도하고 싶을 때 |
/systematic-debugging |
증거 수집 → 가설 배제 → 근본 원인. 「한 줄 바꿔 보기」 루프 감소. | 복잡 버그, 운영 장애, 서비스 간 호출 |
/verification-before-completion |
「완료」 선언 전 테스트·체크리스트 필수. 성급한 완료 방지. | AI 자체 마무리를 못 믿는 모든 작업 |
/requesting-code-review |
동료용 Review 요청: 변경 내용, 이유, 집중 확인 지점. | PR 전, 사람 리뷰 전 AI 자가 점검 |
팀에 성숙한 Spec 플로가 있으면 일괄 불필요——/verification-before-completion만으로도 가치 큼.
6. 3층: 프론트와 디자인(Anthropic + Vercel)
AI UI는 「돌아가지만 제품 같지 않다」는 말이 많습니다. 이 층은 시각·인터랙션·프레임워크 사용을 제약해 출시에 가깝게 만듭니다.
6.1 Anthropic 공식
| Skill | 무엇을 하나 | 언제 설치 |
|---|---|---|
frontend-design |
색, 여백, 타이포, 컴포넌트 상태 등 UI 규범에 맞는 생성. | Web, LP, 관리자 화면에서 외관 중시할 때 |
webapp-testing |
버튼·폼·에러 등 실제 페이지를 눌러 검증. | UI 변경 후 스모크 테스트 자동화 |
pdf / docx / pptx / xlsx |
Office/PDF 읽기·쓰기: 보고서, 계약, 표보내기. | 문서·보고·발표가 많은 프로젝트 |
한 번에 설치: 아래 복사(Anthropic 공식 패키지).
npx skills add anthropics/skills@frontend-design -g -y -a claude-code
npx skills add anthropics/skills@webapp-testing -g -y -a claude-code
npx skills add anthropics/skills@pdf -g -y -a claude-code6.2 Vercel 계열: React / Next.js 올바른 작성법
| Skill | 무엇을 하나 | 언제 설치 |
|---|---|---|
vercel-react-best-practices |
컴포넌트 분리, 상태, 성능, App Router 등 Vercel식 베스트 프랙티스. | React/Next.js에서 구식 작성법을 피하고 싶을 때 |
web-design-guidelines |
접근성, 반응형, 대비, 피드백 규격 점검. | 출시 전 UI 자가 점검, 디자인 재현 검수 |
vercel-react-native-skills |
React Native/Expo 작성 제약과 흔한 함정. | 크로스플랫폼 App, Expo |
deploy-to-vercel |
환경 변수, 빌드, 도메인 등 Vercel 배포 절차. | Vercel 호스팅에서 AI에게 배포 맡기고 싶을 때 |
한 번에 설치: 아래 복사(Vercel 베스트 프랙티스).
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y -a claude-code
npx skills add vercel-labs/agent-skills@web-design-guidelines -g -y -a claude-code6.3 브라우저 자동화 —— 진짜 페이지를 열어 테스트
agent-browser와 playwright-cli로 Claude가 실제 브라우저 조작: 열기, 클릭, 스크린샷, 콘솔 에러. E2E나 「UI 고쳤으니 한번 눌러봐」에 적합.
한 번에 설치: 아래 복사(브라우저 자동화/E2E).
npx skills add vercel-labs/agent-browser -g -y -a claude-code
npx skills add microsoft/playwright-cli -g -y -a claude-codeshadcn/ui 사용 시 추가: npx skills add shadcn/ui@shadcn -g -y -a claude-code(복사 후 실행).
7. 4층: 기술 스택별
모두 필수는 아닙니다——쓰는 스택만 설치해 Slash 목록 비대화를 막으세요.
| 상황 | Skill | 무엇을 하나 |
|---|---|---|
| Supabase/Postgres 백엔드 | supabase-postgres-best-practices |
SQL, RLS, 인덱스, 마이그레이션을 Supabase 권장대로 |
| Firebase 풀스택 | firebase-basics 등 |
Auth, Hosting, Firestore 표준 연결 |
| Convex 실시간 | convex-quickstart |
schema, mutation, query, 배포 작성법 |
| 자체 로그인 | better-auth-best-practices |
better-auth Session, OAuth 베스트 프랙티스 |
| 스크래핑/데이터 수집 | firecrawl |
Firecrawl로 페이지 수집·파싱. RAG 지식 베이스에도 |
| 운영 에러 추적 | sentry-cli |
Sentry 설정, 에러 조회, release 연결 |
| 랜딩/SEO | seo-audit |
제목, meta, 구조 SEO 기본 점검 |
예시: 아래 복사(스택에 맞게 선택).
npx skills add supabase/agent-skills@supabase-postgres-best-practices -g -y -a claude-code
npx skills add firecrawl/cli@firecrawl -g -y -a claude-codeiOS 네이티브에서는 Claude Code가 Xcode를 대체하지 않습니다. 시스템 Agent 동향은 《WWDC26: Xcode 27 Agent와 iOS 개발 혁명》 참고, 빌드는 macOS에서 xcodebuild가 현실적입니다.
8. 추천 3종 세트(통째로 복사 실행)
하나씩 고르기 귀찮으면 역할별 3세트. 왜 이 조합인지도 한 줄씩.
8.1 개인 개발자 · 최소 세트
대상: 개인·소규모·Claude Code 입문.
의도:Skill 탐색 + 구현 전 정렬 + 테스트 주도 + 그럭저럭 보기 좋은 UI.
통째로 복사: 아래 일괄 붙여넣기 가능(skills.sh 단일 명령과 동일 형식).
npx skills add vercel-labs/skills@find-skills -g -y -a claude-code
npx skills add mattpocock/skills@grill-me -g -y -a claude-code
npx skills add mattpocock/skills@tdd -g -y -a claude-code
npx skills add mattpocock/skills@setup-matt-pocock-skills -g -y -a claude-code
npx skills add anthropics/skills@frontend-design -g -y -a claude-code8.2 풀스택 · 표준 세트
대상: 일상 React/Next.js, 중간 복잡도 작업.
의도:mattpocock 전반 + superpowers로 성급 완료 방지 + Vercel 프론트 규범 + 브라우저 테스트.
통째로 복사: 아래 일괄 붙여넣기 가능.
npx skills add vercel-labs/skills@find-skills -g -y -a claude-code
npx skills add mattpocock/skills -g -y -a claude-code
npx skills add obra/superpowers@brainstorming -g -y -a claude-code
npx skills add obra/superpowers@verification-before-completion -g -y -a claude-code
npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y -a claude-code
npx skills add vercel-labs/agent-skills@web-design-guidelines -g -y -a claude-code
npx skills add anthropics/skills@webapp-testing -g -y -a claude-code8.3 테크 리드 · 규율 + 편성 + 안전
대상: 팀 통일, Git 사고가 걱정되는 리드.
의도:엔지니어링 패키지 전체 + 대형 작업 편성 + Git 가드 + 팀 Skill 자작.
통째로 복사: 아래 일괄 붙여넣기 가능.
npx skills add mattpocock/skills -g -y -a claude-code
npx skills add obra/superpowers -g -y -a claude-code
npx skills add mattpocock/skills@git-guardrails-claude-code -g -y -a claude-code
npx skills add anthropics/skills@skill-creator -g -y -a claude-code
npx skills add mattpocock/skills@write-a-skill -g -y -a claude-codeCursor도 쓰면 -a claude-code를 -a claude-code,cursor로——한 번 붙여넣기로 두 도구에 기록.
9. 설치 후 확인
- 디렉터리: 전역 Skill이
~/.claude/skills/에 폴더와SKILL.md있는지. - Slash 자동완성: 새 세션에서
/입력 시grill-me,tdd등 보이는지. - 실제 작업 1건: 작은 브랜치에서
/grill-me실행, 바로 코드 수정이 아닌 질문이 오는지. - mattpocock 패키지:
/setup-matt-pocock-skills후 팀 합의 CONTEXT 경로 생성됐는지. - 공급망: GitHub 출처 추적 가능한 Skill만. 낯선 repo는 Star, 이력,
SKILL.md의 불명 스크립트 요구 확인.
Claude Code를 로컬 Ollama에 연결해 API를 아끼는 경우에도 Skills는 동일하게 적용——절차는 모델과 무관. 설정은 《Claude Code + Ollama 로컬 Agent 워크플로》 참고.
10. 반례: 전부 설치하지 않아도 되는 경우
- 50줄 이내 핫픽스: 인수 조건만 쓰면 충분.
/grill-me풀은 과함. - Spec-Kit 등이 이미 잘 돌아감:
/tdd,/diagnose등 단독만. 절차 중복 피하기. - CONTEXT.md 담당 없음: 문서 오너 정한 뒤
/grill-with-docs. - 50+ Skill 한꺼번에 설치 후 미사용: Slash 목록 오염, 잘못된 Skill 선택 위험 증가.
- 진짜 필요한 게 IM 봇/Cron: OpenClaw류 게이트웨이 Skill 우선. mattpocock 엔지니어링 패키지는 나중.
랭킹 설치 수는 「많은 사람이 시도함」이지 「오늘 당신 repo에 필수」는 아닙니다. 분기마다 find-skills나 skills.sh로 신규만 보면 충분합니다.
자주 묻는 질문 FAQ
Claude Code Skills와 Cursor Rules의 차이는?
Rules는 「가사」로 매 대화에 포함. Skills는 「절차」로 /명령으로 호출. Rule이 「테스트 필수」를 정하고 Skill /tdd가 실패 테스트→구현 단계를 이끕니다.
Skill 설치 후 Claude Code를 재시작해야 하나요?
npx skills add면 보통 즉시 반영. ~/.claude/skills/에 수동 복사했으면 세션을 다시 여는 게 확실합니다.
-g 옵션 유무의 차이는?
-g는 ~/.claude/skills/ 전역(모든 프로젝트). 없으면 .claude/skills/에 들어가 Git 공유에 적합.
가장 먼저 설치할 Skill 세 개는?
대부분 find-skills, grill-me(또는 grill-with-docs), tdd부터. 대형 요구에는 superpowers brainstorming, verification-before-completion 추가.
Skills는 Cursor에서도 쓸 수 있나요?
가능합니다. -a cursor 또는 -a claude-code,cursor로 같은 npx 한 줄이 두 도구에 기록됩니다.
Skill을 너무 많이 설치하면 Claude Code가 느려지나요?
메타데이터는 목록에 들어가지만 전문은 트리거 시에만 로드. 계층별로 나눠 설치하고 각 배치마다 실제 작업으로 검증하세요.
정리
2026 Claude Code 생태계에서 Skills는 「코드를 쓸 수 있다」를 「엔지니어링 규율에 맞게 쓴다」로 바꾸는 최소 비용 레버입니다. skills.sh로 설치는 npx skills add 한 줄. 본문은 메타 → 규율 → 편성 → 프론트 → 스택별 5층과 붙여 넣을 3세트를 정리했습니다.
- 거의 모두:
find-skills+ mattpocockgrill-me/tdd+setup-matt-pocock-skills. - 대형 요구 추가:obra/superpowers
brainstorming,subagent-driven-development,verification-before-completion. - UI 중시:
anthropics/skills@frontend-design+ Vercel React 베스트 프랙티스. - 정기 유지:
find-skills나 skills.sh 랭킹으로 업데이트. 미사용 Skill 일괄 쌓기는 피하기.
Skills는 협업 방식을 규격화합니다. 안정 macOS에서 iOS 빌드나 24×7 Agent가 필요하면 Macstripe 홈에서 전용 M4 Mac Mini를 확인하세요. 다른 AI 코딩 실천은 개발자 블로그 목록에서.
