Skills로 '커맨드형' 자동화 만들기

슬래시 커맨드로 품질 보증 워크플로우 자동화하기

Skills란 무엇인가

3장·4장에서 Hooks를 사용한 이벤트 기반 자동화를 학습했다. Hooks는 "무언가가 일어나면 자동으로 실행한다"는 구조였다.

Skills는 그것과 대조적인 "커맨드형" 자동화다. 사용자가 /스킬명 을 입력함으로써 정의된 워크플로우가 기동된다.

Hooks = 이벤트 기반 (자동 발화)
→ 커밋 시 lint, 파일 저장 시 포맷

Skills = 커맨드 기반 (수동 기동)
→ 아티클 작성, 배포, 도서 출판

Hooks가 "무대 뒤의 자동화"라면, Skills는 "무대 위의 워크플로우"다. 팀에서 공유하는 정형 작업, 품질 기준이 포함된 콘텐츠 작성, 여러 단계의 절차를 스킬로 정리해두면 매번 동일한 품질의 산출물을 낼 수 있게 된다.

저자의 환경에서는 15개의 스킬이 가동 중이며, 아티클 작성부터 배포까지의 일상 업무를 커버하고 있다.

스킬 정의 파일 작성법

스킬은 .claude/skills/ 디렉토리에 마크다운 파일로 배치한다.

배치 위치

.claude/
skills/
write-velog.md # /write-velog 로 호출 가능
publish-ridibooks.md # /publish-ridibooks 로 호출 가능
deploy.md # /deploy 로 호출 가능

프론트매터 구조

---
name: write-velog # 스킬명 (/로 호출할 때 사용하는 이름)
description: "Velog 아티클을 작성한다" # 설명 (스킬 목록에 표시됨)
user_invocable: true # true로 하면 /name 으로 호출 가능
---

user_invocable: true 가 중요하다. false 인 경우, 다른 스킬이나 에이전트에서만 호출할 수 있다. 사용자가 직접 /스킬명 으로 기동하고 싶은 스킬은 반드시 true 로 설정한다.

본문 작성법

프론트매터 뒤에 마크다운 형식으로 스킬의 동작을 기술한다. 본문은 Claude Code에 대한 "지시서"가 된다.

---
name: my-skill
description: "설명"
user_invocable: true
---

# /my-skill — 스킬의 정식 명칭

당신은 ○○의 전문가입니다.

## 워크플로우
1. 스텝 1: 무엇을 확인할지
2. 스텝 2: 무엇을 생성할지
3. 스텝 3: 무엇을 출력할지

## 규칙
- 지켜야 할 품질 기준
- 출력 포맷
- 금지 사항

포인트는 3가지다.

페르소나 부여: "당신은 ○○의 전문가입니다"라고 冒頭에서 역할을 정의한다

스텝을 명시한다: 모호함을 배제하고 실행 순서를 고정한다

품질 기준을 수치화한다: "좋은 아티클을 써줘"가 아닌 "100점 만점에 75점 이상"

구현 예시 1: /write-velog — Velog 아티클 작성 스킬

저자가 가장 자주 사용하는 스킬이다. Velog용 기술 아티클을 품질 스코어링 기준 포함으로 생성한다. 주에 5편 이상의 아티클을 이 스킬로 양산하고 있다.

스킬 정의 전체 구조

.claude/skills/write-velog.md:

---
name: write-velog
description: Velog 아티클을 작성한다. SEO 스코어링 기준(100점 만점)에 기반해
75점 이상의 아티클만 출력. 사용법 /write-velog "테마"
user_invocable: true
---

# /write-velog — Velog 아티클 작성 스킬

당신은 Velog 향 기술 아티클의 전문 라이터입니다.
**아티클을 쓰기 전에 스코어링 기준을 확인하고, 75점 이상의 아티클만 출력합니다.**

## 스코어링 기준 (100점 만점)

### 1. SEO (30점)
| 항목 | 배점 | 기준 |
|------|------|------|
| 키워드 경쟁도 | 10 | 저경쟁=10, 중=7, 고=4 |
| 제목에 메인 키워드 포함 | 5 | 포함=5, 일부=3, 없음=0 |
| H2/H3이 검색 쿼리에 대응 | 5 | 3개 이상=5, 2개=3, 1개 이하=1 |
| 메타 디스크립션 최적화 | 5 | 120자 이내 소구=5, 너무 길거나 짧음=2 |
| 아티클 길이 (3,000~7,000자) | 5 | 적정=5, 약간 벗어남=3, 크게 벗어남=1 |

### 2. 콘텐츠 품질 (30점)
| 항목 | 배점 | 기준 |
|------|------|------|
| 오리지널리티 | 10 | 독자적 시각/비교/실제 경험=10, 일반적=5 |
| 실용성 (코드 예시+절차) | 10 | 복붙해서 바로 사용 가능=10, 개념 설명만=5 |
| 구성의 논리성 | 5 | 도입→과제→해결→실전→정리=5 |
| 코드 블록·도표 | 5 | 3개 이상=5, 1~2=3, 없음=1 |

### 3. 전환 (20점)
| 항목 | 배점 | 기준 |
|------|------|------|
| 도서 CTA의 자연스러운 배치 | 10 | 맥락에 맞는 유도=10, 말미에만=5 |
| 내부 링크 (다른 아티클·도서) | 5 | 2개 이상=5, 1개=3, 없음=0 |
| AI 컨설팅 CTA | 5 | 대상 독자에 관련=5, 무관=0 |

### 4. 인게이지먼트 (20점)
| 항목 | 배점 | 기준 |
|------|------|------|
| 후크 (첫 문장의 흡인력) | 5 | 숫자/문제 제기=5, 보통=2 |
| 비교표·플로우차트 | 5 | 있음=5, 없음=0 |
| 토픽 태그 최적화 | 5 | 관련성 높은 5개=5, 3개 이하=2 |
| 공유하고 싶어지는 요소 | 5 | 독자적 프레임워크=5, 없음=0 |

## 출력 포맷
Velog 프론트매터 형식으로 출력:
（생략）

## 규칙
1. 독자는 개발자 (중급~상급)
2. 코드 예시는 반드시 복붙해서 동작하는 것을 포함한다
3. published: false 로 저장. 공개는 자동 게시 스크립트가 담당
4. 아티클 말미에 스코어링 결과를 표 형식으로 첨부한다