What is skill-creator?

The Skill Creator is a comprehensive meta-guide designed to streamline the development, optimization, and management of custom Claude skills. It provides a standardized framework for building modular AI capabilities, ensuring efficient context window usage through progressive disclosure and best practices in skill architecture, which is essential for developers looking to extend Claude's functionality.

When should I use skill-creator?

skill-creator is useful in the following scenarios: • Standardizing AI agent instructions into a modular 'skill' format for better maintainability and reuse. • Optimizing long-form prompts by implementing progressive disclosure patterns to save context window tokens. • Creating specialized toolkits that combine executable scripts, reference documentation, and core logic for specific domains like PDF processing or API integration. • Validating and auditing existing Claude skills against industry best practices to ensure high-quality agent performance.

name	skill-creator
description	Guide for creating new Claude skills. Use this when creating a new skill, updating existing skills, or learning best practices for skill development.
allowed-tools	Read, Glob, Grep, Edit, Write, Bash
license	MIT
author	anthropics
version	"1.0"

Skill Creator

새로운 Claude 스킬을 생성하는 가이드입니다.

What is a Skill?

스킬은 Claude의 능력을 확장하는 모듈식 패키지입니다:

전문 워크플로우: 특정 도메인의 다단계 절차
도구 통합: 파일 형식, API 연동 지침
도메인 전문성: 비즈니스 로직, 스키마
번들 리소스: 스크립트, 레퍼런스, 에셋

Skill Structure

skill-name/
├── SKILL.md (필수)
│   ├── YAML frontmatter (필수)
│   │   ├── name: (필수)
│   │   └── description: (필수)
│   └── Markdown body (필수)
└── Bundled Resources (선택)
    ├── scripts/      # 실행 코드
    ├── references/   # 참조 문서
    └── assets/       # 출력용 파일

Core Principles

1. Concise is Key

"컨텍스트 윈도우는 공공재다"

Claude는 이미 매우 똑똑함
필요한 정보만 추가
장황한 설명보다 간결한 예시

2. Degrees of Freedom

자유도	사용 시점	형태
높음	여러 접근법 가능	텍스트 지침
중간	선호 패턴 존재	의사코드/파라미터
낮음	민감한 작업	구체적 스크립트

3. Progressive Disclosure

Level 1: Metadata (~100 words)     → 항상 컨텍스트에
Level 2: SKILL.md body (<5k words) → 트리거 시 로드
Level 3: Resources (무제한)         → 필요 시 로드

Creation Process

Step 1: 구체적 예시 이해

Q: 어떤 기능을 지원해야 하나요?
Q: 사용 예시를 보여주세요
Q: 어떤 요청이 이 스킬을 트리거해야 하나요?

Step 2: 재사용 콘텐츠 계획

각 예시 분석:

처음부터 어떻게 실행?
반복 작업에 필요한 리소스?

예시: "PDF 회전해줘"
→ 매번 같은 코드 작성 필요
→ scripts/rotate_pdf.py 추가

Step 3: 스킬 초기화

# 템플릿 생성
scripts/init_skill.py <skill-name> --path <output>

Step 4: 스킬 편집

Frontmatter 작성:

---
name: my-skill
description: |
  무엇을 하는가 + 언제 사용하는가.
  예: "PDF 문서 처리. PDF 텍스트 추출,
  병합, 페이지 조작이 필요할 때 사용"
---

Body 작성 (명령형):

# My Skill

## Quick Start
[핵심 사용법]

## Workflow
[단계별 절차]

## Examples
[구체적 예시]

## References
- [REFERENCE.md](references/REFERENCE.md) for details

Step 5: 패키징

scripts/package_skill.py <path/to/skill>

Step 6: 반복

실제 사용 → 문제 발견 → 개선

Bundled Resources

scripts/

# scripts/process.py
# 반복적으로 작성되는 코드 저장
# 실행 전 테스트 필수

references/

# references/schema.md
# 컨텍스트에 필요할 때만 로드
# SKILL.md에서 참조 명시

assets/

assets/template.html    # 출력용 템플릿
assets/logo.png         # 브랜드 에셋
assets/boilerplate/     # 시작 코드

What NOT to Include

❌ 포함하지 말 것:

README.md
INSTALLATION_GUIDE.md
CHANGELOG.md
테스트/설정 문서

스킬은 AI 에이전트용 - 사용자 문서 X

Description Best Practices

# ❌ 부족함
description: PDF 처리 도구

# ✅ 좋음
description: |
  PDF 텍스트 추출, 페이지 병합/분할, 메타데이터 편집.
  PDF 문서 작업 시 사용:
  (1) 텍스트 추출 (2) 페이지 조작
  (3) 여러 PDF 병합 (4) 양식 처리

Progressive Disclosure Patterns

Pattern 1: 개요 + 참조

# PDF Processing

## Quick Start
[기본 사용법]

## Advanced
- **Forms**: See [FORMS.md](references/FORMS.md)
- **API**: See [API.md](references/API.md)

Pattern 2: 도메인별 구성

bigquery-skill/
├── SKILL.md
└── references/
    ├── finance.md
    ├── sales.md
    └── product.md

Validation Checklist

name과 description 필수 포함
description에 "언제 사용" 명시
SKILL.md 500줄 이하
참조 파일 깊이 1단계
불필요한 파일 없음

skill-creator

When & Why to Use This Skill

Use Cases