New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Guided setup for opencode.json and AGENTS.md covering models, permissions, rules, and validation of config edits.

skills.sh installs
315
GitHub stars
121
last updated
Jun 3, 2026
View on GitHub

What it does

  • Covers global and project config locations, with project settings merged over global ones rather than replacing them
  • Includes key options such as model, small_model, theme, autoupdate, and share, plus a permission block for edit and bash rules
  • Enforces validation by running opencode run "test" after edits and migrating legacy tools and maxSteps fields to permission and steps
  • Designed for users changing OpenCode provider, model, permission, or formatter settings and writing project instructions in AGENTS.md

Install

$ npx -y skills add igorwarzocha/opencode-workflows --skill opencode-config -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

OpenCode Configuration

Help users configure OpenCode through guided setup of config files and rules.

<question_tool>

Batching Rule: Use only for 2+ related questions; single questions use plain text.

Syntax Constraints: header max 12 chars, labels 1-5 words, mark defaults with (Recommended).

Purpose: Clarify config scope (models/permissions/rules), validate approach, and handle multiple valid options.

</question_tool>

File Locations

TypeGlobalProject
Config~/.config/opencode/opencode.json./opencode.json
Rules~/.config/opencode/AGENTS.md./AGENTS.md

Precedence: Project > Global. Configs are merged, not replaced.

Question Tool

Batching: Use the question tool for 2+ related questions. Single questions → plain text.

Syntax: header ≤12 chars, label 1-5 words, add "(Recommended)" to default.

When to ask: Vague request ("configure opencode"), permission/security changes, or multiple valid options exist.

Workflow

Ask the user what they want to configure:

Details

Repository
github.com/igorwarzocha/opencode-workflows
First seen
Jun 3, 2026

More from igorwarzocha/opencode-workflows

All 7

Similar to Opencode Config