opencode-configuration

Merge OpenCode configurations across global, project, and remote defaults.

1|Updated Nov 26, 2014
One-click install
npx skills add https://github.com/tianhuil/dotfiles --skill opencode-configuration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-configuration
Source: https://github.com/tianhuil/dotfiles/tree/main/home/.config/opencode/skills/opencode-configuration
Command: npx skills add https://github.com/tianhuil/dotfiles --skill opencode-configuration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

OpenCode users need a centralized way to manage and merge configuration across global, project, and remote defaults, including providers, models, and agents, to ensure consistent behavior across environments.

Core Features & Use Cases

  • Unified configuration precedence that effectively merges remote, global, custom, and project settings.
  • Centralized management of providers, models, agents, and skills with clear guidance for troubleshooting.
  • Quick setup for teams and multi-repo environments.

Quick Start

Create the global config at ~/.config/opencode/opencode.json and a project config at opencode.json, then run opencode to apply the merged settings.

Frequently Asked Questions about opencode-configuration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge OpenCode configurations across global and project settings?▼

You can merge OpenCode configurations by creating a global config at ~/.config/opencode/opencode.json and a project config at opencode.json, then running opencode to apply the unified settings.

What is the configuration precedence for OpenCode providers and models?▼

OpenCode configuration precedence merges remote, global, custom, and project settings in a hierarchical order, ensuring consistent behavior for providers, models, and agents across different environments.

How do I set up multiple providers and agents for an OpenCode project?▼

You can set up multiple providers and agents by defining them within your global or project opencode.json configuration files, which centralizes management for multi-provider environments.

Can I manage OpenCode skills for a team-based multi-repo environment?▼

Yes, OpenCode provides centralized management for skills and configurations tailored for team-based environments, ensuring consistent settings across multiple repositories and merged configurations.

How does OpenCode handle SKILL.md frontmatter and resource directories?▼

OpenCode ensures a SKILL.md frontmatter includes the required name and description fields, while supporting optional resource directories to extend capabilities for custom skills.

Why are my OpenCode project settings overriding global defaults?▼

OpenCode uses a unified configuration precedence where project settings intentionally override global defaults, ensuring local configurations take priority in merged configurations.