用途
Writing Skills（Excellence）是一个用于创建、更新或改进 agent 技能（agent skills）的技能，定位为“技能创建卓越性的调度器（Dispatcher）”。它通过决策树帮助用户找到合适的模板与标准。当需要从零创建新技能、改进被 agent 忽略的现有技能、排查技能为何未被触发，或在团队内统一技能规范时，可以使用该技能。
主要能力
该技能提供三类核心能力。
第一是新建技能的分级架构决策树：
- 若技能较简单（单文件、少于 200 行）→ Tier 1 Architecture；
- 若较复杂（多概念、200-1000 行）→ Tier 2 Architecture；
- 若是大型平台（10+ 产品、AWS、Convex）→ Tier 3 Architecture。
第二是改进现有技能的诊断路径：
- 若问题是“it's too long”（太长）→ Modularize（Tier 3，模块化）；
- 若问题是“AI ignores rules”（AI 忽略规则）→ Anti-Rationalization（反合理化）；
- 若问题是“users can't find it”（用户找不到）→ CSO（Search Optimization，搜索优化）。
第三是验证合规性：检查 metadata/naming（元数据/命名）对应 Standards；添加测试对应 Testing Guide。
其组件索引包括：
- CSO：面向 LLM 的 SEO，说明如何撰写能触发技能的描述；
- Standards：文件命名、YAML frontmatter、目录结构；
- Anti-Rationalization：如何编写 agent 不会忽略的规则；
- Testing：如何确保技能真正有效。
提供的模板包括：Technique Skill（How-to，操作指南）、Reference Skill（Docs，文档）、Discipline Skill（Rules，规则）、Pattern Skill（Design Patterns，设计模式）。
使用方式
技能的工作流程为：识别目标→使用上方决策树；选择模板→从 references/templates/ 中选择；应用 CSO→优化描述以提升可发现性；添加反合理化→用于纪律类技能；测试→采用 RED-GREEN-REFACTOR 循环。
技能提供了 YAML frontmatter 的快速示例结构，包含 name、description（以“Use when...”开头）、metadata（category、triggers）等字段，并包含标题、When to Use 等正文段落。
在部署前需通过 Pre-Deploy Checklist：
- name 字段与目录名完全一致；
- SKILL.md 文件名为全大写；
- 描述以“Use when...”开头；
- metadata.triggers 包含 3+ 关键词；
- 总行数少于 500（更多内容使用 references/）；
- 交叉引用中不使用 @ 强制加载；
- 已用真实场景测试。
创建 Tier 1 技能的命令为： mkdir -p ~/.config/opencode/skills/my-technique touch ~/.config/opencode/skills/my-technique/SKILL.md
创建 Tier 2 技能的命令为： mkdir -p ~/.config/opencode/skills/my-skill/references/core touch ~/.config/opencode/skills/my-skill/{SKILL.md,gotchas.md} touch ~/.config/opencode/skills/my-skill/references/core/README.md
可使用 /write-skill 命令进行引导式技能创建。相关技能包括 opencode-expert，用于 OpenCode 环境配置。
适用场景
- 从零创建新技能；
- 改进被 agent 忽略的现有技能；
- 排查技能为何未被触发；
- 在团队内统一技能规范。
限制
仅在任务明确匹配上述范围时使用此技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必要的输入、权限、安全边界或成功标准，应停止并寻求澄清。