claude-code-slash-commands

# Slash Command Development Create custom slash commands for Claude Code. ## Quick Reference You MUST read these references for detailed guidance: - [Official Documentation](./references/official-docs.md) - 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 ```markdown --- description: Brief description of what this command does --- Your prompt instructions here. ``` ## Frontmatter Options ```yaml --- 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:** ```markdown Fix issue #$ARGUMENTS following our coding standards ``` **Positional arguments:** ```markdown 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): ```text 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](https://github.com/anthropics/claude-code/issues/12762). **File references** (prefix with at-sign): ```markdown Review the implementation in @src/utils/helpers.js ``` ## Namespacing Subdirectories group related commands: - `.claude/commands/frontend/test.md` → `/test` shows `(project:frontend)` - `.claude/commands/backend/test.md` → `/test` shows `(project:backend)` ## Checklist - [ ] Description filled in frontmatter - [ ] `argument-hint` if command takes arguments - [ ] `allowed-tools` if using Bash or specific tools - [ ] Test with `/command-name --help` style invocation