本技能用于指导创建、配置和改进 OpenCode 智能体（agent）文件，适合在编写新智能体、优化已有智能体或做相关审计时使用。
核心原则：智能体文件必须全部用英文编写，包括 frontmatter、系统提示、注释和文档，理由是提升模型处理效率、降低 token 消耗并保持行为一致；智能体仍可用用户偏好的语言回复。文件采用 YAML frontmatter 加 Markdown 正文，不使用 XML 标签。常用字段包括 description（必填，含使用时机与示例）、mode（primary、subagent、all）、tools、permission、model、temperature、maxSteps、hidden 等。
主要能力与内容：给出智能体命名规范（动名词或名词角色，如 reviewing-code、security-auditor），正文结构（角色、核心职责、操作原则、工作流、常见任务），并提出两项强制机制——Context First（行动前识别缺失信息、提针对性问题、确认理解）和 Verification Loop（对修改类智能体做语法检查、功能测试、权限测试）。
还包含智能体类型速查（Builder、Planner、Reviewer、Executor、Researcher）、复杂度分级（Micro 50–100 行到 Complex 400+ 行）、安全风险分级（🟢 安全到 🔴 高风险）、语气与风格校准、成本优化（模型选择、maxSteps、temperature）、工具选择决策与权限模式，以及创建后的验证步骤和报告模板。
使用方式：技能本身为被动知识，创建时直接用 OpenCode 的 Write 和 Edit 工具写入 ~/.config/opencode/agent/<name>.md，scripts/ 中的脚本仅为可选校验工具。验证时可执行 head -50 ~/.config/opencode/agent/<name>.md | yq . 检查 YAML 语法。
限制：文中未提供官方价格、平台支持范围或具体效果数据；templates/、references/、workflows/ 等目录内容在资料中仅被列举名称，未展开。