用途：通过 /skill 系列命令管理本地 SKILL.md 文件，把持久化、与代码库相关的工作流沉淀为技能。用户级根目录为 ${CODEX_HOME:-$HOME/.codex}/skills/，项目级为 .codex/skills/，技能位于 <root>/<name>/SKILL.md。
主要能力：list 扫描两个根目录并解析 frontmatter，显示名称、描述、触发词、作用域及质量/使用情况；add 运行编写向导并校验名称；edit 修改描述、触发词、参数提示、正文或重命名；remove 确认后删除目录；search 对名称、描述、触发词和正文做不区分大小写检索，名称/触发词匹配优先；info 显示元数据与完整正文；sync 比较用户与项目技能并逐项确认复制或覆盖；setup 确保根目录存在并扫描后提供添加、列出、模式扫描、导入等选项；scan 执行扫描/清单而不进入交互菜单；validate 校验两个根目录下所有技能并逐条报告通过或失败，不会改写文件。带参数时进入直接命令模式，不带参数时进入引导式菜单。
技能格式：frontmatter 需包含 name（小写字母数字，单连字符分隔，如 [a-z0-9]+(?:-[a-z0-9]+)*）、description（单行非空用途）、triggers（逗号分隔识别词）、argument-hint（可选）、scope（user 或 project）；可选 id、source、quality。正文建议包含 Purpose、When to Activate、Workflow、Examples / Gotchas，强调具体路径、命令、错误文本与可验证证据，而非通用编程建议。
限制：不用于更改运行时代码、目录、钩子或安装逻辑；从对话提取技能应用 /learner，简短记录用 /note。校验会拒绝格式错误或未闭合的 YAML、多行必填标量、同作用域重名、缺失目录/文件、权限失败和无效参数。错误统一以“✗ Error: … → Suggestion: …”形式报告；取消或仅校验时不改动文件。