Skills

개요

Skills는 클로드 코드의 Custom Slash Command와 마찬가지로 재사용 가능한 프롬프트 입니다. 특징으로는 description에 따라 자율적으로 실행될 수 있다는 것입니다. Progressive Disclosure 방식으로 동작하기 때문에 token 기본적으로 token 사용량 최적화가 Custom Slash Command 대비 유리합니다.

스킬 작성 방법

스킬 파일 위치

스킬은 skills 하위에 별도 skill 이름의 디렉토리를 만들고 그 아래에 SKILL.md를 만들어야 합니다.

~/.claude/skills/{skill-name}/SKILL.md     # 전역 스킬
.claude/skills/{skill-name}/SKILL.md        # 프로젝트별 스킬

스킬의 구조

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

SKILL.md 작성 예시

아래는 코드 예시를 만들어주는 스킬입니다. description은 스킬이 실행되는 조건입니다. 클로드 코드는 description을 보고 스킬 사용여부를 결정하게 됩니다. 따라서 description에는 스킬에 대한 구체적인 조건이 들어있어야 합니다.

  1. .claude/skills/learning-code/SKILL.md 에 작성
---
name: learning-code
description: 특정 기능에 대해서 샘플 코드 생성에 대해서 요청이 있는 경우 스킬이 사용된다. 특정 기능에 대해서 간단한 예시를 요청하는 경우 실행된다.
---

# 코드 샘플을 작성하는 스킬

- 코드 생성시 javascript 코드와 python 코드를 동시에 생성한다.
- 모든 라인에는 주석을 달아준다.
- 샘플 코드의 길이는 20줄을 넘지 않는 최대한 간단한 예시이어야 한다.
  1. 프롬프트
파일을 여는 방법에 대해서 샘플코드를 작성해줘 (use skill)

명시적 description 중요성

Clear 케이스

구체적으로 트리거 조건이 작성 되어있습니다. 엑셀 파일, 스프레드 시트와 같은 데이터를 분석할때 사용한다고 작성 되어 있으므로 엑셀, 스프레드 시트의 분석 요청이 트리거가 될 수 있습니다.

description: Analyze Excel spreadsheets, create pivot tables, and generate charts. Use when working with Excel files, spreadsheets, or analyzing tabular data in .xlsx format.

Vague 케이스

파일에 대한 것이라고만 적혀있으므로 스킬 사용여부가 너무 모호합니다. 클로드 코드는 사용조건이 모호하면 그 스킬은 사용하지 않습니다.

description: For files

Progressive Disclosure

단계적 공개(Progressive Disclosure)은 skill의 각 부분들이 클로드 코드 실행시 모두 공개되는 것이 아니라 필요할 때마다 읽는 방식을 의미합니다.

공개영역은 아래 단위로 나뉘게 됩니다.

  1. Metadata 영역 (SKILL.md 상단에 위치)
  2. Instructions 영역 (SKILL.md의 본문)
  3. Resources and code 영역

클로드 코드가 실행되면 1단계인 Metadata는 항상 로드됩니다. 보통 100 tokens 미만이므로 사이즈가 크지는 않습니다. 스킬의 사용여부를 판단해야하기 때문에 항상 로드가 됩니다.

스킬 본문인 Instructions 영역 파일은 해당 스킬 사용이 확정되면 로드됩니다. 보통 스킬 본문은 5k tokens 미만입니다.

마지막으로 Resources and code 영역입니다. 이건 필요한만큼 로드합니다. 필요한 만큼 로드하기 때문에 token 사용량의 제한은 없습니다. 예시, 템플릿, 스크립트 같은 것들이 여기에 해당됩니다.

사용 예시

git worktree 사용하기

  1. https://claude-plugins.stefancho.dev/ 페이지 접속
  2. git-worktree-plugin 설치
/plugin marketplace add devstefancho/claude-plugins
/plugin install git-worktree-plugin@devstefancho-claude-plugins
  1. 프롬프트
skill 써서 git worktree 생성해줘
1. 브랜치명: feat/add-authorization
2. 워크트리 경로: ./trees/
3. 베이스 브랜치: main
4. 생성 후 원격에 push 해서 upstream을 브랜치명과 동일하게 설정

Session Reporter 사용하기

  1. https://claude-plugins.stefancho.dev/ 페이지 접속
  2. session-reporter-plugin 설치
/plugin install session-reporter-plugin@devstefancho-claude-plugins
  1. 프롬프트
현재 세션 html 페이지 생성해줘

활용 사례

  • Git, Github 관련
  • 코드 리뷰 스킬
  • 리팩터링 스킬
  • 문서 작성 스킬
  • 문서 파싱 스킬

Ref