01-개념

01. 개념 — 슬래시 커맨드 = 저장된 프롬프트

David Taylor의 한 줄이 전부다.

“Custom slash commands are essentially saved prompts that you can invoke with a simple /command_name syntax. They can be stored as Markdown files in your project, which means they can be version-controlled and shared with others.”
의역: “커스텀 슬래시 커맨드는 본질적으로 /이름으로 부를 수 있는 저장된 프롬프트다. 마크다운 파일로 저장되므로 버전 관리와 공유가 가능하다.”
— Cloudartisan, Claude Code Tips & Tricks: Custom Slash Commands

이 단순함이 핵심이다. 슬래시 커맨드는 “프로그래밍”이 아니라 “프롬프트의 재사용”이다. 그래서 첫 단계로는 자기가 매주 3번 이상 똑같이 치는 자연어부터 명령으로 만든다.

두 종류

스코프	위치	호출
Project	.claude/commands/이름.md	/project:이름 또는 /이름
User	~/.claude/commands/이름.md	모든 프로젝트에서 /user:이름 또는 /이름

서브디렉토리는 네임스페이스가 된다 — .claude/commands/posts/new.md → /project:posts:new.

”최소”가 미덕이다

sshh는 명령을 두 개만 갖는다 — /catchup, /pr. 그가 적은 한 줄을 외워두면 거의 모든 안티패턴을 피할 수 있다.

“If you have a long list of complex, custom slash commands, you’ve created an anti-pattern.”
의역: “복잡한 커스텀 슬래시 커맨드 목록이 길다면, 그것 자체가 안티패턴이다.”

이유는 두 가지다. (1) 명령이 많아질수록 다른 사람이 학습해야 할 곡선이 생긴다. (2) 명령이 곧 인터페이스가 되면, 자연어로 충분히 풀릴 일도 명령을 찾게 된다.

명령 ↔ 스킬 통합

2025년 말부터 슬래시 커맨드와 스킬은 같은 시스템이다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 둘 다 /deploy를 만든다. 차이는 단 하나 — 스킬은 자동 invoke와 보조 파일 디렉토리를 갖는다. 그 외에는 동일하다. 이 챕터는 명령 입장에서, 05장은 스킬 입장에서 본다.