| 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 파일 생성:
---
name: [Skill Name]
description: This skill should be used when [트리거 조건]...
version: 0.1.0
---
# [Skill Name]
[상세 설명]
## [핵심 섹션들]
[도메인 지식, 워크플로우, 가이드라인 등]
5. Validation
생성된 파일 검증:
검증 실패 시:
- 문제점 보고
- 자동 수정
- 재검증
필수 frontmatter 필드
| 필드 | 필수 | 설명 |
|---|
| name | ✓ | skill 이름 |
| description | ✓ | 트리거 조건 |
| version | ✓ | 이 저장소에서 요구하는 버전 (semver) |
Progressive Disclosure
Skill은 3단계로 로딩됨:
- 메타데이터 (name + description) - 항상 컨텍스트에 있음
- SKILL.md 본문 - skill 트리거시 로딩
- 번들 리소스 - 필요시 로딩
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/ 폴더 생성 |
