skill template

Other Community

Skill notes

금지 필드 (v1.3.0 정책)

metadata: 블록 (version, status, updated, tags) keywords: (비표준) 본문 상단 > vX.Y.Z | ... 버전 배너

복잡도 티어

티어 · 기준 · 필수 섹션 · 검증 Simple · < 50줄 · 개요, 트리거, 워크플로우, 예시 1개 · 자가 검증 Standard · 50-150줄 · 전체 섹션 + 예시 2개 · 자가 + 권장 피어 Complex · 150+줄 · 전체 섹션 + 예시 3개 + 테스트 케이스 · 자가 + 필수 피어

품질 체크리스트

작성 완료 후 반드시 확인: [ ] Frontmatter에 name, description 필드 존재 [ ] metadata: 블록 없음 (v1.3.0 정책) [ ] 모든 필수 섹션 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항) [ ] 사용 예시 최소 2개 (Simple 티어는 1개)

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Other
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@modu-ai · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# SKILL.md Standard Template

새 스킬 작성 시 아래 구조를 따릅니다. 모든 섹션이 필수이며, 해당 없는 경우에도 섹션 제목을 유지하고 "해당 없음"으로 표시합니다.

---

## Frontmatter Schema

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

### 금지 필드 (v1.3.0 정책)

- `metadata:` 블록 (version, status, updated, tags)
- `keywords:` (비표준)
- 본문 상단 `> vX.Y.Z | ...` 버전 배너

---

## 본문 구조 (필수 섹션 순서)

```markdown
# <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개 + 테스트 케이스 | 자가 + 필수 피어 |

## 품질 체크리스트

작성 완료 후 반드시 확인:

- [ ] Frontmatter에 `name`, `description` 필드 존재
- [ ] `metadata:` 블록 없음 (v1.3.0 정책)
- [ ] 모든 필수 섹션 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항)
- [ ] 사용 예시 최소 2개 (Simple 티어는 1개)
- [ ] 트리거 키워드가 다른 스킬과 중복되지 않음
- [ ] 워크플로우 단계가 순차적으로 실행 가능함
- [ ] 관련 스킬 섹션에 before/after/alternative 관계 명시

---

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

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.