name: claude-code-slash-commands description: This skill should be used when the user asks to "create a command", "write a slash command", "build a plugin command", or wants to add custom commands to Claude Code.
Slash Command Development
Create custom slash commands for Claude Code.
Quick Reference
You MUST read these references for detailed guidance:
- Official Documentation - Anthropic's slash command guide
Command Structure
Commands are Markdown files in specific locations:
| Scope | Location | Description suffix |
|---|---|---|
| Project | .claude/commands/ | (project) |
| Personal | ~/.claude/commands/ | (user) |
| Plugin | commands/ in plugin root | (plugin) |
Basic Command
---
description: Brief description of what this command does
---
Your prompt instructions here.
Frontmatter Options
---
allowed-tools: Bash(git:*), Read
argument-hint: [filename] [options]
description: What this command does
model: claude-3-5-haiku-20241022
disable-model-invocation: false
context: fork
---
| Field | Purpose |
|---|---|
allowed-tools | Tools the command can use |
argument-hint | Shows in autocomplete (e.g., [message]) |
description | Brief description (required for SlashCommand tool) |
model | Specific model to use |
disable-model-invocation | Prevent programmatic invocation |
context: fork | Run in isolated sub-agent context, preventing side effects on main agent state |
Arguments
All arguments:
Fix issue #$ARGUMENTS following our coding standards
Positional arguments:
Review PR #$1 with priority $2 and assign to $3
Dynamic Content
<!-- NOTE: Avoid isolated special chars in backticks due to bug #12762 --> <!-- See: https://github.com/anthropics/claude-code/issues/12762 -->Bash execution (prefix with exclamation mark):
Current branch: EXCLAMATION`git branch --show-current`
Recent commits: EXCLAMATION`git log --oneline -5`
Replace EXCLAMATION with the exclamation mark character - workaround for bug #12762.
File references (prefix with at-sign):
Review the implementation in @src/utils/helpers.js
Namespacing
Subdirectories group related commands:
.claude/commands/frontend/test.md→/testshows(project:frontend).claude/commands/backend/test.md→/testshows(project:backend)
Checklist
- Description filled in frontmatter
-
argument-hintif command takes arguments -
allowed-toolsif using Bash or specific tools - Test with
/command-name --helpstyle invocation