Agent skill

skill-creator

Guide for creating new Claude skills. Use this when creating a new skill, updating existing skills, or learning best practices for skill development.

View SKILL.md on GitHub Repository
Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/doyajin174/skill-creator

Metadata

Additional technical details for this skill

author
anthropics
version
1.0

SKILL.md

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: 재사용 콘텐츠 계획

각 예시 분석:

  1. 처음부터 어떻게 실행?
  2. 반복 작업에 필요한 리소스?
예시: "PDF 회전해줘"
→ 매번 같은 코드 작성 필요
→ scripts/rotate_pdf.py 추가

Step 3: 스킬 초기화

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

Step 4: 스킬 편집

Frontmatter 작성:

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

Body 작성 (명령형):

markdown
# My Skill

## Quick Start
[핵심 사용법]

## Workflow
[단계별 절차]

## Examples
[구체적 예시]

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

Step 5: 패키징

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

Step 6: 반복

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

Bundled Resources

scripts/

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

references/

markdown
# 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

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

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

Progressive Disclosure Patterns

Pattern 1: 개요 + 참조

markdown
# 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단계
  • 불필요한 파일 없음

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results