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

---
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

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 → /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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: dwmkerr
• Source: dwmkerr/claude-toolkit
• License: MIT
• Homepage: https://www.skills.sh/dwmkerr/claude-toolkit

Install and usage instructions live in the source repository linked above.