dev-swarm-slash-commands
Create custom slash commands for popular AI agents (Claude Code, Codex, Gemini CLI). Use when user asks to create slash commands, custom commands, or reusable prompts for AI agent CLIs.
When & Why to Use This Skill
This Claude skill empowers developers to design, implement, and manage custom slash commands for leading AI agent CLIs, including Claude Code, Codex, and Gemini CLI. By automating the creation of reusable prompt templates and standardized command structures, it significantly enhances developer productivity, ensures prompt consistency across engineering teams, and simplifies complex, multi-step agent workflows into efficient, single-word commands.
Use Cases
- Standardizing Team Workflows: Create and distribute project-scoped slash commands to ensure all team members use the same high-quality prompts for code reviews and documentation.
- Automating Repetitive Tasks: Package complex multi-step instructions—such as creating a branch, staging files, and drafting a PR—into a single /command for Codex or Claude Code.
- Context-Aware Analysis: Build custom Gemini CLI commands that automatically inject local documentation or best-practice guides into the prompt context using file loaders.
- Cross-Agent Prompt Management: Efficiently manage different configuration formats (Markdown for Claude/Codex, TOML for Gemini) from a single interface to maintain a unified developer experience.
| name | dev-swarm-slash-commands |
|---|---|
| description | Create custom slash commands for popular AI agents (Claude Code, Codex, Gemini CLI). Use when user asks to create slash commands, custom commands, or reusable prompts for AI agent CLIs. |
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:
- Target agent(s): Claude Code, Codex, Gemini CLI
- Command purpose (1 sentence)
- Arguments/parameters
- 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.mdbecomes/command-name - Namespaced:
category/command.mdbecomes/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
Codex does not support project level commands
File format: Markdown (.md)
---
description: Prep a branch, commit, and open a draft PR
argument-hint: [FILES=<paths>] [PR_TITLE="<title>"]
---
Create a branch named `dev/<feature_name>` for this work.
If files are specified, stage them first: $FILES.
Commit the staged changes with a clear message.
Open a draft PR on the same branch. Use $PR_TITLE when supplied; otherwise write a concise summary yourself.
Add metadata and arguments
Codex reads prompt metadata and resolves placeholders the next time the session starts.
- Description: Shown under the command name in the popup. Set it in YAML front matter as description:.
- Argument hint: Document expected parameters with argument-hint: KEY=.
- Positional placeholders: $1 through $9 expand from space-separated arguments you provide after the command. $ARGUMENTS includes them all.
- Named placeholders: Use uppercase names like $FILE or $TICKET_ID and supply values as KEY=value. Quote values with spaces (for example, FOCUS="loading state").
- Literal dollar signs: Write $$ to emit a single $ in the expanded prompt.
Naming:
- Commands invoked as
/prompts:<name> - File
review-code.mdbecomes/prompts:review-code
Parameter types:
- Positional arguments:
$1through$9- Usage:
/prompts:mycommand arg1 arg2 arg3
- Usage:
- All arguments:
$ARGUMENTS- Gets all space-separated arguments
- Named placeholders:
$FILE,$TICKET_ID(uppercase)- Usage:
/prompts:mycommand FILE=app.js TICKET_ID=123 - Quote values with spaces:
FILE="my file.js"
- Usage:
For Gemini CLI
Location:
- User commands:
~/.gemini/commands/ - Project commands:
.gemini/commands/
File format: TOML (.toml)
# In: <project>/.gemini/commands/review.toml
# Invoked via: /review FileCommandLoader.ts
description = "Reviews the provided context using a best practice guide."
prompt = """
You are an expert code reviewer.
Your task is to review {{args}}.
Use the following best practices when providing your review:
@{docs/best-practices.md}
When you run /review FileCommandLoader.ts, the @{docs/best-practices.md} placeholder is replaced by the content of that file, and {{args}} is replaced by the text you provided, before the final prompt is sent to the model.