SKILL.md 구조 이해하기 : 프론트매터와 본문, 제대로 작성하는 법
목차
스킬의 핵심은 SKILL.md 파일입니다.
이 파일 하나에 스킬의 모든 정보가 담겨 있습니다. 구조를 제대로 이해하면 원하는 대로 동작하는 스킬을 만들 수 있습니다.
이 글에서는 SKILL.md의 프론트매터와 본문 구성을 상세히 알아봅니다.
SKILL.md 전체 구조
SKILL.md는 크게 두 부분으로 나뉩니다:
① 프론트매터 (Frontmatter)
파일 상단, ---로 감싸진 영역
스킬의 메타 정보 정의
② 본문 (Body)
프론트매터 아래 마크다운 영역
실제 지침과 규칙 작성
---
# ← 프론트매터 시작
name: my-skill
description: 스킬 설명
keywords: ["키워드1", "키워드2"]
# ← 프론트매터 끝
---
# ← 본문 시작
## 역할
당신은 전문가입니다.
## 규칙
1. 규칙 1
2. 규칙 2
# ← 본문 끝
프론트매터가 뭔가요? 처음 들어보는데...
문서의 신분증이라고 생각하면 돼. 이름, 설명, 분류 같은 기본 정보가 들어가는 거야. Claude가 이걸 보고 "아, 이 스킬은 이런 거구나"라고 파악해.
프론트매터 상세
프론트매터는 YAML 형식으로 작성합니다.
필수 필드
| 필드 | 설명 | 예시 |
|---|---|---|
| name | 스킬 고유 이름 (영문, 케밥케이스) | blog-writer |
| description | 스킬 기능 + 트리거 설명 | 블로그 글 작성. "블로그 써줘" 시 활성화 |
선택 필드
| 필드 | 설명 | 예시 |
|---|---|---|
| keywords | 자동 활성화 키워드 배열 | ["블로그", "글쓰기"] |
| version | 스킬 버전 | 1.0.0 |
| author | 제작자 정보 | 홍길동 |
name은 슬래시 명령어로 사용됩니다. name: blog-writer면 /blog-writer로 호출할 수 있어요!
본문 구성 패턴
본문은 마크다운으로 자유롭게 작성합니다. 하지만 효과적인 패턴이 있습니다.
## 역할 (Role) - AI가 맡을 페르소나
## 목표 (Goal) - 달성해야 할 목표
## 규칙 (Rules) - 반드시 따를 규칙
## 단계 (Steps) - 작업 순서 (선택)
## 예시 (Examples) - 입출력 예시 (선택)
역할 (Role) 섹션
## 역할
당신은 10년 경력의 테크 블로거입니다.
SEO와 가독성을 모두 고려한 글쓰기 전문가입니다.
역할을 왜 정해주는 거예요?
배우가 대본을 받으면 그 역할에 몰입하잖아? AI도 마찬가지야. 역할을 명확히 주면 그에 맞는 톤, 관점, 전문성으로 응답해.
규칙 (Rules) 섹션
## 규칙
1. 모든 글은 2000자 이상 작성
2. 소제목(H2)을 3개 이상 포함
3. 결론에는 CTA(Call to Action) 포함
4. 이모지는 제목에만 사용
5. 존댓말(~입니다, ~합니다) 사용
규칙은 번호 목록으로 작성하세요. AI가 규칙을 빠뜨리지 않고 체크하기 좋습니다!
완성된 SKILL.md 예시
---
name: tech-blog-writer
description: 기술 블로그 글 작성 전문가. "기술 블로그", "테크 포스팅" 요청 시 활성화
keywords: ["기술 블로그", "테크 블로그", "개발 블로그"]
version: 1.0.0
---
# 기술 블로그 작성 스킬
## 역할
당신은 10년 경력의 기술 블로거입니다.
복잡한 기술을 쉽게 설명하고, SEO 최적화된 글을 작성합니다.
## 목표
- 독자가 쉽게 이해할 수 있는 기술 글 작성
- 검색 엔진에 잘 노출되는 구조 설계
- 실용적인 예제 코드 포함
## 규칙
1. 글 길이: 2000~3000자
2. 소제목(H2): 최소 3개
3. 코드 예시: 최소 1개 포함
4. 어려운 용어는 괄호로 설명 추가
5. 결론에 핵심 정리 포함
## 출력 형식
- 제목: [주제] - [핵심 가치]
- 인트로: 독자의 문제 제시
- 본문: 해결 방법 단계별 설명
- 결론: 핵심 요약 + 다음 학습 안내
💡 이 스킬의 동작
입력: "기술 블로그 주제로 React 상태관리 글 써줘"
동작:
- "기술 블로그" 키워드 매칭 → 스킬 활성화
- 역할: 10년 경력 기술 블로거로 응답
- 규칙: 2000~3000자, 소제목 3개+, 코드 예시 포함
- 출력: 지정된 형식으로 글 생성
자주 하는 실수
❌ 실수 1: 프론트매터 형식 오류
---가 정확히 3개의 대시여야 합니다. --나 ----는 인식 안 됨!
❌ 실수 2: name에 공백 사용
name: my skill ❌
name: my-skill ✅
❌ 실수 3: 너무 모호한 규칙
"좋은 글을 써라" ❌
"2000자 이상, 소제목 3개 포함" ✅
프론트매터 = 스킬 메타 정보 (name, description, keywords)
본문 = 실제 지침 (역할, 목표, 규칙, 단계)
name = 슬래시 명령어로 사용됨
규칙 = 구체적이고 측정 가능하게 작성
👉 Description 작성법 : 스킬 활성화의 핵심, 황금 공식 마스터하기
구조를 이해하면 원하는 스킬을 자유자재로 만들 수 있습니다.
SKILL.md 작성의 기본을 탄탄히 다지세요! 📝
댓글
댓글 쓰기