config-tuning

name	config-tuning
description	>- Use when this capability is needed.

Config Tuning

Analyze and improve OpenCode configuration based on observed patterns.

Announce: "I'm using config-tuning to analyze this pattern and propose config improvements."

When to Use

• User describes a pattern they noticed (good or bad)
• User asks to improve agent behavior
• User wants to add a new workflow or skill
• After noticing repeated friction in workflows

Process

Phase 1: Understand the Pattern

Ask clarifying questions if needed:

• What behavior did you observe?
• When does this happen?
• What would you prefer instead?

Phase 2: Analyze Current Config

Read relevant files:

opencode.jsonc           # Main config
AGENTS.md                # Root rules
.opencode/agent/*.md     # Agent definitions
.opencode/skills/*/      # Existing skills
.opencode/command/*.md   # Existing commands

Phase 3: Research

If the pattern relates to:

• Agent behavior → Research OpenCode agent docs
• Prompting patterns → Research Claude best practices
• Tool usage → Research OpenCode tools docs
• Workflows → Check existing skills for similar patterns

Use exa_web_search or webfetch for OpenCode docs if needed.

Phase 4: Propose Changes

Present a structured proposal:

## Observation

[What pattern was noticed]

## Analysis

[Why this happens with current config]

## Proposed Changes

### Option A: [Name]
- File: [path]
- Change: [specific edit]
- Tradeoff: [pros/cons]

### Option B: [Name] (if applicable)
- File: [path]
- Change: [specific edit]
- Tradeoff: [pros/cons]

## Recommendation

[Which option and why]

Phase 5: Apply (with approval)

ALWAYS ASK before modifying config files.

After approval:

1. Make the changes
2. Explain what was changed
3. Suggest how to test the improvement

Config Locations

Config Type	Location	Purpose
Main	opencode.jsonc	Models, tools, permissions
Rules	AGENTS.md, */AGENTS.md	Instructions for all agents
Agents	.opencode/agent/*.md	Specialized agent definitions
Skills	.opencode/skills/*/SKILL.md	Workflow guides
Commands	.opencode/command/*.md	Quick shortcuts

Common Patterns

Agent not using skills enough

→ Add <skill_awareness> block to AGENTS.md → Improve skill descriptions to be more triggering

Agent doing X when it should do Y

→ Add explicit rule to AGENTS.md or agent definition → Consider permission restrictions

Repeated workflow friction

→ Create a new skill to guide the workflow → Or create a command for quick access

Context getting too large

→ Use progressive disclosure (read docs on-demand) → Consider DCP plugin for context pruning

Red Flags - STOP

If you catch yourself:

• Modifying config without user approval
• Making changes that affect security (permissions)
• Removing existing functionality

STOP. Always get explicit approval for config changes.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.