opencode-agents

Create and configure OpenCode agents using YAML frontmatter and project prompts.

9|Updated Feb 15, 2026

Search Tags:#automation #markdown #permissions #configuration #agents #frontmatter #opencode

Ready to run

npx skills add https://github.com/gwenwindflower/dotfiles --skill opencode-agents-gwenwindflower

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: opencode-agents
Source: https://github.com/gwenwindflower/dotfiles/tree/main/dot_agents/exact_skills/opencode-agents
Command: npx skills add https://github.com/gwenwindflower/dotfiles --skill opencode-agents-gwenwindflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode users often struggle to consistently create and configure agents across projects; this skill provides a standardized way to define agent prompts, permissions, models, and tools using YAML frontmatter.

Core Features & Use Cases

Define agent metadata and permissions in Markdown/JSON frontmatter for repeatable agent setup.
Support configuring mode (primary/subagent), model, temperature, and per-tool permissions to ensure safe and predictable behavior.
Use case: Add or update agents for a project by placing a Markdown file under .opencode/agents/ or ~/.config/opencode/agents/ with the required fields.

Quick Start

Define a new agent by adding a Markdown file under ~/.config/opencode/agents/ or .opencode/agents/ with frontmatter that includes description, mode, and permissions.

Frequently Asked Questions about opencode-agents

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

FAQPage Schema

How do I configure OpenCode agents with YAML frontmatter?▼

Configuring OpenCode agents involves adding a Markdown file with YAML frontmatter under .opencode/agents/ or ~/.config/opencode/agents/, specifying fields like description, mode, and permissions for consistent behavior.

What is the best way to set per-tool permissions for OpenCode agents?▼

The best way to set per-tool permissions is by defining them within the YAML frontmatter of your agent Markdown files, ensuring safe and predictable agent behavior across different projects.

Can I use Markdown files to define OpenCode agent modes and models?▼

Yes, you can define OpenCode agent modes and models by placing Markdown files under .opencode/agents/ with structured YAML frontmatter specifying the primary or subagent mode and the desired model.

Does OpenCode support deterministic scripts and asset directories for agents?▼

OpenCode supports optional directories for deterministic scripts, additional references, and assets alongside agent configuration files, enabling structured and repeatable agent behavior across projects.

Why do I need structured frontmatter when adding agents under .opencode/agents/?▼

Structured frontmatter is required when adding agents to enforce consistent configuration of prompts, permissions, models, and tools, solving the problem of inconsistent agent setup across different projects.