Command Creator

Overview

This skill guides the creation of Claude Code commands through a structured workflow that ensures proper skill integration, argument definition, and command specification. Commands can leverage existing skills or operate standalone.

Target Audience: This skill is designed for agents creating Claude Code command specifications. It provides procedural knowledge for gathering requirements, discovering relevant skills, and generating well-structured command definitions that other agents will execute.

Command Creation Workflow

Follow these steps sequentially to create a well-defined Claude Code command:

Step 1: Understand Command Purpose

Ask the user what the command should do. Gather specific details about:

• The task or operation the command will perform
• Expected inputs and outputs
• Any special requirements or constraints

Example questions:

• "What should this command do?"
• "Can you describe a typical use case for this command?"
• "What would trigger the use of this command?"

Step 2: Identify Skill Dependencies

Ask if the command relates to existing skills:

• "Is this command based on any existing skills?"
• "Does this command use specific file formats, workflows, or domain knowledge?"

If the user mentions skills, note them. If not, proceed to Step 3.

Step 3: Discover Relevant Skills

Check available skills to identify potentially relevant ones the user may have missed:

view .claude/skills    # Current project skills (if available)
view ~/.claude/skills  # Global skills (if available)

Look for skills related to:

• File types the command will process (docx, pdf, xlsx, pptx)
• Domain expertise (frontend-design, product-self-knowledge)
• Workflows or patterns (skill-creator, mcp-builder)

Present relevant skills to the user:

• "I found these skills that might be relevant: [list]. Should any of these be included?"
• Be concise; only mention skills with clear relevance

Step 4: Verify Command Specification

If the command is not skill-based or after skill selection is complete, verify the command specification:

• Summarize what the command will do
• Confirm the workflow or operation sequence
• Verify any constraints or requirements

Ask for confirmation:

• "To confirm, the command will [summary]. Is this correct?"
• "Are there any other requirements I should know about?"

Step 5: Define Command Arguments

Determine the command arguments through discussion:

• "What arguments should this command accept?"
• "Are any arguments required vs optional?"
• "What are the valid values or types for each argument?"

For each argument, specify:

• Name and type
• Required vs optional status
• Default value (if optional)
• Description of purpose
• Valid values or validation rules

Step 6: Generate Command Specification

Create the command specification as a single Markdown file with YAML front matter.

For detailed format specification, patterns, and examples, see:

• references/command-patterns.md - Complete format guide, argument types, validation patterns, and multiple command pattern examples
• references/optimize-images-example.md - Production-ready example with full workflow, error handling, and statistics
• ../../commands/audit/js-ts-docs.md - Real production command for reference

Best Practices

Command Naming:

• Use lowercase with hyphens: audit-performance, create-component
• Be descriptive but concise
• Avoid generic names like process or handle

Argument Design:

• Minimize required arguments
• Provide sensible defaults for optional arguments
• Use clear, unambiguous argument names
• Validate argument values when possible

Skill Integration:

• Reference skills by name in the skills array
• Include skill names in command description when relevant
• Ensure referenced skills actually exist in /mnt/skills/

Documentation:

• Provide at least 2 usage examples
• Document argument constraints clearly
• Include implementation notes for complex commands