매주 블로그 글을 발행하기 전에 같은 점검을 반복합니다. 날짜 형식이 맞는지, 대표 이미지 경로가 있는지, 내부 링크가 깨지지 않았는지, FAQ가 들어 있는지. 매번 클로드 코드에 같은 설명을 하다가 이 절차를 스킬(Skill)로 묶었습니다. 이제는 "발행 전 점검해 줘" 한마디면 됩니다.
스킬이란?
스킬은 특정 작업을 위한 지침, 절차, 참고 자료, 스크립트를 폴더 하나로 묶은 것입니다. 핵심 파일은 SKILL.md입니다.
.claude/skills/
└── publish-check/
├── SKILL.md ← 이름, 설명, 절차
├── checklist.md ← 참고 자료 (선택)
└── check_links.py ← 보조 스크립트 (선택)
CLAUDE.md, 서브에이전트, 스킬 비교
| 구분 | CLAUDE.md | 서브에이전트 | 스킬 |
|---|---|---|---|
| 읽히는 시점 | 세션마다 항상 | 호출될 때 별도 컨텍스트에서 | 관련 작업 시 필요할 때 |
| 주 용도 | 프로젝트 기본 규칙 | 역할 분리, 컨텍스트 격리 | 반복 절차·전문 지식 |
| 적합한 내용 | 짧은 핵심 규칙 | 리뷰어·테스터 같은 역할 | 길고 구체적인 작업 매뉴얼 |
스킬의 장점은 필요할 때만 불러온다는 것입니다. 평소에는 스킬의 이름과 설명만 클로드가 알고 있다가, 관련 작업이 생기면 그때 전체 내용을 읽습니다. 그래서 긴 절차서를 여러 개 만들어 둬도 평소 컨텍스트를 차지하지 않습니다.
스킬 위치
| 위치 | 범위 |
|---|---|
.claude/skills/ |
이 프로젝트 (팀 공유 가능) |
~/.claude/skills/ |
내 모든 프로젝트 |
SKILL.md 구조
---
name: publish-check
description: 블로그 글 발행 전 점검. 새 글을 썼거나 "발행 전 점검", "글 검사"를 요청받으면 사용한다.
---
# 발행 전 점검 절차
content/posts/ 의 대상 글(지정이 없으면 최근 수정한 글)을 다음 순서로 점검한다.
1. front matter 필수 항목
- title, date, category, summary, featured_image, faq 존재 여부
- date는 ISO 8601(+09:00) 형식이고 현재 시각보다 미래가 아닌지
- category가 config/site.yaml 의 categories 에 있는 값인지
2. 이미지
- featured_image 파일이 content/images/ 에 있는지
3. 링크
- 본문의 /posts/*.html 내부 링크가 실제 글 파일과 맞는지
- 외부 링크는 목록만 보고 (자동 접속하지 않음)
4. 본문
- H2가 3개 이상인지, '정리' 섹션이 있는지
결과는 글별로 표로 보고한다: 항목 / 결과(통과·문제) / 수정 제안.
파일은 수정하지 않는다. 수정은 사용자가 요청할 때만.
작성 포인트
- description에 "언제 쓰는지"를 구체적으로: 클로드는 이 설명을 보고 스킬을 쓸지 결정합니다. 사용자가 실제로 말할 법한 표현("발행 전 점검", "글 검사")을 넣으면 잘 연결됩니다.
- 절차는 번호로, 판단 기준은 명확히: "적절한지 확인" 대신 "H2가 3개 이상인지"처럼.
- 하지 말 것 명시: "파일은 수정하지 않는다" 같은 경계를 적어 둡니다.
보조 파일과 스크립트 활용
절차가 길어지면 SKILL.md는 개요만 두고 세부 내용을 별도 파일로 분리합니다. 반복 계산이나 검사는 스크립트로 만들어 두고 SKILL.md에서 "링크 검사는 check_links.py를 실행한다"처럼 안내하면, 클로드가 매번 같은 방식으로 정확하게 처리합니다.
스킬 호출
- 자동: "새 글 세 개 썼어, 발행 전에 봐 줘" → 클로드가 publish-check 스킬을 사용
- 직접: 슬래시 명령처럼 스킬 이름으로 호출
잘 쓰는 요령
- 두 번 이상 반복한 설명은 스킬 후보: 같은 요청을 세 번째 하게 되면 스킬로 만듭니다.
- 작게 시작: 처음부터 완벽한 매뉴얼을 쓰기보다, 핵심 절차 5줄로 시작해 실패할 때마다 보완합니다.
- 스킬도 클로드에게 만들게: "지금까지 한 점검 절차를 스킬로 만들어 줘"라고 하면 초안을 써 줍니다. 저장 전에 직접 읽고 다듬으세요.
- 팀과 공유: 프로젝트 스킬은 깃으로 공유되므로 팀의 작업 방식을 표준화할 수 있습니다.
클로드에게 일을 가르친다는 느낌
스킬을 만들고 나서 "클로드에게 일을 가르친다"는 느낌을 처음 받았습니다. 한 번 잘 정리해 두면 다음부터는 같은 품질로 같은 절차를 반복합니다. 요즘 이 블로그에 올리는 글도 이 점검 스킬로 날짜·이미지·링크를 확인했습니다. 반복 작업이 있다면 오늘 하나만 스킬로 만들어 보세요. 다음 주의 내가 고마워할 겁니다.
이 글의 요점
- 스킬은 반복 작업의 절차와 자료를 폴더로 묶어 필요할 때만 불러오는 기능입니다.
.claude/skills/이름/SKILL.md에 name, description(사용 시점), 절차를 적습니다.- 두 번 이상 반복한 설명은 스킬로 만들고, 작게 시작해 다듬으세요.
