Skill: OpenCode Agent Authoring

Goal

Create or update OpenCode agent guidance with clear triggers, behavior, and constraints.

Use This Skill When

• You are asked to add or revise agent behavior docs.
• You need to create new .opencode/agent/*.md or similar agent guidance.
• You are aligning agent instructions with new skills or workflows.

Do Not Use This Skill When

• The change is unrelated to agent behavior.
• You are only updating skill docs without agent changes.

Inputs

• Desired agent role and scope.
• Existing agent guidance and AGENTS.md rules.
• Related skills that the agent should use or avoid.

Required Frontmatter Syntax

When creating skills alongside agents, ensure valid YAML frontmatter:

---
name: my-skill-name
description: "A clear, specific description of what this skill does"
---

Critical: Quote Description Values

ALWAYS quote the description field. If the description contains a colon (:), unquoted YAML will fail to parse.

# GOOD - quoted description
---
name: my-skill
description: "Skill: My Skill Description"
---

# BAD - unquoted description (will fail)
---
name: my-skill
description: Skill: My Skill Description
---

Valid Frontmatter Fields

Steps

1. Locate existing agent guidance and follow its structure.
2. Define the agent's Goal, scope, and triggers.
3. Specify required tools and forbidden behaviors.
4. Cross-reference relevant skills and docs.
5. Update AGENTS.md if new guidance needs to be advertised.

Output

• Updated or new agent guidance files.
• AGENTS.md references that clarify when to use the agent.

References

• Agent and skill guidance: .opencode/skills/opencode-agents-skills.md
• Workspace rules: AGENTS.md

Suggested Next Skills

Check the Skill Graph for the full workflow.

• opencode-agents-skills