# Opencode Config Advisor

> Detects, analyzes, and suggests changes to the Opencode CLI configuration file (config.json). Use this when the user complains about Opencode performance, asks to change the default model, or wants to modify CLI behavior. Use when this capability is needed.

- Skill: `tomevault-io/opencode-config-advisor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/opencode-config-advisor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/opencode-config-advisor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/opencode-config-advisor

---


# Opencode Config Advisor

## Goal
To locate the active Opencode configuration file, read its current state, and propose valid JSON modifications to satisfy user requirements (e.g., switching models, increasing context limits, changing output format).

## Usage Rules

### 1. Config Discovery
Always check for the configuration file in the following order of precedence:
1.  **Project Local:** `./opencode.json` (or `.opencode/config.json`)
2.  **Global (User):** `~/.config/opencode/opencode.json`
3.  **Legacy:** `~/.opencode.json`

*Command to use:* `ls -F ~/.config/opencode/opencode.json ./opencode.json 2>/dev/null`

### 2. Analysis & Safety
* **Read First:** Always run `cat <path_to_found_config>` before suggesting changes.
* **Validate JSON:** Ensure any proposed changes result in valid JSON. Do not use trailing commas.
* **Backup:** If executing a write operation, suggest backing up the original file first (`cp config.json config.json.bak`).

### 3. Common Modifications
* **Model Switching:** Look for `"model"` or `"default_model"`. Common values are `gpt-4o`, `claude-3-5-sonnet`, `gemini-pro`.
* **Context Window:** Look for `"max_tokens"` or `"context_limit"`.
* **API Keys:** **NEVER** output full API keys in the chat. Use placeholders like `"sk-..."` when displaying file content.

## Examples

### Example 1: Switch Model
**User:** "Opencode is being too expensive, switch it to a cheaper model."
**Agent Execution:**
1.  Locates `~/.config/opencode/opencode.json`.
2.  Reads content.
3.  Proposes changing `"model": "gpt-4"` to `"model": "gpt-4o-mini"`.

### Example 2: Debugging
**User:** "Why is Opencode ignoring my ignores?"
**Agent Execution:**
1.  Reads config to check the `"ignore_patterns"` or `"gitignore"` setting.
2.  Checks if `.gitignore` exists in the current directory.
3.  Suggests adding specific patterns to the config if the global setting is missing.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/radema) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->