agent-configuration

Configure OpenCode agents with YAML frontmatter for prompts, models, and permissions.

11|2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill agent-configuration-the-perfect-developer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-configuration
Source: https://github.com/the-perfect-developer/the-perfect-opencode/tree/main/.opencode/skills/agent-configuration
Command: npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill agent-configuration-the-perfect-developer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables teams to configure and constrain OpenCode agents (primary and subagents) to fit project workflows, ensuring consistent behavior and governance across sessions.

Core Features & Use Cases

  • Centralized agent configuration including prompts, models, tools, and permissions.
  • Support for switching between primary agents and invoking subagents within orchestrated workflows.
  • Real-world scenarios such as setting up new projects, adjusting agent capabilities for different teams, and enforcing security boundaries.

Quick Start

Use the agent-configuration skill to define and apply your project’s agent definitions and permission rules.

Frequently Asked Questions about agent-configuration

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

FAQPage Schema
How do I configure OpenCode agents for custom project workflows?

To configure OpenCode agents for custom workflows, you define prompts, models, tool access, permissions, and session behavior using mandatory YAML frontmatter with name and description fields. This enforces consistent agent behavior and governance across multi-agent orchestration sessions.

What's the best way to set up permissions and tool access for OpenCode subagents?

Setting up permissions and tool access for OpenCode subagents involves applying safety and permission configurations within the centralized agent definition. You constrain subagent capabilities during multi-agent orchestration by defining specific tool access boundaries and security rules in the configuration.

Can I manage both primary agents and subagents within orchestrated OpenCode workflows?

Yes, you can manage both primary agents and subagents within orchestrated OpenCode workflows. The configuration supports switching between primary agents and invoking subagents, allowing you to tailor prompts, models, and session behavior across the entire multi-agent orchestration.

How does YAML frontmatter enforce consistent behavior across OpenCode agent sessions?

YAML frontmatter enforces consistent behavior across OpenCode agent sessions by requiring a mandatory name and description for every agent definition. This standardized metadata ensures agents adhere to configured prompts, models, and governance rules throughout multi-agent orchestration.

Do I need specific directories to configure OpenCode agents with runtime resources?

You do not strictly need specific directories to configure OpenCode agents, but the setup supports optional directories like scripts/, references/, and assets/ for managing runtime resources. These directories help organize supplementary files required during multi-agent orchestration.

Why are security boundaries important when configuring OpenCode agents for different teams?

Security boundaries are important when configuring OpenCode agents for different teams because they enforce governance and constrain tool access. By defining explicit permissions and safety configurations, you prevent unauthorized actions and maintain consistent operational boundaries across multi-agent sessions.