create-command

Create Command Skill

Create new Claude Code slash commands with proper configuration and advanced features.

Command Types

Project Commands

Commands stored in your repository and shared with your team.

Location: .claude/commands/ or plugins/<plugin>/commands/

Shows "(project)" in /help.

Personal Commands

Commands available across all your projects.

Location: ~/.claude/commands/

Shows "(user)" in /help.

Command File Format

Commands are markdown files with YAML frontmatter:

---
description: Short description shown in /help
argument-hint: <required-arg> [optional-arg]
---

# Command Name

Instructions for Claude when this command is invoked...

Frontmatter Fields

Field	Purpose	Default
description	Brief description of the command	Uses first line from prompt
argument-hint	Arguments shown in autocomplete	None
allowed-tools	List of tools the command can use	Inherits from conversation
model	Specific model string	Inherits from conversation
disable-model-invocation	Prevent SlashCommand tool from calling	false

Argument Placeholders

All Arguments: $ARGUMENTS

Captures all arguments passed to the command:

---
description: Fix a GitHub issue
argument-hint: <issue-number> [priority]
---

Fix issue #$ARGUMENTS following our coding standards.

# Usage: /fix-issue 123 high-priority
# $ARGUMENTS becomes: "123 high-priority"

Positional Arguments: $1, $2, etc.

Access specific arguments individually:

---
description: Review pull request
argument-hint: <pr-number> <priority> <assignee>
---

Review PR #$1 with priority $2 and assign to $3.
Focus on security, performance, and code style.

# Usage: /review-pr 456 high alice
# $1 = "456", $2 = "high", $3 = "alice"

Bash Command Execution

Execute bash commands before the slash command runs using the ! prefix.

IMPORTANT: You MUST include allowed-tools with the Bash tool.