slash-command

Slash commands are markdown files that define reusable prompts for Claude Code.

File Location

• Project commands: .claude/commands/*.md - shared via version control
• Personal commands: ~/.claude/commands/*.md - user-specific

The filename (without .md) becomes the command name: fix-lint.md → /fix-lint

File Format

---
allowed-tools: Read, Grep, Bash(git:*)
argument-hint: [file] [options]
description: Short description shown in /help
model: claude-sonnet-4-5-20250929
---

Command instructions here. Use $ARGUMENTS for all args or $1, $2 for positional.

Frontmatter Fields (all optional)

| Field | Purpose | |-------|---------| | allowed-tools | Restrict which tools the command can use | | argument-hint | Show expected arguments in help (e.g., [filename]) | | description | Description shown in /help output | | model | Override model (e.g., claude-3-5-haiku-20241022 for fast tasks) |

Dynamic Content

Arguments

• $ARGUMENTS - all arguments as single string
• $1, $2, etc. - positional arguments

Bash Output

Include shell command output using the bang-backtick syntax.

Syntax: Place an exclamation mark immediately before a backtick-wrapped command.

Examples in a command file:

Current branch: (BANG)(TICK)git branch --show-current(TICK)
Changes: (BANG)(TICK)git diff --stat(TICK)

Where BANG = exclamation mark and TICK = backtick character.

File Contents

Use @filepath to include file contents:

Review this config: @tsconfig.json

Namespacing

Subdirectories organize commands:

.claude/commands/
├── git/
│   ├── commit.md     # /commit (project:git)
│   └── pr.md         # /pr (project:git)
└── test.md           # /test (project)

Examples

Simple command

---
description: Run all tests
---
Run the test suite and fix any failures.

With arguments and tool restrictions

---
allowed-tools: Bash(npm test:*), Read, Edit
argument-hint: [test-pattern]
description: Run tests matching pattern
---
Run tests matching: $ARGUMENTS

If tests fail, analyze and fix them.