用途：帮助编写清晰、可复用、易维护的技能，并同步 OpenCode 技能与配置变更。
适用时机：从零创建新技能；改进现有技能的清晰度与触发质量；为技能添加参考、模板和清单；准备发布技能仓库；将 OpenCode 设置与技能同步到 mini。
质量要求：清晰触发范围（何时用与何时不用）、明确成功输出形态、可执行的分步流程（非泛泛建议）、具体示例与可复用片段、安全与约束（假设、风险、反模式）。
推荐结构：frontmatter（name、description）、Overview、When to Use / When Not to Use、核心原则与工作流、输出契约、参考（模板、清单、示例）。可使用模板 references/SKILL_SKELETON.md。
编写流程：定义狭窄的待办任务与明确触发短语；起草 frontmatter 与范围边界；写操作步骤；为重复任务添加参考；检查可读性并删除模糊表述；通过列出已安装或可用技能测试可发现性；同步变更到 mini。可使用清单 references/AUTHORING_CHECKLIST.md。
同步流程（MBP 到 Mini）：前提是 scotttolinski@mini 的 SSH 密钥认证可用。推送本地 OpenCode 设置与技能：~/.config/opencode/scripts/sync-opencode-settings.sh push scotttolinski@mini 从 mini 拉取：~/.config/opencode/scripts/sync-opencode-settings.sh pull scotttolinski@mini 可选密钥覆盖：OPENCODE_SYNC_IDENTITY=~/.ssh/id_ed25519 ~/.config/opencode/scripts/sync-opencode-settings.sh push scotttolinski@mini
发布建议：公开 README 保持对客户与机器中立；避免在公开文档中写入个人基础设施笔记；将本地环境细节放入私有或内部文档或本地自动化脚本。
限制：资料未提供具体技能的收费、价格、平台支持范围或运行环境细节。