Claude Code Custom Command

기본 slash command

• https://code.claude.com/docs/en/slash-commands

커스텀 slash command 만들기

파일 위치

• 전체 적용 : ~/.claude/commands

• Project 별 적용 : 프로젝트 루트의 .claude/commands

커맨드 만들기

슬래시 이후에 쓸 커맨드 이름으로 마크다운 파일을 만든다.

mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities:" > ~/.claude/commands/security-review.md

git commit message를 만들어주고 commit / push

vi git-commit.md

---
title: git add, commit, push
# allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
model: haiku
---

## git commit message를 만들어주고 commit / push

git에 commit할 commit message를 만든다.

이제 commit 및 push를 하자.

git add --all && git commit -m "$message" && git push

$message에 적당한 메세지를 추가해줘

arguments 사용하기

$ARGUMENTS 변수를 사용하여 커맨드에 인자를 전달할 수 있다.

echo 'Fix issue #$ARGUMENTS following our coding standards' > fix-issue.md

개별 arguments with $1, $2

$1, $2 등을 사용하여 개별 인자에 접근할 수 있다.

echo 'Review PR #$1 with priority $2 and assign to $3' > .claude/commands/review-pr.md

/review-pr 456 high alice

bash 사용

슬래시 명령이 실행되기 전에 !접두사를 사용하여 bash 명령을 실행합니다.

allowed-tools 메타데이터 필드를 사용하여 특정 bash 명령을 허용할 수도 있습니다.

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Create a git commit
---

## Context

- Current git status: !`git status`
- Current git diff (staged and unstaged changes): !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -10`

## Your task

Based on the above changes, create a single git commit.

파일 참조

md에서 @을 사용해서 경로를 적으면 파일을 참조할수 있다.

# Reference a specific file

Review the implementation in @src/utils/helpers.js

# Reference multiple files

Compare @src/old-version.js with @src/new-version.js

frontmatter 메타데이터

속성	설명	기본값
allowed-tools	커맨드에서 사용할 수 있는 도구 목록	대화에서 상속
argument-hint	슬래시 커맨드에 대한 인자 힌트. 예: argument-hint: add [tagId] | remove [tagId] | list. 사용자가 슬래시 커맨드를 자동완성할 때 표시됨	None
description	커맨드에 대한 간단한 설명	prompt의 첫 번째 줄을 사용
model	특정 모델 문자열 (Models overview 참조)	대화에서 상속
disable-model-invocation	SlashCommand 도구가 이 커맨드를 호출하는 것을 방지할지 여부	false

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Create a git commit
model: haiku
---

Create a git commit with message: $ARGUMENTS

Example using positional arguments:

---
argument-hint: [pr-number] [priority] [assignee]
description: Review pull request
---

Review PR #$1 with priority $2 and assign to $3.
Focus on security, performance, and code style.

사용

/command-name arg1 arg2

mcp를 slash command로 사용하기

/mcp__<server-name>__<prompt-name> [arguments]

보통 자동으로 실행됨.

예시

# 인수 없음
> /mcp__github__list_prs

# 인수 포함
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "Bug title" high

자동화

claude가 자동으로 slash command를 실행할수 있다.

다음처럼 prompt를 작성해라

Claude가 SlashCommand 도구를 트리거하도록 권장하려면 지침 (prompt, CLAUDE.md 등)이 일반적으로 슬래시와 함께 명령어 이름을 참조해야 합니다.

claude가 자동으로 호출하는것을 막으려면

---

title: test
disable-model-invocation: true

이렇게 사용한다.

slash command vs skills

슬래시 명령어 (Slash Commands)

사용 대상: 빠르고 자주 사용하는 프롬프트

특징:

• 간단한 프롬프트 스니펫

• 빠른 미리 알림 또는 템플릿

• 한 파일에 맞는 자주 사용하는 지침

예시:

• /review → "Review this code for bugs and suggest improvements"

• /explain → "Explain this code in simple terms"

• /optimize → "Analyze this code for performance issues"

스킬 (Skills)

사용 대상: 구조가 있는 포괄적인 기능

특징:

• 여러 단계가 있는 복잡한 워크플로우

• 스크립트 또는 유틸리티가 필요한 기능

• 여러 파일에 걸쳐 구성된 지식

• 표준화하려는 팀 워크플로우

예시:

• 양식 작성 스크립트 및 검증이 있는 PDF 처리 스킬

• 다양한 데이터 유형에 대한 참조 문서가 있는 데이터 분석 스킬

• 스타일 가이드 및 템플릿이 있는 문서 스킬

주요 차이점

측면	슬래시 명령어	에이전트 스킬
복잡성	간단한 프롬프트	복잡한 기능
구조	단일 .md 파일	SKILL.md + 리소스가 있는 디렉토리
발견	명시적 호출 (/command)	자동 (컨텍스트 기반)
파일	한 파일만	여러 파일, 스크립트, 템플릿

예제 비교

슬래시 명령어로

파일 구조:

.claude/commands/review.md

내용:

Review this code for:

- Security vulnerabilities
- Performance issues
- Code style violations

사용법: /review (수동 호출)

skill

파일 구조:

.claude/skills/code-review/
├── SKILL.md (overview and workflows)
├── SECURITY.md (security checklist)
├── PERFORMANCE.md (performance patterns)
├── STYLE.md (style guide reference)
└── scripts/
    └── run-linters.sh

사용법: "Can you review this code?" (자동 발견)

결론: 스킬은 더 풍부한 컨텍스트, 검증 스크립트 및 구성된 참조 자료를 제공합니다.

나의 결론

나는 아직 잘 구분이 안됨. /command는 항상 내가 필요할때 강제로 요청 claude가 자동으로 이걸 사용하면 skills와 비슷한거같음.

둘다 비슷한거같음.