Build Command Command

Create a new slash command for Claude Code.

Workflow

1. Invoke slash-command-builder reference for current patterns:

   • Read skills/claude-code-meta/references/slash-command-builder.md
   • Get: command structure, prompt engineering, when to use vs skills

2. Extract requirements:

   • What should the command do?
   • Is it interactive or deterministic?
   • Does it need parameters?

3. Plan command:

   • Choose command name (lowercase, hyphens, no spaces)
   • Design prompt/workflow
   • Determine if parameters needed

4. Create command file:

   touch plugins/<plugin-name>/commands/<command-name>.md
   

5. Write command:

   # Command Name
   
   Brief description of what this command does.
   
   ## Usage
   
   

   /command-name [optional-arg]

   
   ## What It Does
   
   1. [Step 1]
   2. [Step 2]
   3. [Return results]
   
   ## Example
   
   

   /command-name example-value

   
   Expected output: [describe]
   

6. Test command:

   • Invoke with /command-name
   • Verify parameters work
   • Check output format

7. Document:

   • Add to plugin CHANGELOG
   • List in plugin README
   • Add to marketplace docs if public

8. Validate:

   • Command name follows conventions
   • Markdown file in commands/ directory
   • Clear usage instructions
   • Example provided

9. Return:

   • Command path
   • Usage syntax
   • Test results

Criteria

Naming:

• Lowercase with hyphens
• Descriptive and concise
• No spaces or special chars

Structure:

• Markdown file in commands/
• Clear description and usage
• Examples included

When to Use Commands vs Skills:

• Commands: User-invoked, interactive workflows
• Skills: Model-invoked, contextual capabilities
• Use commands for explicit workflows
• Use skills for automatic activation

Best Practices:

• Keep commands focused and simple
• Provide clear usage examples
• Document expected inputs/outputs

See Also

• Full patterns: skills/claude-code-meta/references/slash-command-builder.md
• Testing: skills/claude-code-meta/references/command-testing.md
• Commands vs Skills: https://code.claude.com/docs/slash-commands