| name | customize-opencode |
| description | Customize opencode configuration, theme, keybindings, and agent settings. Use when modifying dreamcode/opencode behavior, adding custom agents, or adjusting system preferences. |
| chains_with | ["documentation","architecture"] |
Customize OpenCode Skill
Mandate
When customizing opencode, always back up existing configuration before modifying.
Test configuration changes incrementally. Verify that changes don't break existing
agent workflows or skill chains.
Trigger Conditions
- User wants to modify opencode behavior
- Adding custom agents or tools
- Changing keybindings or theme
- Adjusting model settings or provider configuration
- Modifying permission policies
Process
- Read current config: Load
dreamcode.json or .opencode/config.json
- Identify the change: What specific behavior is being customized?
- Apply surgically: Make minimal, targeted changes to config
- Verify: Check that existing functionality still works
- Document: Note the change in config comments or changelog
Config Locations
- Project config:
.dreamcode/dreamcode.json or .opencode/config.json
- Global config:
~/.config/dreamcode/config.json
- Agent config:
.dreamcode/agents/*.json
- Skill config:
.dreamcode/skills/*/SKILL.md
Safety Rules
- Never delete config without explicit user confirmation
- Always preserve required fields (model, provider settings)
- Test agent behavior after config changes
- Keep a rollback path for destructive changes
