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.