AGENT DEVELOPMENT / Anthropic
Command Development for Claude Code
Explains how to write Claude Code slash-command files: frontmatter fields, $ARGUMENTS and positional arguments, @file references, inline Bash and plugin command patterns.
“This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.”
01 / THE REASONING
Why this made the selection.
- It covers the five command frontmatter fields it names (description, allowed-tools, model, argument-hint, disable-model-invocation) together with $ARGUMENTS, $1/$2 positional arguments, @file references and inline Bash.
- It gives the scope of each command location: .claude/commands/ for one project, ~/.claude/commands/ for every project, and a plugin's commands/ directory while that plugin is installed.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/plugin-dev/skills/command-development/SKILL.md
- plugins/plugin-dev/skills/command-development/README.md
- plugins/plugin-dev/README.md
- plugins/plugin-dev/LICENSE
- .claude-plugin/marketplace.json (name and plugin-dev entry)
Our findings
- The skill directory holds Markdown only (SKILL.md, README.md, examples/ and references/); it ships no script, and the SKILL.md frontmatter declares no allowed-tools.
- allowed-tools and model default to the conversation's settings when a command omits them; disable-model-invocation defaults to false.
- Commands are described as instructions for Claude, not messages to the user, and the SKILL.md shows a correct and an incorrect version of the same command.
- Plugin command patterns reach plugin files through ${CLAUDE_PLUGIN_ROOT}, for example !`node ${CLAUDE_PLUGIN_ROOT}/scripts/analyze.js $1`.
Not established by this review
- No command was written or invoked from this guidance.
- The seven files in references/ and the two files in examples/ were not opened, including references/plugin-features-reference.md and references/interactive-commands.md.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The plugin-dev README prints `/plugin install plugin-dev@claude-code-marketplace`. Its marketplace, claude-code-marketplace, is not the one this repository defines (claude-plugins-official, per .claude-plugin/marketplace.json), and the line installs all seven plugin-dev skills, command-development among them, so install.command is null.
- To load command-development from a local checkout instead, the same README prints `cc --plugin-dir /path/to/plugin-dev`.
- This review ran neither line.
Before you start
- Claude Code (the commands it describes are Claude Code slash commands)
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/command-development/SKILL.md
Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[2], limitations[3], limitations[4], compatibility, review.findings[0], review.findings[1], review.findings[2], review.findings[3], access.permissions[0], access.permissions[1], access.permissions[2]
- command-development README ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/command-development/README.md
Supports: review.findings[0]
- plugin-dev README ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md
Supports: install.sourceUrl, install.steps[0], install.steps[1], install.prerequisites[0], limitations[5], limitations[6], compatibility
- plugin-dev LICENSE ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE
Supports: license, limitations[5], access.cost
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json
Supports: limitations[6], install.steps[0]