skills.rest
mattbutlerengineering
mattbutlerengineeringCOMMUNITY
Explore all skills by this author →
GitHub

opencode

Configure OpenCode AI coding assistant repository settings via opencode.json.

1|Updated Jan 24, 2026
Search Tags:#permissions#configuration#project context#opencode#mcp servers#opencode.json#ai coding assistant
One-click install
npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill opencode-mattbutlerengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode
Source: https://github.com/mattbutlerengineering/mattbutlerengineering/tree/main/.claude/skills/opencode
Command: npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill opencode-mattbutlerengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode configuration can be confusing and easy to misapply, leading to the wrong model, missing context, or incorrect tool permissions for your project.

Core Features & Use Cases

  • Repository-specific configuration: Uses the project root opencode.json to control model choice, context files, and tool permissions.
  • Targeted agent behavior: Defines agent settings and MCP server integrations so the assistant can work effectively within your repo boundaries.
  • Practical workflow: Verifies the installed CLI, inspects the existing configuration, and runs a simple prompt to confirm everything is wired correctly.

Quick Start

Run which opencode to verify OpenCode is installed, then use opencode "List the files in the apps directory" to confirm the repo context and permissions are working.

Frequently Asked Questions about opencode

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

FAQPage Schema
How do I configure an AI coding assistant for a specific repository?▼

To configure an AI coding assistant for a specific repository, use a root opencode.json file to control model choice, context files, and tool permissions. This ensures repository-specific settings apply correctly across typical development workflows.

What is the best way to set up opencode.json context paths and permissions?▼

Setting up opencode.json requires defining correct contextPaths and permission rules within a valid schema. This configuration dictates which files the assistant reads and what actions it is permitted to execute within project boundaries.

How do I enable MCP servers in my AI coding assistant configuration?▼

Enable MCP servers by adding an optional mcpServers configuration block to your opencode.json file. This defines targeted agent behavior and integrates external tool servers so the assistant can work effectively within repo boundaries.

Can I verify if my AI coding assistant configuration is working correctly?▼

Verify your AI coding assistant configuration by running which opencode to confirm the CLI is installed, then execute a simple prompt like listing a directory to confirm repo context and permissions are wired correctly.

Why does my AI coding assistant lack project context or use the wrong model?▼

Missing project context or incorrect model selection in an AI coding assistant usually happens when repository-specific settings are misapplied. Inspecting your opencode.json ensures the correct schema, model tuning, and context files are loaded.

Related Skills

Explore More Software Engineering Skills→
pantheon-orgpantheon-org
9

opencode-configure

Configure OpenCode runtime settings in opencode.json and AGENTS.md.

Official
Intermediate
advanced-securityadvanced-security
30

validate-ql-mcp-server-tools-queries

Validate MCP server tool queries for non-empty AST, CFG, and CallGraph outputs.

Official
Advanced
eastreamseastreams
641

native-mcp

Connect to external MCP servers and expose their tools as native Hermes Agent capabilities.

Official
Advanced
xeon826xeon826

opencode-config

Manage OpenCode configuration files with JSONC schema validation.

Community
Intermediate