---
name: skill-creator
description: This skill should be used when the user wants to "create a skill", "add a skill", "make a new skill", "create a command", "add a command", or needs guidance on skill structure for Claude Code or Codex plugins.
version: 0.2.0
---

# Skill Creator

새로운 Claude Code 또는 Codex skill을 생성하는 skill.

## Skill이란?

Skill은 agent의 특정 도메인 지식과 워크플로우를 확장하는 모듈.
- Claude: slash command adapter 또는 자동 트리거 workflow로 연결 가능
- Codex: `SKILL.md` metadata 기반으로 자동 트리거
- 도메인 지식과 스크립트 번들

> **참고**: Claude command는 Codex에 1:1 대응하지 않는다. 공용 동작은 skill/script에 두고 command는 Claude adapter로 둔다.

## 프로세스

### 1. 요구사항 파악

사용자가 원하는 skill의:
- 목적과 도메인
- 트리거 조건 (사용자 호출 or 자동 트리거)
- 필요한 지식/워크플로우

불명확하면 질문:
- "이 skill은 어떤 상황에서 활성화되어야 하나요?"
- "사용자가 직접 호출하나요, 아니면 자동 트리거인가요?"

### 2. 레퍼런스 확인

- Claude 전용 패턴: `~/.claude/plugins/marketplaces/claude-plugins-official/plugins/*/skills/`
- Codex/dual runtime 패턴: 이 저장소의 `docs/dual-runtime-architecture.md`, `CHECKLIST.codex.md`, `catalog/toymarket.json`

### 3. Skill 설계

다음 항목 결정:

**name**
- 명확하고 설명적인 이름

**description**
- 트리거 조건을 구체적으로 명시
- 이 저장소에서는 Claude/Codex 양쪽 호환을 위해 "This skill should be used when..." 형식을 기본값으로 사용

**구조**
```
skill-name/
├── SKILL.md           # 필수 - 메인 skill 파일
├── scripts/           # 선택 - 실행 스크립트
├── references/        # 선택 - 참조 문서
└── assets/            # 선택 - 템플릿, 이미지 등
```

### 4. 파일 생성

`skills/[skill-name]/SKILL.md` 파일 생성:

```markdown
---
name: [Skill Name]
description: This skill should be used when [트리거 조건]...
version: 0.1.0
---

# [Skill Name]

[상세 설명]

## [핵심 섹션들]

[도메인 지식, 워크플로우, 가이드라인 등]
```

### 5. Validation

생성된 파일 검증:
- [ ] frontmatter가 `---`로 시작하고 끝나는지
- [ ] `name` 필드가 존재하는지
- [ ] `description`이 "This skill should be used when"으로 시작하는지
- [ ] 이 저장소 기준으로 `version` 필드가 존재하는지
- [ ] 파일명이 `SKILL.md`인지 (대문자)
- [ ] 폴더 구조가 `skills/[name]/SKILL.md`인지

검증 실패 시:
1. 문제점 보고
2. 자동 수정
3. 재검증

## 필수 frontmatter 필드

| 필드 | 필수 | 설명 |
|------|------|------|
| name | ✓ | skill 이름 |
| description | ✓ | 트리거 조건 |
| version | ✓ | 이 저장소에서 요구하는 버전 (semver) |

## Progressive Disclosure

Skill은 3단계로 로딩됨:
1. **메타데이터** (name + description) - 항상 컨텍스트에 있음
2. **SKILL.md 본문** - skill 트리거시 로딩
3. **번들 리소스** - 필요시 로딩

SKILL.md는 간결하게 유지하고, 상세 내용은 `references/`에 분리.

## 출력

생성 완료 후 출력:

```
## Skill Created: [name]

### Configuration
- **Name:** [name]
- **Triggers:** [트리거 조건 요약]
- **Version:** [version]

### Files Created
`skills/[name]/SKILL.md` ([word count] words)

### Validation
✓ frontmatter valid
✓ description format correct
✓ version present
✓ folder structure correct

### How to Test
[skill이 트리거될 상황 예시]
```

## 엣지 케이스

| 상황 | 대응 |
|------|------|
| 모호한 요청 | 질문으로 명확화 |
| 복잡한 도메인 | references/로 분리 |
| 스크립트 필요 | scripts/ 폴더 생성 |
| 템플릿 필요 | assets/ 폴더 생성 |