Claude Code Skills로 반복 업무를 팀 명령어로 바꾸는 법 | DAKER 커뮤니티
Claude Code Skills는 팀이 반복해서 쓰는 프롬프트와 절차를 SKILL.md로 패키징해 재사용하는 방식이다. 2026년 7월 6일 기준 공식 문서에서는 기존 custom commands가 Skills 흐름으로 통합되어, 반복 리뷰·배포·점검 절차를 slash command처럼 실행할 수 있다고 설명한다. 오늘은 긴 프롬프트를 매번 붙여 넣는 대신 팀 표준 명령어로 바꾸는 실무 절차를 정리한다.
한 줄 요약: Claude Code Skills는 “반복 설명”을 “검증 가능한 팀 명령어”로 바꾸는 가장 작은 운영 단위다.
반복 프롬프트를 SKILL.md와 slash command로 바꾸는 흐름
반복 업무 찾기부터 팀 명령어 검증까지의 5단계
Claude Code Skills는 언제 쓰면 좋을까?
Skills는 같은 지시문, 체크리스트, 다단계 절차를 계속 붙여 넣을 때 효과적이다. 공식 문서는 Skills를 Claude Code의 기능 확장 방식으로 설명하며, 관련 상황에서 자동으로 쓰이거나 사용자가 slash command로 직접 호출할 수 있다고 안내한다. 다만 Skills는 맥락과 절차를 제공하는 방식이므로, 반드시 막아야 하는 위험 행동은 Hooks 같은 실행 가드레일과 함께 설계해야 한다.
문제 상황: 프롬프트가 길어질수록 팀 표준은 흐려진다
코드 리뷰를 맡길 때마다 “보안도 보고, 테스트도 보고, 변경 범위도 요약해줘”라고 길게 설명하고 있다면 이미 Skills 후보가 생긴 것이다. 개인이 잘 쓰는 프롬프트는 빠르게 좋아지지만, 팀원이 같은 품질로 재현하기 어렵다. 특히 PR 리뷰, 릴리스 점검, 장애 회고, 마이그레이션 조사처럼 입력과 산출물이 반복되는 업무는 파일로 고정해야 한다.
핵심 개념: SKILL.md는 절차, 예시, 검증 기준을 함께 담는다
Skills의 중심은 SKILL.md 파일이다. 이 파일에는 언제 이 Skill을 써야 하는지, 어떤 입력을 받아야 하는지, 어떤 순서로 판단해야 하는지, 마지막에 무엇을 검증해야 하는지를 적는다. 기존 .claude/commands 파일도 계속 동작하지만, 새로 팀 표준을 만들 때는 Skills 구조로 정리하면 절차와 관련 자료를 한 폴더에 모으기 쉽다.
단계별 사용법: 반복 업무를 Skill로 바꾸는 순서는?
최근 2주 동안 세 번 이상 반복한 프롬프트를 고른다.
그 프롬프트의 목적, 입력값, 금지사항, 완료 조건을 분리한다.
.claude/skills/업무명/SKILL.md 형태로 절차를 작성한다.
팀원이 바로 부를 수 있도록 /review-pr, /release-check처럼 이름을 짧게 잡는다.
작은 PR이나 샘플 이슈에서 실행하고, 누락된 판단 기준을 SKILL.md에 다시 반영한다.
짧은 예시: PR 리뷰 Skill은 이렇게 시작한다
예를 들어 /review-pr Skill은 “변경 목적을 먼저 요약하고, 위험도 높은 파일을 우선 읽고, 테스트 누락과 보안 위험을 findings-first 형식으로 보고한다”처럼 시작할 수 있다. 여기서 중요한 점은 멋진 문장이 아니라 재현성이다. 누가 실행해도 같은 순서로 읽고, 같은 기준으로 위험을 보고하고, 마지막에 테스트 근거를 남기게 만드는 것이 목표다.
팀 적용 체크리스트: Skill을 만들 때 무엇을 빼야 할까?
개인 취향 문장은 빼고, 팀이 합의한 완료 조건만 남긴다.
너무 긴 배경 설명은 CLAUDE.md가 아니라 별도 참고 파일로 분리한다.
실행하면 안 되는 명령은 Skill 문장만으로 막지 말고 Hooks나 권한 설정으로 막는다.
결과 형식을 고정한다. 리뷰라면 findings-first, 배포라면 검증 로그와 rollback 조건을 요구한다.
처음부터 완벽하게 만들지 말고, 실제 실패 사례가 생길 때마다 한 줄씩 개선한다.
관련 DAKER 글은 어디서 이어서 보면 좋을까?
처음 시작하는 독자는 Claude Code 상세 사용법 01: 설치와 첫 프로젝트 온보딩을 먼저 확인하면 좋다. 팀 규칙과 권한을 함께 묶고 싶다면 Claude Code 상세 사용법 48: 설정과 권한을 팀 규칙으로 고정하기도 같이 읽어보자. 여러 작업을 병렬로 나누는 방식이 궁금하다면 모바일 이어받기를 worktree로 안전하게 여는 법이 도움이 된다.
공식 출처 기준으로 확인한 내용은?
작성 기준일은 2026년 7월 6일이다. 확인한 공식 문서는 Anthropic Claude Code의 Skills, Memory, Common workflows 문서다. 공개 본문에는 워크스페이스 정책에 따라 외부 URL을 직접 노출하지 않았으며, 핵심 주장은 공식 문서의 기능 설명 범위 안에서만 정리했다.
자주 묻는 질문
CLAUDE.md와 Skills 중 무엇을 먼저 써야 하나요?
프로젝트 전체 규칙은 CLAUDE.md에 두고, 반복 실행 절차는 Skills로 분리하는 편이 관리하기 쉽다.
기존 custom commands는 바로 버려야 하나요?
아니다. 공식 문서는 기존 commands 파일이 계속 동작한다고 설명한다. 다만 새 절차는 Skills로 정리하는 편이 확장성이 좋다.
Skill 하나에 모든 팀 규칙을 넣어도 되나요?
권장하지 않는다. 리뷰, 배포, 장애 회고처럼 업무 단위로 나누면 호출과 수정이 쉬워진다.
Skills만 있으면 위험 명령을 막을 수 있나요?
Skills는 지시와 절차에 가깝다. 반드시 차단해야 하는 명령은 Hooks, 권한 설정, 샌드박스 정책으로 별도 통제해야 한다.
오늘 팀에서 가장 자주 반복하는 프롬프트 하나를 골라 SKILL.md 초안으로 바꿔보고, 다음 실행 결과를 기준으로 한 줄씩 다듬어보자.