TechLog
블로그로 돌아가기

Claude Code Custom Skills 만들기

(수정됨: 2026년 3월 10일)
tipclaude code

Claude Code에서 나만의 Slash Command 만들기

Claude Code를 쓰다 보면 반복적으로 같은 지시를 내리는 경우가 있다. "이 레포 분석해서 요약해줘", "테스트 돌리고 결과 정리해줘" 같은 작업들. Custom Skill을 만들면 이런 작업을 /my-skill 한 줄로 실행할 수 있다.

Skill이란?

Skill은 Claude Code의 커스텀 slash command다. SKILL.md 파일 하나만 만들면 /skill-name으로 실행할 수 있다. Claude에게 매번 긴 프롬프트를 쓸 필요 없이, 자주 쓰는 작업을 템플릿화할 수 있다.

어디에 만드나?

TEXT
# 모든 프로젝트에서 사용 (개인용)
~/.claude/skills/<skill-name>/SKILL.md

# 특정 프로젝트에서만 사용
.claude/skills/<skill-name>/SKILL.md

개인용은 어떤 레포에서든 사용할 수 있고, 프로젝트용은 해당 레포에서만 동작한다.

SKILL.md 구조

YAML
---
name: my-skill
description: 이 스킬이 언제 사용되는지 설명
argument-hint: [인자 설명]
disable-model-invocation: true
allowed-tools: Read, Grep, Glob
---

# 스킬 지시사항

$ARGUMENTS를 기반으로 작업을 수행합니다.

주요 옵션

옵션설명
name/name으로 실행할 이름
description스킬 설명. Claude가 자동 실행 판단에 사용
argument-hint인자 힌트 (자동완성에 표시)
disable-model-invocationtrue면 수동으로만 실행
allowed-tools사용 가능한 도구 제한

인자 전달

YAML
---
name: analyze
---

$ARGUMENTS 파일을 분석해주세요.
# /analyze src/main.ts → "src/main.ts 파일을 분석해주세요."

$0 을 $1 형식으로 변환해주세요.
# /convert data.json csv → "data.json 을 csv 형식으로 변환해주세요."
  • $ARGUMENTS: 전체 인자
  • $0, $1, $2: 위치별 인자

실전 예시

Flutter 오픈소스 프로젝트 정보를 수집해서 블로그 게시글 초안을 자동 생성하는 스킬을 만들어봤다.

YAML
---
name: add-flutter-to-blogman
description: Flutter 레포 정보를 수집하여 프로젝트 소개 게시글 초안 생성
disable-model-invocation: true
allowed-tools: Read, Grep, Glob, Write
---

# Flutter 프로젝트를 블로그 게시글로 변환

README.md, pubspec.yaml, CHANGELOG.md를 읽고
프로젝트 소개 초안을 blogman-draft.md로 저장하세요.

## 수집할 정보
- README.md: 설명, 기능, 스크린샷
- pubspec.yaml: 패키지명, 의존성, 버전
- CHANGELOG.md: 최신 변경사항

## 출력
blogman-draft.md 파일로 저장

이제 아무 Flutter 레포에서 /add-flutter-to-blogman을 실행하면 게시글 초안이 자동으로 만들어진다.

활용 팁

  • 읽기 전용 스킬: allowed-tools: Read, Grep, Glob으로 제한하면 코드 분석만 하고 수정은 못 하게 할 수 있다
  • 자동 실행 방지: 배포나 삭제 같은 위험한 작업은 disable-model-invocation: true로 수동 실행만 허용
  • 참고 문서 분리: SKILL.md가 길어지면 같은 폴더에 별도 .md 파일을 두고 참조할 수 있다

반복되는 Claude Code 작업이 있다면 Skill로 만들어두면 편하다.

댓글