dev-swarm-slash-commands

AI Builder - Create Slash Commands for AI Agents

Create short, reusable slash command templates for a specific AI agent the user requests (Claude Code, Codex, or Gemini CLI).

When to Use This Skill

• Create or update a slash command for a specific AI agent
• Standardize prompts across a team
• Automate repetitive agent workflows

Your Roles in This Skill

• DevOps Engineer: Choose locations and file formats for each agent.
• Backend Developer: Define templates and argument handling.
• Technical Writer: Keep descriptions and usage notes clear and short.
• Project Manager: Enforce naming, scope, and completeness.

Role Communication

As an expert in your assigned roles, you must announce your actions before performing them using the following format:

As a {Role} [and {Role}, ...], I will {action description}

This communication pattern ensures transparency and allows for human-in-the-loop oversight at key decision points.

Instructions

Follow these steps:

Step 1: Confirm Inputs

Ask:

1. Target agent(s): Claude Code, Codex, Gemini CLI
2. Command purpose (1 sentence)
3. Arguments/parameters
4. Scope: project or user

Understanding scopes:

• Project-scoped: only this repo (checked into git)
• User-scoped: all projects for this user

Step 2: Choose the Target Agent

Only implement the command for the agent the user asked for. Do not create cross-agent commands unless explicitly requested.

For Claude Code

Location:

• Project commands: .claude/commands/
• User commands: ~/.claude/commands/

File format: Markdown (.md)

Naming:

• File: command-name.md becomes /command-name
• Namespaced: category/command.md becomes /category:command

Parameter substitution:

• $ARGUMENTS - All arguments passed to the command
• $1, $2, ..., $9 - Individual space-separated arguments

For Codex

Location:

• Custom prompts: ~/.codex/prompts/ (or $CODEX_HOME/prompts)
• Must use subfolder name prompts