| name | command-creator |
| description | Create and configure custom commands for Opencode to automate repetitive tasks with custom prompts. |
Overview
The command-creator skill helps you define custom commands in Opencode. Custom commands let you specify prompts that run when you execute the command in the TUI with /command-name.
Creating Commands
Commands are defined using markdown files in the command/ directory:
- Global:
~/.config/opencode/command/<name>.md
- Per-project:
.opencode/command/<name>.md
The filename becomes the command name. Example: test.md creates /test.
Example: .opencode/command/test.md
---
description: Run tests with coverage
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
Frontmatter Options
| Option | Required | Description |
|---|
description | No | Brief description shown in TUI |
agent | No | Agent to execute (defaults to current) |
subtask | No | Force subagent invocation (true/false) |
model | No | Override default model |
The prompt template follows the frontmatter section.
Prompt Placeholders
Arguments
$ARGUMENTS - All arguments passed to the command$1, $2, $3... - Individual positional arguments
Example:
---
description: Create a new component
---
Create a React component named $ARGUMENTS with TypeScript support.
Usage: /component Button → $ARGUMENTS = Button
Shell Output
Use !`command` to inject bash output into prompts:
---
description: Analyze test coverage
---
Here are the current test results:
!`npm test`
Based on these results, suggest improvements to increase coverage.
File References
Use @filename to include file content in prompts:
---
description: Review component
---
Review @src/components/Button.tsx for performance issues.
Built-in Commands
Opencode includes built-in commands: /init, /undo, /redo, /share, /help. Custom commands can override these if they share the same name.
Usage
When the skill is triggered:
- Ask the user what command they want to create
- Determine if it should be global or project-specific
- Write the markdown file with frontmatter options and prompt
- Explain how to use the command
