핵심 요약 (Summary)
Skills는 Claude Code에서 반복적으로 사용하는 작업을 슬래시 커맨드(/skill-name)로 저장해두고 언제든 호출할 수 있는 커스텀 명령어 기능입니다.
마크다운 파일 하나가 곧 하나의 스킬이 되며, 파일 안에 작업 지침을 작성해두면 Claude가 그 지침에 따라 일관되게 동작합니다.
팀 공통 작업(코드 리뷰, 보안 검토, 배포 체크리스트 등)을 스킬로 만들어두면 누가 실행해도 같은 품질의 결과를 얻을 수 있습니다.
왜 필요한가요? (Why)
Claude Code를 사용하다 보면 같은 맥락의 지시를 반복하게 되는 경우가 많습니다.
"이 PR을 리뷰해줘. 우리 팀은 함수형 컴포넌트를 쓰고, 타입 단언(as)은 금지야. 테스트 커버리지도 확인해줘."
이런 지시를 매번 타이핑하는 것은 비효율적이고, 팀원마다 다르게 입력하면 결과물의 품질도 들쭉날쭉해집니다.
Skills는 이 문제를 해결합니다. 작업 지침을 한 번 정의해두면 /review처럼 짧은 명령어 하나로 동일한 품질의 작업을 반복 실행할 수 있습니다.
Skills는 어떻게 구성되나요?
스킬 파일은 마크다운(.md) 형식으로 작성됩니다.
저장 위치에 따라 적용 범위가 달라집니다.
| 저장 위치 | 적용 범위 |
|---|---|
~/.claude/commands/ | 모든 프로젝트에서 사용 가능한 개인 스킬 |
.claude/commands/ | 해당 프로젝트 안에서만 사용 가능한 팀 스킬 |
프로젝트 루트의 .claude/commands/에 저장한 스킬은 팀 레포지토리에 함께 커밋할 수 있어, 팀 전체가 동일한 스킬을 공유할 수 있습니다.
파일명이 곧 커맨드명입니다.
review.md 파일을 만들면 /review로 호출하고, security-check.md를 만들면 /security-check로 호출합니다.
어떤 상황에서 활용하면 좋나요?
Skills는 반복성과 일관성이 중요한 작업일수록 효과가 큽니다.
코드 리뷰 자동화
팀의 코딩 컨벤션, 금지 패턴, 성능 체크포인트를 스킬에 담아두면, 매 PR마다 동일한 기준으로 리뷰를 받을 수 있습니다. 리뷰어마다 다른 관점이 아닌, 팀이 합의한 기준이 매번 적용됩니다.
보안 검토
OWASP Top 10 기준이나 프로젝트 특유의 보안 규칙을 스킬로 정의해두면, 배포 전 보안 체크를 누락 없이 실행할 수 있습니다.
문서화 및 아티클 작성
이 매일매일 프로젝트처럼 콘텐츠 작성 규칙, 브랜드 가이드, 템플릿 구조를 스킬에 담아두면 작성할 때마다 맥락 파일을 직접 열어 읽지 않아도 됩니다. 스킬 안에 "이 파일들을 읽고 시작하라"는 지침을 넣어두면 Claude가 알아서 준비합니다.
배포 전 체크리스트
"배포 전에 이것들을 확인하라"는 지침을 스킬로 만들어두면, 사람마다 체크리스트를 기억하거나 찾아볼 필요 없이 /pre-deploy 한 번으로 동일한 절차를 밟을 수 있습니다.
반복되는 리팩토링 패턴
프로젝트에서 자주 발생하는 리팩토링 유형(예: 클래스 컴포넌트 → 함수형 컴포넌트 전환, API 호출 방식 통일)을 스킬로 정의해두면 일관된 방식으로 처리됩니다.
Skills의 핵심 장점
1. 맥락을 기억시킨다
Claude는 대화 세션이 끝나면 이전 맥락을 잊습니다. 하지만 스킬 파일 안에 "우리 프로젝트는 이런 구조이고, 이런 컨벤션을 따른다"는 내용을 담아두면, 매번 새로 설명하지 않아도 됩니다.
2. 팀 지식을 코드로 관리한다
구두로 전달되던 팀의 암묵적 규칙이 파일로 명문화됩니다. 신규 팀원도 스킬 파일을 읽으면 팀의 작업 방식을 파악할 수 있고, Git으로 변경 이력도 추적됩니다.
3. 재현 가능한 품질을 만든다
같은 스킬을 실행하면 누가, 언제 실행하더라도 동일한 기준이 적용됩니다. 사람의 컨디션이나 경험에 관계없이 일정 수준 이상의 결과를 보장합니다.
정리 (Conclusion)
Skills는 반복 작업을 슬래시 커맨드로 캡슐화해 팀의 작업 방식을 일관되게 유지하는 기능입니다. 마크다운 파일 하나로 만들 수 있고, 프로젝트 레포지토리에 커밋해 팀 전체가 공유할 수 있습니다. "이 작업을 항상 이렇게 해야 한다"는 규칙이 있다면, 스킬로 만들어두는 것이 가장 확실한 방법입니다.