# opencode-smith

> Update OpenCode configuration, agents, commands, skills, and rules through safe config-only changes. Use for natural-language requests that translate to edits in opencode.json/jsonc, .opencode/*, AGENTS.md, and Claude-compatible files.

- Author: Bradley Gibson
- Repository: bradleygibsongit/opencode-smith
- Version: 20260124100124
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/bradleygibsongit/opencode-smith
- Web: https://mule.run/skillshub/@@bradleygibsongit/opencode-smith~opencode-smith:20260124100124

---

---
name: opencode-smith
description: Update OpenCode configuration, agents, commands, skills, and rules through safe config-only changes. Use for natural-language requests that translate to edits in opencode.json/jsonc, .opencode/*, AGENTS.md, and Claude-compatible files.
license: MIT
compatibility: opencode
metadata:
  author: Bradley Gibson
  version: "0.1.0"
  scope: config-only
---

# OpenCode Smith

## What I do

- Translate natural-language requests into OpenCode configuration changes.
- Handle global vs project-specific precedence and merge behavior.
- Create and update agents, subagents, commands, skills, permissions, and rules.
- Keep changes strictly within OpenCode config and instruction files.

## When to use me

- "Update my global opencode.json to set a theme and model."
- "Create a plan subagent that only does architecture reviews."
- "Add a /release-notes command with a prompt template."
- "Generate a new OpenCode skill definition for internal docs."
- "Resolve conflicts between global and project settings."

## Operating rules

- Config-only scope: never edit application code or install/update binaries.
- Never run dev servers.
- Prefer the smallest change that satisfies the request.
- Preserve JSONC comments and existing formatting.
- Use reference files for OpenCode-specific details; load only what is relevant.
- If a request is ambiguous or risky, ask a targeted clarification first.

## Target files

- Project config: `opencode.json` or `opencode.jsonc`
- Global config: `~/.config/opencode/opencode.json`
- Project directories: `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/`, `.opencode/plugins/`, `.opencode/themes/`
- Rules: `AGENTS.md`, `CLAUDE.md`, `CONTEXT.md`
- Claude compatibility: `.claude/skills/`, `~/.claude/skills/`

## Change workflow

1. Identify the correct config scope (global vs project).
2. Summarize precedence/merge implications when relevant.
3. Draft the minimal edits required.
4. Apply the edits and summarize what changed.

## Confirm before

- Deleting config or instruction files.
- Broad permission changes (e.g., default allow/deny).
- Disabling providers or tools globally.
- Overriding global defaults with project config when not explicit.

## References

Use these files for OpenCode-specific details (load only what is relevant):

- Config schema and precedence: `references/config.md`
- Agents and subagents: `references/agents.md`
- Commands and templates: `references/commands.md`
- Skills format and naming rules: `references/skills.md`
- Rules and AGENTS.md: `references/rules.md`
- Permissions patterns: `references/permissions.md`