| name | meta-skill-template |
| description | SKILL.md 표준 템플릿. 새 스킬 생성 시 이 템플릿을 기반으로 작성합니다.
스킬 작성 가이드라인과 필수 섹션 구조를 정의합니다.
다음과 같은 요청 시 이 스킬을 참조하세요:
- "새 스킬 만들고 싶어", "스킬 템플릿", "SKILL.md 템플릿"
- "스킬 작성 방법", "스킬 구조", "스킬 포맷"
|
| version | 1.1.1 |
SKILL.md Standard Template
새 스킬 작성 시 아래 구조를 따릅니다. 모든 섹션이 필수이며, 해당 없는 경우에도 섹션 제목을 유지하고 "해당 없음"으로 표시합니다.
Frontmatter Schema
---
name: <skill-name>
description: |
<스킬 목적을 서술형으로 작성>
다음과 같은 요청 시 반드시 이 스킬을 사용하세요:
- "<트리거 문장 1>"
- "<트리거 문장 2>"
---
user-invocable은 쓰지 않는 것이 기본입니다. 이 필드를 true로 두면 데스크톱 앱이
해당 스킬을 "스킬"이 아니라 "커맨드"로 분류해 플러그인의 스킬 수에서 빠집니다.
스킬이 하나뿐인 플러그인이라면 목록에 스킬 0개로 표시됩니다(2026-08-22 PM 플러그인 사례).
현재 배포 스킬 224개 중 214개가 이 필드를 아예 쓰지 않고 정상 동작합니다 — 자연어 요청과
Skill() 호출로 얼마든지 불립니다. 슬래시 진입점이 필요하면 user-invocable 대신
commands/<이름>.md 파일을 만드세요(그쪽이 Claude Cowork의 정식 경로입니다).
금지 필드 (v1.3.0 정책)
metadata: 블록 (version, status, updated, tags)keywords: (비표준)- 본문 상단
> vX.Y.Z | ... 버전 배너
본문 구조 (필수 섹션 순서)
# <Skill Name> — <한 줄 요약>
> <플러그인명> | <카테고리>
## 개요
스킬의 목적과 핵심 기능을 2-4문장으로 설명합니다.
어떤 문제를 해결하는지, 누가 사용하는지, 언제 사용하는지를 포함합니다.
## 트리거 키워드
<스킬 활성화 키워드를 공백으로 구분하여 나열>
예: 보고서 작성 리포트 생성 docx 워드 문서
## 워크플로우
단계별 실행 흐름을 번호와 함께 나열합니다:
1. [단계명] — 설명
2. [단계명] — 설명
3. [단계명] — 설명
## 실행 규칙
### 1단계: <단계명>
상세 실행 규칙을 작성합니다.
| 조건 | 동작 |
|------|------|
| 케이스 A | 결과 A |
| 케이스 B | 결과 B |
### 2단계: <단계명>
...
## 사용 예시
사용자가 복사-붙여넣기 할 수 있는 실제 프롬프트를 최소 2개 제공합니다.
**예시 1: 기본 사용**
> "<자연어 프롬프트>"
**예시 2: 고급 사용**
> "<자연어 프롬프트>"
## 출력 형식
스킬이 생성하는 산출물의 형식을 명시합니다.
| 산출물 | 형식 | 설명 |
|--------|------|------|
| <산출물1> | <포맷> | <설명> |
## 주의사항
- 스킬 사용 시 주의할 점
- 한계점 및 제약사항
- 대안 스킬 참조 (해당 시)
## 관련 스킬
| 스킬 | 관계 | 설명 |
|------|------|------|
| <연관 스킬> | <before/after/alternative> | <설명> |
복잡도 티어
| 티어 | 기준 | 필수 섹션 | 검증 |
|---|
| Simple | < 50줄 | 개요, 트리거, 워크플로우, 예시 1개 | 자가 검증 |
| Standard | 50-150줄 | 전체 섹션 + 예시 2개 | 자가 + 권장 피어 |
| Complex | 150+줄 | 전체 섹션 + 예시 3개 + 테스트 케이스 | 자가 + 필수 피어 |
품질 체크리스트
작성 완료 후 반드시 확인:
Source: revfactory/harness skill-writing-guide (Apache 2.0) + MoAI adaptation
