← Explore all skills

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.

Upstream setup instructions ↗
  1. 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.
  2. To load command-development from a local checkout instead, the same README prints `cc --plugin-dir /path/to/plugin-dev`.
  3. 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.

  1. 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]

  2. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/command-development/README.md

    Supports: review.findings[0]

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

  4. plugin-dev LICENSE ↗Checked

    https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE

    Supports: license, limitations[5], access.cost

  5. https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json

    Supports: limitations[6], install.steps[0]

Evidence & Ask