opencode-config

Automate OpenCode configuration management for skills, agents, commands, rules, and profiles.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/d3fvxl/.dotfiles --skill opencode-config-d3fvxl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-config
Source: https://github.com/d3fvxl/.dotfiles/tree/main/config/opencode/skills/opencode-config
Command: npx skills add https://github.com/d3fvxl/.dotfiles --skill opencode-config-d3fvxl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode configuration often requires coordinating multiple components across base and profile-specific folders; this skill provides a structured, safely-symlinked workflow to configure skills, agents, commands, rules, and profiles consistently.

Core Features & Use Cases

  • Centralizes configuration artifacts in ~/.dotfiles/config/opencode/ and per-profile overrides in ~/.dotfiles/config/opencode-<profile>/
  • Supports and documents skills, agents, commands, and rules with guidelines for safe editing and deployment via symlinks.
  • Enables quick setup and troubleshooting of OpenCode configurations across multiple profiles.

Quick Start

Modify or create a skill under ~/.dotfiles/config/opencode/skills/<name>/SKILL.md and symlink it to ~/.config/opencode/skills/<name>/SKILL.md, then ensure opencode.json is updated as needed.

Frequently Asked Questions about opencode-config

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

FAQPage Schema
How do I configure OpenCode skills and agents across multiple profiles?

OpenCode configuration is managed by centralizing artifacts in a base directory and applying per-profile overrides using safe symlinks. This structured workflow ensures skills, agents, commands, and rules remain consistent across different profile setups.

What is the correct way to structure SKILL.md files for OpenCode?

SKILL.md files require specific frontmatter to function correctly within OpenCode. The configuration process enforces this required frontmatter and provides guidelines for safely editing and deploying these skill components.

How do I safely symlink OpenCode configuration files between directories?

Safe symlink practices involve creating files under a centralized dotfiles directory and symlinking them to the active OpenCode configuration path. This method allows base configurations and per-profile overrides to coexist without conflicts.

Can I troubleshoot and fix broken OpenCode setup configurations?

Troubleshooting OpenCode setup involves verifying symlink integrity and checking that all components like skills, agents, and rules are correctly placed. This configuration workflow guides safe editing and quick setup to resolve setup issues.

Does OpenCode support per-profile overrides for commands and rules?

OpenCode supports per-profile overrides by storing profile-specific configurations in dedicated directories. This allows users to maintain a base set of commands and rules while applying targeted overrides for different environments.