SKILL.md 커스텀 설계
생산성중급
SKILL.md 파일의 YAML frontmatter 전체 필드, $ARGUMENTS 치환 패턴, !`command` 동적 컨텍스트 주입, 디렉토리 구조를 활용해 재사용 가능한 커스텀 스킬을 설계합니다. 개인 프로젝트용 스킬부터 팀 전체 배포용 플러그인 스킬까지 설계 범위를 다룹니다.
트리거
/skill-design사용빈도필요 시
반복 작업을 스킬로 표준화하려는 개발자라면? /skill-design으로 SKILL.md를 구조화하고 팀에 공유
오픈소스 프로젝트에 기여 가이드를 스킬로 만들고 싶을 때라면? 프로젝트 .claude/skills/에 기여 워크플로우 스킬 배치
SKILL.md커스텀 스킬frontmatterAgent Skills
작동 흐름
/skill-design [스킬 목적] 실행
↓
Phase 1: 3개 설계 병렬
frontmatter
YAML frontmatter 필드 설계
prompt-body
프롬프트 본문 + $ARGUMENTS 설계
context-inject
!`command` 동적 컨텍스트 설계
↓
SKILL.md 파일 생성 + 디렉토리 배치
↓
✓ 실행 가능한 커스텀 스킬
스킬 코드
# SKILL.md Designer
## Trigger: /skill-design [purpose]
Design custom skills using the SKILL.md format.
### SKILL.md Structure:
```markdown
---
name: my-skill
description: What this skill does
# Optional fields:
# allowed_tools: [Read, Write, Bash]
# context: fork | share (default: share)
# invocation: user | auto
---
Your skill prompt goes here.
Use $ARGUMENTS for user input substitution.
Use !`command` for dynamic context injection.
```
### Frontmatter Fields:
| Field | Required | Description |
|-------|----------|-------------|
| name | Yes | Slash command trigger name |
| description | Yes | Shown in /help and autocomplete |
| allowed_tools | No | Restrict available tools |
| context | No | fork (isolated) or share (default) |
| invocation | No | user (manual) or auto (triggered by conditions) |
### $ARGUMENTS Pattern:
```markdown
Analyze the file at $ARGUMENTS and suggest improvements.
# User runs: /my-skill src/utils.ts
# $ARGUMENTS becomes: src/utils.ts
```
### Dynamic Context with !`command`:
```markdown
Current git status:
!`git status --short`
Review the changes above and suggest a commit message.
```
### Directory Structure:
```
.claude/skills/ # Personal skills (gitignored)
.claude/skills/my-skill.md
project-root/skills/ # Project skills (committed)
project-root/skills/team-review.md
~/.claude/skills/ # Global skills (all projects)
```
복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.
SKILL.md 커스텀 설계 작동 방식
SKILL.md Designer는 스킬의 목적을 입력받아 YAML frontmatter(name, description, allowed_tools, context, invocation)를 설계하고, $ARGUMENTS 치환과 !`command` 동적 컨텍스트를 포함한 프롬프트 본문을 생성합니다.
SKILL.md 커스텀 설계이(가) 빛나는 순간
팀 내 반복 워크플로우를 표준화하거나, 오픈소스 프로젝트에 기여 가이드를 스킬로 제공할 때, 또는 조직 전체에 배포할 스킬을 설계할 때 가장 유용합니다.
핵심 특장점
- YAML frontmatter 전체 필드 가이드로 올바른 스킬 설계
- $ARGUMENTS로 유연한 파라미터 처리
- !`command`로 런타임 컨텍스트 자동 주입
- 개인/프로젝트/글로벌 배포 디렉토리 구조 안내