클로드 코드 스킬 적용 방법, 6줄짜리 파일 하나면 시작된다

이 글에서 알 수 있는 것
① 스킬이 명령어·CLAUDE.md와 뭐가 다른지 구분 기준
② 나만의 스킬을 만들어 호출하는 전 과정 (직접 해본 6줄 예제)
③ 남이 만든 스킬을 받아서 쓰는 법

클로드 코드 스킬은 자주 시키는 일을 파일 하나로 저장해 두고 명령처럼 불러 쓰는 기능이다. 적용 방법은 생각보다 단순해서, 정해진 폴더에 SKILL.md라는 파일을 만들면 그걸로 끝난다. 이 글에서는 6줄짜리 스킬을 실제로 만들어 호출까지 해보고, 남이 만든 스킬을 받아 쓰는 법까지 순서대로 정리한다.

스킬을 알기 전의 나는 같은 요청을 매번 길게 다시 쓰고 있었다. “블로그 글 올리기 전에 이것저것 확인해 줘”를 열 번쯤 반복하다가 스킬로 저장한 뒤로는 명령 한 번이면 같은 절차가 그대로 돌아간다. 반복 요청이 있는 사람일수록 스킬의 값어치가 크다.

스킬, 명령어, CLAUDE.md는 뭐가 다른가

셋 다 “클로드에게 미리 뭔가를 심어두는” 기능이라 처음엔 헷갈린다. 기준은 하나다. 언제 발동되느냐.

기능	정체	언제 발동
CLAUDE.md	항상 지켜야 할 규칙 메모	매 대화에 자동 적용
기본 명령어(/help 등)	프로그램에 내장된 기능	입력할 때
스킬	내가 저장해 둔 작업 절차	부르거나, 맞는 상황에 알아서

CLAUDE.md는 “말투는 이렇게, 이 폴더는 건드리지 마” 같은 상시 규칙에 맞고, 스킬은 “블로그 발행 전 점검”처럼 특정 순간에 실행하는 절차에 맞다. CLAUDE.md 활용은 클로드 코드 사용법에서 다뤘으니, 이 글은 스킬만 판다.

스킬의 좋은 점은 클로드가 설명을 읽고 맞는 상황에 스스로 꺼내 쓰기도 한다는 것이다. 명령처럼 직접 부를 수도 있고, 관련 요청을 하면 알아서 적용되기도 한다.

직접 만들어 봤다: 6줄짜리 글자 수 세기 스킬

기존 글에서 만든 글자 수 세기 스킬이다. 아래는 같은 구조로 따라 할 수 있게 파일 위치와 확인용 입력을 덧붙인 예제다.

이 실습은 일반 Claude 웹 채팅이 아니라, 내 프로젝트 폴더에서 실행하는 Claude Code 기준이다. 파일은 VS Code 같은 편집기에서 만들고, 스킬 호출은 Claude Code의 대화 입력창에서 한다.

1단계, 프로젝트 폴더 안에 스킬 폴더를 만든다. 경로는 정해져 있다. 프로젝트 폴더 아래 .claude/skills/스킬이름/ 이다. 나는 word-count라는 이름으로 만들었다.

2단계, 그 폴더에 SKILL.md 파일을 만들고 아래처럼 쓴다. 위쪽은 스킬의 이름표(이름과 설명)고, 아래쪽은 클로드가 따를 절차다.

---
name: word-count
description: 텍스트 파일의 글자 수를 세서 보고합니다.
---
사용자가 지정한 파일의 글자 수(공백 제외)를 세고,
"총 N자입니다" 형식으로 보고한다.

3단계, 확인할 입력 파일을 만든다. VS Code의 파일 → 폴더 열기에서 작업할 프로젝트를 열고, 파일 → 새 텍스트 파일을 선택한다. 아래 한 줄을 붙여 넣은 뒤 프로젝트 최상위에 sample.txt로 저장한다. 이 파일은 .claude 폴더 안이 아니라 그 폴더와 나란히 둔다.

오늘 만든 스킬로 글자 수를 확인합니다.

이 문장은 따라 하기 위해 새로 만든 가상 입력이다. 기존 작성 당시 사용한 원본 파일은 아니다. 공백과 줄바꿈을 빼고 마침표를 포함하면 17자다. 이 값은 Python으로 따로 계산해 확인했다.

4단계, 같은 프로젝트에서 Claude Code를 열고 대화 입력창에 /word-count sample.txt를 입력한다. 터미널에서 claude를 실행하기 전의 명령 입력줄이나 일반 Claude 웹 채팅에 넣는 명령이 아니다. 편집기에서 만든 스킬 폴더와 파일이 Claude Code가 연 프로젝트 안에 있어야 한다.

기대하는 답은 “총 17자입니다”다. 다른 값이 나오면 먼저 파일 내용이 같은지, 공백·줄바꿈을 제외했는지, 마침표를 포함했는지 확인한다. 파일을 찾지 못하면 sample.txt를 저장한 폴더와 Claude Code가 연 프로젝트가 같은지 확인한다. 파일이 두 개 생겼다면 sample.txt.txt로 저장하지 않았는지도 살핀다.

기존 작성 기록에는 6줄 스킬 호출에서 “총 17자입니다”라고 응답한 결과가 있다. 이번 보강에서는 새 입력의 글자 수만 검산했으며, Claude Code로 그 입력을 다시 호출한 결과를 확인한 것은 아니다. 같은 문장을 직접 실행해 예상값과 비교하면 된다.

핵심은 description(설명)을 잘 쓰는 것이다. 클로드가 이 설명을 읽고 언제 이 스킬을 쓸지 판단하기 때문에, “어떤 요청이 왔을 때 쓰는 스킬인지”를 설명에 적어주면 부르지 않아도 알아서 적용되는 빈도가 올라간다.

어디에 두느냐에 따라 적용 범위가 다르다

스킬 폴더의 위치가 2곳이라, 어디 두느냐로 적용 범위가 갈린다.

• 프로젝트 폴더의 .claude/skills/: 그 프로젝트에서만 쓰는 스킬. 블로그 프로젝트의 발행 점검처럼 특정 작업 전용이면 여기다.
• 홈 폴더의 ~/.claude/skills/: 어느 폴더에서 클로드 코드를 열어도 쓸 수 있는 개인 스킬. 어디서나 쓰는 절차면 여기다.

나는 이 구분을 실제로 이렇게 쓴다. 블로그 발행 전 점검 스킬은 블로그 폴더에만 있고, 개인 취미 프로젝트(사주 명식을 출력해 주는 프로그램)를 부르는 스킬은 홈 폴더에 있어서 아무 데서나 부른다. 절차가 어떤 일에 묶여 있는지 생각하면 위치는 자연스럽게 정해진다.

남이 만든 스킬 받아 쓰기

만들기 전에 이미 있는 걸 찾아보는 것도 방법이다. 개발사가 공식 스킬 모음을 공개 저장소로 운영하고 있고, 커뮤니티에서 만든 스킬도 블로그나 저장소로 공유된다. 필요한 작업을 먼저 정하고 그 작업을 다루는 스킬을 찾아보면 된다.

받아서 적용하는 방법은 만들 때와 같다. 스킬 폴더를 통째로 내 .claude/skills/ 아래에 복사하면 끝이다. 클로드 코드에게 “이 스킬 저장소에서 OO 스킬을 받아서 설치해 줘”라고 시켜도 된다. 설치라는 말이 붙지만 실체는 폴더 복사라서 겁먹을 게 없다. 참고로 플러그인을 설치할 때 그 안에 스킬이 담겨 함께 들어오는 경우도 있는데, 이때도 실체는 같은 SKILL.md 파일이다.

주의할 점은 하나다. 스킬은 클로드가 따르는 지시문이라, 출처를 모르는 스킬을 그대로 넣지 않는 게 안전하다. 받기 전에 SKILL.md를 열어서 무슨 절차인지 한 번 읽어보자. 마크다운 문서라서 사람이 읽어도 이해되는 수준이다.

자주 묻는 질문

스킬을 만들려면 코딩을 알아야 하나?

아니다. SKILL.md는 코드가 아니라 한국어로 쓰는 절차 설명서다. 위의 예제도 “글자 수를 세서 이 형식으로 보고해”라고 말로 적은 게 전부다. 코딩이 아니라 업무 지시서 쓰기에 가깝다.

스킬을 만들었는데 호출이 안 된다.

폴더 경로부터 확인하자. .claude/skills/스킬이름/SKILL.md 구조와 파일 위쪽 이름표(frontmatter)를 확인하면 된다. 프로젝트·개인 스킬의 슬래시 호출 이름은 스킬 폴더 이름을 따른다. 예를 들어 word-count/SKILL.md라면 /word-count로 부른다. name은 목록에 표시할 이름이고, description은 자동 호출 시점을 판단하는 데 쓰인다. 플러그인 루트의 단일 SKILL.md는 이름 규칙이 다르므로 해당 플러그인의 안내를 확인한다. 현재 버전은 변경을 실시간으로 감지하지만 목록에 보이지 않으면 새 세션에서 확인해보자.

스킬과 자동화 프로그램은 뭐가 다른가?

스킬은 클로드가 읽고 따르는 절차라서 상황에 맞게 유연하게 움직이고, 프로그램은 정해진 대로만 돈다. 판단이 필요한 반복 작업은 스킬로, 매번 완전히 똑같아야 하는 작업은 프로그램으로 만드는 게 맞다. 둘을 같이 쓰는 사례는 블로그 자동화 글에 있다.

스킬은 몇 개까지 만들 수 있나?

개수 제한을 걱정할 단계는 아니다. 다만 설명이 비슷한 스킬이 많아지면 클로드가 어느 걸 쓸지 헷갈릴 수 있으니, 하나의 스킬이 하나의 일을 하도록 쪼개고 설명을 서로 다르게 쓰는 게 좋다.

정리

• 스킬은 반복 요청을 파일로 저장하는 기능이고, 적용은 .claude/skills/ 폴더에 SKILL.md를 두는 것뿐이다.
• 프로젝트 전용은 프로젝트 폴더에, 어디서나 쓸 건 홈 폴더에 둔다.
• 만들기 전에 공식 저장소를 먼저 뒤져보고, 받은 스킬은 내용을 한 번 읽고 넣자.

스킬이 손에 익으면 다음 단계는 자동화다. 스킬과 프로그램을 엮어서 블로그 운영을 자동화한 실전 기록은 클로드 코드 블로그 자동화에서 이어진다.

설치부터 기본 설정과 첫 결과물까지 이어서 보려면 클로드 코드 시작 가이드에서 다음 단계를 고르세요.

검증 기준

• 마지막 업데이트일: 2026-09-09
• 확인 환경: macOS, Claude Code 공식 스킬 문서(2026-09-09)와 프로젝트 파일 구조 대조. 새 가상 입력은 Python으로 공백·줄바꿈 제외 17자를 검산했다. 본문의 6줄 스킬 호출은 기존 작성 기록이며, 이번에는 Claude Code로 재호출하지 않았다.
• 주요 근거: Claude Code 스킬 안내