skills.rest
gwenwindflower
gwenwindflowerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/gwenwindflower/dotfiles --skill opencode-agents-gwenwindflower
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
jpoutrinjpoutrin
14

create-agent

Create Claude Code agent markdown files with required YAML frontmatter fields.

Community
Basic
jal-cojal-co
7

opencode-agents

Define and configure OpenCD agents with permissions, tools, and mode settings.

Community
Advanced
DonTiziDonTizi
2

security-audit

Scan codebases for secrets, OWASP risks, and vulnerable dependencies.

Community
Advanced
justinlevinedotmejustinlevinedotme
7

opencode-agents

Define and configure OpenCode agents with permissions, tools, and mode rules.

Community
Intermediate