slash-command

name	slash-command
description	Create and edit Claude Code slash commands. Use when the user wants to create a new slash command, add a custom command, or modify an existing command in .claude/commands/.

Creating Slash Commands

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.