클로드 코드 스킬, 왕초보도 이렇게 시작하면 됩니다
같은 지시를 매번 붙여넣고 있다면 스킬로 한 번 저장해 두면 됩니다. 폴더 위치, SKILL.md 쓰는 법, 테스트까지 세 단계로 정리했습니다.
스킬은 반복해서 시키는 일을 파일 하나로 저장해 두는 기능입니다. 한 번 만들어 두면 짧은 요청이나 /스킬이름 한 번으로 같은 절차가 실행됩니다.
이 대화에서 내가 두 번 이상 반복해서 요청한 일을 찾아 줘. 그중 하나를 골라 클로드 코드 스킬 초안(SKILL.md)으로 만들어 줘. - description은 「언제 쓰는지」를 한 문장으로 - 스킬 하나는 한 가지 일만 하게 - 파일 맨 첫 줄은 --- 로 시작 만든 뒤 어느 폴더에 두면 되는지도 알려 줘.
스킬은 클로드 코드가 특정 상황에서 자동으로, 혹은 내가 직접 불러서 실행하는 저장된 지시문입니다. 공식 문서의 표현을 빌리면 "같은 지시사항을 반복해서 붙여넣을 때, 또는 절차적인 작업이 많을 때" 쓰는 기능입니다.
왜 필요한가요
똑같은 요청을 매번 새로 설명하다 보면 시간이 낭비됩니다. "이렇게 정리해줘", "이 형식으로 커밋 메시지 써줘" 같은 요청을 반복한다면, 그 절차를 스킬로 한 번 저장해두는 게 낫습니다.
스킬로 만들어두면 다음부터는 클로드가 상황을 보고 알아서 실행하거나, /스킬이름으로 직접 부를 수 있습니다.
스킬 폴더 만들기
스킬은 폴더 하나입니다. 어디에 두느냐에 따라 쓰는 범위가 달라집니다.
# 모든 프로젝트에서 쓸 때
mkdir -p ~/.claude/skills/내스킬
# 이 프로젝트에서만 쓸 때
mkdir -p .claude/skills/내스킬SKILL.md 쓰기
폴더 안에 SKILL.md 파일을 만듭니다. 맨 위 ---로 감싼 부분(프런트매터)에 description을 적고, 그 아래에 마크다운으로 실제 지시사항을 씁니다.
---
description: 커밋 메시지를 우리 팀 형식으로 쓸 때
---
# 여기부터 지시사항
변경 내용을 한 줄로 요약하고, 무엇을 왜 바꿨는지 적는다.description이 가장 중요합니다. 클로드는 이 설명을 보고 언제 이 스킬을 자동으로 쓸지 판단하기 때문입니다.
자주 쓰는 프런트매터 항목은 네 가지입니다.
description: 스킬 설명. 자동 실행 여부를 여기서 판단합니다.disable-model-invocation: true: 자동 실행을 막고 직접 부를 때만 실행되게 합니다.allowed-tools: 미리 승인해 둘 도구(예: 특정 git 명령)를 지정합니다.argument-hint: 사용자에게 보여줄 입력 힌트입니다.
테스트하기
관련 상황에서 자연스럽게 요청해보거나, /스킬이름으로 직접 불러 제대로 동작하는지 확인합니다.
자주 하는 실수
저는 처음에 스킬 파일에 너무 많은 내용을 한 번에 넣으려고 했습니다. 이것저것 다 하는 스킬을 만들었더니, 정작 원하는 상황에서 클로드가 언제 이 스킬을 써야 할지 판단하지 못했습니다. description을 짧고 명확하게 쓰고, 스킬 하나가 하는 일을 좁게 잡으니 그제서야 제때 실행됐습니다.
프런트매터의 ---가 파일 맨 첫 줄이 아니면 메타데이터 자체가 무시됩니다. 빈 줄 하나 넣었다가 스킬이 작동하지 않아 한참 찾은 적이 있습니다.
자주 묻는 질문
스킬을 만들려면 코딩을 알아야 하나요?
아닙니다. SKILL.md는 마크다운으로 지시사항을 적는 파일이라 코딩 지식이 없어도 만들 수 있습니다. 명령어 실행이 필요한 부분만 예시를 보고 따라 적으면 됩니다.
스킬은 얼마나 길게 써도 되나요?
공식 문서는 500줄 이하로 유지할 것을 권합니다. 내용이 길어지면 별도 파일로 분리하고 SKILL.md에서 그 파일을 참조하는 방식이 낫습니다.
왕초보가 처음 만들 스킬로 뭐가 좋은가요?
지금 반복해서 복사·붙여넣기 하는 짧은 지시사항부터 시작하면 됩니다. 커밋 메시지 형식이나 변경 사항 요약처럼 매번 비슷하게 요청하는 것이 좋은 첫 스킬 후보입니다.
정리
스킬은 반복되는 지시사항을 파일 하나로 저장해두는 기능입니다. 처음엔 작고 명확한 스킬 하나부터 만들어보고, description을 짧고 정확하게 쓰는 데 신경 쓰면 됩니다.