slash-command-creator
Guide for creating Codex CLI slash commands. Use when the user wants to create a new slash command, update an existing slash command, or asks about slash command syntax, frontmatter options, or best practices.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Slash Command Creator
Create custom slash commands for Claude Code to automate frequently-used prompts.
Quick Start
Initialize a new command:
scripts/init_command.py <command-name> [--scope project|personal]
Command Structure
Slash commands are Markdown files with optional YAML frontmatter:
---
description: Brief description shown in /help
---
Your prompt instructions here.
$ARGUMENTS
File Locations
| Scope | Path | Shown as |
|---|---|---|
| Project | .claude/commands/ |
(project) |
| Personal | ~/.claude/commands/ |
(user) |
Namespacing
Organize commands in subdirectories:
-
.claude/commands/frontend/component.md→/componentshows "(project:frontend)" -
~/.claude/commands/backend/api.md→/apishows "(user:backend)"
Features
Arguments
All arguments - $ARGUMENTS:
Fix issue #$ARGUMENTS following our coding standards
# /fix-issue 123 → "Fix issue #123 following..."
Positional - $1, $2, etc.:
Review PR #$1 with priority $2
# /review 456 high → "Review PR #456 with priority high"
Bash Execution
Execute shell commands with ! prefix (requires allowed-tools in frontmatter):
---
allowed-tools: Bash(git status:*), Bash(git diff:*)
---
Current status: !`git status`
Changes: !`git diff HEAD`
File References
Include file contents with @ prefix:
Review @src/utils/helpers.js for issues.
Compare @$1 with @$2.
Frontmatter Options
| Field | Purpose | Required |
|---|---|---|
description |
Brief description for /help | Yes |
allowed-tools |
Tools the command can use | No |
argument-hint |
Expected arguments hint | No |
model |
Specific model to use | No |
disable-model-invocation |
Prevent SlashCommand tool invocation | No |
See references/frontmatter.md for detailed reference.
Examples
See references/examples.md for complete examples including:
- Simple review/explain commands
- Commands with positional arguments
- Git workflow commands with bash execution
- Namespaced commands for frontend/backend
Creation Workflow
- Identify the use case: What prompt do you repeat often?
- Choose scope: Project (shared) or personal (private)?
-
Initialize: Run
scripts/init_command.py <name> - Edit: Update description and body
- Test: Run the command in Claude Code
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!