명령어와 Skills
Claude Code의 /이름 입력은 하나의 구현 방식만 뜻하지 않습니다. 내장 명령어, Claude가 프롬프트로 수행하는 bundled skill, 여러 에이전트를 실행하는 workflow가 같은 명령 목록에 함께 표시될 수 있습니다. 현재 목록과 동작은 설치 버전에 따라 달라질 수 있으므로 /help와 공식 Commands 페이지를 기준으로 확인합니다.
핵심 개념
| 종류 | 특징 | 확인 방법 |
|---|---|---|
| 내장 명령어 | CLI에 구현된 세션·설정 제어 기능 | /help, 공식 Commands |
| Bundled skill | Claude가 실행하는 Anthropic 제공 워크플로우 | 공식 Commands에서 Skill 표시 확인 |
| Workflow | 여러 subagent로 작업을 분산하는 백그라운드 워크플로우 | 공식 Commands에서 Workflow 표시 확인 |
| Custom skill | 사용자가 SKILL.md로 정의하는 재사용 지침 |
/skills, /skill-name |
예전 .claude/commands/*.md 파일은 계속 동작하지만, 공식 문서는 지원 파일과 호출 제어를 제공하는 Skills를 권장합니다. 새 명령 정의에 임의의 JSON registry를 만들지 않습니다.
선택 기준
- 세션 설정이나 진단은 내장 명령어를 사용합니다.
- 반복 프롬프트는
.claude/skills/<skill-name>/SKILL.md로 만듭니다. - 사용자가 명시적으로 실행해야 하는 배포·전송 작업은
disable-model-invocation: true를 둡니다. - 기존
.claude/commands/<name>.md는 즉시 없앨 필요가 없지만, 새 작업은 Skills 형식으로 시작합니다.
실습
프로젝트에 읽기 전용 변경 요약 skill을 만듭니다.
.claude/skills/summarize-changes/SKILL.md
---
name: summarize-changes
description: 현재 git 변경을 요약하고 검토 위험을 찾습니다.
disable-model-invocation: true
allowed-tools: Bash(git diff *) Bash(git status *)
---
현재 변경사항을 읽고 다음 형식으로 정리하세요.
1. 변경 목적
2. 동작 위험
3. 추가로 확인할 테스트
추가 요청: $ARGUMENTS
Claude Code를 실행한 뒤 직접 호출합니다.
/summarize-changes 인증 흐름을 우선 확인해줘
$ARGUMENTS에는 skill 이름 뒤의 전체 입력이 들어갑니다. 위치별 인자가 필요하면 $0, $1 또는 $ARGUMENTS[0] 형식을 사용할 수 있습니다.
도구에 입력할 프롬프트
이 저장소에서 반복되는 작업을 찾아 Claude Code Skill 후보를 제안해줘.
각 후보에 대해 자동 호출이 안전한지 판단하고,
수동 호출이 필요하면 disable-model-invocation: true를 사용해줘.
공식 Skills 형식만 사용하고 문서에 없는 JSON registry는 만들지 마.
체크리스트
- 현재 명령 목록을
/help에서 확인했다. - 새 재사용 명령은
.claude/skills/<name>/SKILL.md에 만들었다. - 설명에는 언제 사용해야 하는지 적었다.
- 부작용이 있는 skill은 자동 호출을 막았다.
-
allowed-tools는 필요한 도구만 허용했다. - 저장소에서 받은 skill은 workspace trust 전에 내용을 검토했다.