Guide for creating user-invocable slash commands. Use when the user asks to "create a command", "slash command", "write a command", "$ARGUMENTS", "dynamic arguments", or "@ file references".
From claude-plugin-devnpx claudepluginhub nthplusio/functional-claude --plugin claude-plugin-devThis skill uses the workspace's default tool permissions.
references/cache.mdExecutes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Guide for creating slash commands that users invoke with /command-name.
my-plugin/
└── commands/
└── command-name.md
---
name: my-command
description: What this command does (shown in /help)
allowed-tools: Bash, Read, Write
model: sonnet
---
# Command Title
Instructions Claude follows when user runs /my-command.
| Field | Required | Description |
|---|---|---|
name | No | Override command name (defaults to filename) |
description | Yes | Shown in /help listing |
allowed-tools | No | Auto-approved tools when command active |
model | No | Model override (sonnet, opus, haiku) |
context | No | fork to run in subagent |
Search the codebase for: $ARGUMENTS
Usage: /search error handling → "Search the codebase for: error handling"
Compare these files:
- First: $1
- Second: $2
Usage: /compare foo.js bar.js
Commands can reference files in the command directory:
Follow the checklist in @checklist.md to set up this project.
@filename.md — Same directory as command@subdir/file.md — Relative path from commandUse ${CLAUDE_PLUGIN_ROOT} for absolute paths to plugin files:
Run validation using:
```bash
node "${CLAUDE_PLUGIN_ROOT}/scripts/validate.js"
## Commands vs Skills
| Aspect | Commands | Skills |
|--------|----------|--------|
| Invocation | User only (`/name`) | Claude or user |
| Purpose | Specific actions | Knowledge/guidance |
| Format | Direct instructions | Conceptual guidance |
| Arguments | $ARGUMENTS, $1, $2 | Rare |
| Location | `commands/` | `skills/` |