skill-template

SKILL.md Standard Template

When creating a new skill, follow the structure below. All sections are required, and even if not applicable, keep the section heading and mark it as "Not applicable".

---

Frontmatter Schema

---
name: <skill-name>                          # 필수. 소문자 하이픈 (예: docx-generator)
description: |                              # 필수. 목적 + 트리거 키워드
  <스킬 목적을 서술형으로 작성>
  다음과 같은 요청 시 반드시 이 스킬을 사용하세요:
  - "<트리거 문장 1>"
  - "<트리거 문장 2>"
user-invocable: true                        # 선택. 기본값 true. 탭 자동완성 표시 여부
---

Forbidden fields (v1.3.0 policy)

• metadata: block (version, status, updated, tags)
• keywords: (non-standard)
• Top of body > vX.Y.Z | ... version banner

---

Body structure (required section order)

# <Skill Name> — <한 줄 요약>

> <플러그인명> | <카테고리>

## 개요

스킬의 목적과 핵심 기능을 2-4문장으로 설명합니다.
어떤 문제를 해결하는지, 누가 사용하는지, 언제 사용하는지를 포함합니다.

## 트리거 키워드

<스킬 활성화 키워드를 공백으로 구분하여 나열>
예: 보고서 작성 리포트 생성 docx 워드 문서

## 워크플로우

단계별 실행 흐름을 번호와 함께 나열합니다:

1. [단계명] — 설명
2. [단계명] — 설명
3. [단계명] — 설명

## 실행 규칙

### 1단계: <단계명>

상세 실행 규칙을 작성합니다.

| 조건 | 동작 |
|------|------|
| 케이스 A | 결과 A |
| 케이스 B | 결과 B |

### 2단계: <단계명>
...

## 사용 예시

사용자가 복사-붙여넣기 할 수 있는 실제 프롬프트를 최소 2개 제공합니다.

**예시 1: 기본 사용**
> "<자연어 프롬프트>"

**예시 2: 고급 사용**
> "<자연어 프롬프트>"

## 출력 형식

스킬이 생성하는 산출물의 형식을 명시합니다.

| 산출물 | 형식 | 설명 |
|--------|------|------|
| <산출물1> | <포맷> | <설명> |

## 주의사항

- 스킬 사용 시 주의할 점
- 한계점 및 제약사항
- 대안 스킬 참조 (해당 시)

## 관련 스킬

| 스킬 | 관계 | 설명 |
|------|------|------|
| <연관 스킬> | <before/after/alternative> | <설명> |

---

Complexity tier

Tier	Criteria	Required sections	Verification
Simple	< 50줄	Overview, triggers, workflow, 1 example	Self-verification
Standard	50-150줄	All sections + 2 examples	Self + recommended peer
Complex	150+줄	All sections + 3 examples + test cases	Self + required peer

Quality checklist

After completing the writing, be sure to check:

• Frontmatter에 name, description field exists
• metadata: no block (v1.3.0 policy)
• all required sections exist (overview, triggers, workflow, examples, output, precautions)
• at least 2 usage examples (1 for Simple tier)
• trigger keywords do not overlap with other skills
• workflow steps can be executed sequentially
• specify before/after/alternative relationships in the related skills section

---

Source: revfactory/harness skill-writing-guide (Apache 2.0) + MoAI adaptation