CClaude Code Catalog
전체 스킬

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`로 런타임 컨텍스트 자동 주입
  • 개인/프로젝트/글로벌 배포 디렉토리 구조 안내

같은 카테고리 스킬

생산성 전체 보기

다른 카테고리 인기 스킬