command-creator
This skill should be used when creating a Claude Code slash command
Install / Use
npx skills add softaworks/agent-toolkit --skill command-creatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of command-creator
command-creator scores 82/100 on our quality scale, 2286th of 2,790 Automation skills we index.
Its SKILL.md is 6.8 KB long, well organised into 19 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 2,502 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 9 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-07 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 94/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
command-creator compared with similar skills
All 4 of these similar skills score higher than command-creator; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| command-creator (this skill)by softaworks | 82 | 2.5k | 9mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install command-creator?
- Run
npx skills add softaworks/agent-toolkit --skill command-creator. The install tabs above show the steps for each supported agent. - Which AI agents does command-creator work with?
- It is written for Claude Code and Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is command-creator safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 94/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is command-creator still maintained?
- The repository was last updated about 9 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: 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/patterns.md - Command patterns (workflow automation, iterative fixing, agent delegation, simple execution)
- 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]
Command Creation Workflow
Step 1: Determine Location
Auto-detect the appropriate location:
- Check git repository status:
git rev-parse --is-inside-work-tree 2>/dev/null - Default location:
- If in git repo → Project-level:
.claude/commands/ - If not in git repo → Global:
~/.claude/commands/
- If in git repo → Project-level:
- Allow user override:
- If user explicitly mentions "global" or "user-level" → Use
~/.claude/commands/ - If user explicitly mentions "project" or "project-level" → Use
.claude/commands/
- If user explicitly mentions "global" or "user-level" → Use
Report the chosen location to the user before proceeding.
Step 2: Show Command Patterns
Help the user understand different command types. Load references/patterns.md to see available patterns:
- Workflow Automation - Analyze → Act → Report (e.g., submit-stack)
- Iterative Fixing - Run → Parse → Fix → Repeat (e.g., ensure-ci)
- Agent Delegation - Context → Delegate → Iterate (e.g., create-implementation-plan)
- Simple Execution - Run command with args (e.g., codex-review)
Ask the user: "Which pattern is closest to what you want to create?" This helps frame the conversation.
Step 3: Gather Command Information
Ask the user for key information:
A. Command Name and Purpose
Ask:
- "What should the command be called?" (for filename)
- "What does this command do?" (for description field)
Guidelines:
- Command names MUST be kebab-case (hyphens, NOT underscores)
- ✅ CORRECT:
submit-stack,ensure-ci,create-from-plan - ❌ WRONG:
submit_stack,ensure_ci,create_from_plan
- ✅ CORRECT:
- File names match command names:
my-command.md→ invoked as/my-command - Description should be concise, action-oriented (appears in
/helpoutput)
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
- Project:
-
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,gtcommands - 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.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
