This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable com
Install
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add softaworks/agent-toolkit --skill command-creator -a cursor -y
This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
Questions
How do I install command-creator?
Download dist/plugins/command-creator/skills/command-creator/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does command-creator live?
The publisher keeps it at https://github.com/softaworks/agent-toolkit.
Which agents can use command-creator?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.
This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
name: command-creator
description: This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
Command Creator
This skill guides the creation of Claude Code slash commands - reusable workflows that can be invoked with /command-name in Claude Code conversations.
About Slash Commands
Slash commands are markdown files stored in .claude/commands/ (project-level) or ~/.claude/commands/ (global/user-level) that get expanded into prompts when invoked. They're ideal for:
Repetitive workflows (code review, PR submission, CI fixing)
Multi-step processes that need consistency
Agent delegation patterns
Project-specific automation
When to Use This Skill
Invoke this skill when users:
Ask to "create a command" or "make a slash command"
Want to automate a repetitive workflow
Need to document a consistent process for reuse
Say "I keep doing X, can we make a command for it?"
Want to create project-specific or global commands
Bundled Resources
This skill includes reference documentation for detailed guidance:
references/examples.md - Real command examples with full source (submit-stack, ensure-ci, create-implementation-plan)
references/best-practices.md - Quality checklist, common pitfalls, writing guidelines, template structure
Load these references as needed when creating commands to understand patterns, see examples, or ensure quality.
Command Structure Overview
Every slash command is a markdown file with:
---
description: Brief description shown in /help (required)
argument-hint: <placeholder> (optional, if command takes arguments)
---
# Command Title
[Detailed instructions for the agent to execute autonomously]
File names match command names: my-command.md → invoked as /my-command
Description should be concise, action-oriented (appears in /help output)
B. Arguments
Ask:
"Does this command take any arguments?"
"Are arguments required or optional?"
"What should arguments represent?"
If command takes arguments:
Add argument-hint: <placeholder> to frontmatter
Use <angle-brackets> for required arguments
Use [square-brackets] for optional arguments
C. Workflow Steps
Ask:
"What are the specific steps this command should follow?"
"What order should they happen in?"
"What tools or commands should be used?"
Gather details about:
Initial analysis or checks to perform
Main actions to take
How to handle results
Success criteria
Error handling approach
D. Tool Restrictions and Guidance
Ask:
"Should this command use any specific agents or tools?"
"Are there any tools or operations it should avoid?"
"Should it read any specific files for context?"
Step 4: Generate Optimized Command
Create the command file with agent-optimized instructions. Load references/best-practices.md for:
Template structure
Best practices for agent execution
Writing style guidelines
Quality checklist
Key principles:
Use imperative/infinitive form (verb-first instructions)
Be explicit and specific
Include expected outcomes
Provide concrete examples
Define clear error handling
Step 5: Create the Command File
Determine full file path:
Project: .claude/commands/[command-name].md
Global: ~/.claude/commands/[command-name].md
Ensure directory exists:
mkdir -p [directory-path]
Write the command file using the Write tool
Confirm with user:
Report the file location
Summarize what the command does
Explain how to use it: /command-name [arguments]
Step 6: Test and Iterate (Optional)
If the user wants to test:
Suggest testing: You can test this command by running: /command-name [arguments]
Be ready to iterate based on feedback
Update the file with improvements as needed
Quick Tips
For detailed guidance, load the bundled references:
Load references/patterns.md when designing the command workflow
Load references/examples.md to see how existing commands are structured
Load references/best-practices.md before finalizing to ensure quality
Common patterns to remember:
Use Bash tool for pytest, pyright, ruff, prettier, make, gt commands
Use Task tool to invoke subagents for specialized tasks
Check for specific files first (e.g., .PLAN.md) before proceeding
Mark todos complete immediately, not in batches
Include explicit error handling instructions
Define clear success criteria
Summary
When creating a command:
Detect location (project vs global)
Show patterns to frame the conversation
Gather information (name, purpose, arguments, steps, tools)
Generate optimized command with agent-executable instructions
Create file at appropriate location
Confirm and iterate as needed
Focus on creating commands that agents can execute autonomously, with clear steps, explicit tool usage, and proper error handling.
How do I install command-creator?
Download dist/plugins/command-creator/skills/command-creator/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does command-creator live?
The publisher keeps it at https://github.com/softaworks/agent-toolkit.
Which agents can use command-creator?
Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.