Command Development Skill

Comprehensive guidance on creating Claude Code slash commands, including file format, frontmatter options, dynamic arguments, and best practices.

Overview

This skill provides knowledge about:

• Slash command file format and structure
• YAML frontmatter configuration fields
• Dynamic arguments ($ARGUMENTS, $1, $2, etc.)
• File references with @ syntax
• Bash execution with !` syntax
• Command organization and namespacing
• Best practices for command development
• Plugin-specific features (${CLAUDE_PLUGIN_ROOT}, plugin patterns)
• Integration with plugin components (agents, skills, hooks)
• Validation patterns and error handling

Skill Structure

SKILL.md (~2,470 words)

Core skill content covering:

Fundamentals:

• Command basics and locations
• File format (Markdown with optional frontmatter)
• YAML frontmatter fields overview
• Dynamic arguments ($ARGUMENTS and positional)
• File references (@ syntax)
• Bash execution (!` syntax)
• Command organization patterns
• Best practices and common patterns
• Troubleshooting

Plugin-Specific:

• ${CLAUDE_PLUGIN_ROOT} environment variable
• Plugin command discovery and organization
• Plugin command patterns (configuration, template, multi-script)
• Integration with plugin components (agents, skills, hooks)
• Validation patterns (argument, file, resource, error handling)

References

Detailed documentation:

• frontmatter-reference.md: Complete YAML frontmatter field specifications

  • All field descriptions with types and defaults
  • When to use each field
  • Examples and best practices
  • Validation and common errors

• plugin-features-reference.md: Plugin-specific command features

  • Plugin command discovery and organization
  • ${CLAUDE_PLUGIN_ROOT} environment variable usage
  • Plugin command patterns (configuration, template, multi-script)
  • Integration with plugin agents, skills, and hooks
  • Validation patterns and error handling

Examples

Practic