Skills Expert 用于针对一个明确的契约来诊断或改进单个 Agent Skill。其根本原则是：将可移植的 Agent Skills 格式、Claude Code 扩展以及本地市场要求彼此分离，不将某一层的规则呈现为通用规则。
用途与适用场景 适合在创建或修复 Agent Skill 时使用，尤其是当需要判断某个 Skill 是否真正符合规范、排查其声明与实现不一致、或按仓库叠加规则整改时。它同时支持只读审计与授权修复两种模式。
主要能力
- 契约选择：显式选择可移植 Agent Skills 基础、Claude Code 调用与权限扩展、或仓库/市场叠加规则之一。
- 结构与元数据检查：核对目录名与 frontmatter 中的 name 是否一致，区分真实文件与示例、备份、生成副本或归档包。
- 全面读取：读取完整的 SKILL.md、直接链接的支持文件、适用的 AGENTS.md/CLAUDE.md 以及校验器配置。
- 逐项核查：检查发现元数据、激活边界、前置条件、可执行步骤、权限、验证、输出、失败情况、示例和支持文件链接；用 Grep 将每条声称的命令、工具、路径和副作用追溯回源。
- 校验器执行：运行仓库的规范校验器，例如本仓库中的 python3 004-scripts/validate_skills_v2.py --fail-on-warn；检查 Intent Solutions 市场提交时，使用其市场校验器。
- 修复模式：用 Edit 做最小且连贯的改动，将持久性细节移至一层 references/，移除过期声明与未使用权限，并针对重要契约添加聚焦的回归测试。
- 复验与报告：重跑目标校验器与包测试，检查 diff 是否存在无关重写，并将残余警告与失败分开报告。
使用方式 先确定目标 Skill 目录或 SKILL.md 文件，确认用户想要只读审计还是实现。在修改文件前定位仓库指令与校验器。只读请求下不得编辑；若提出未授权或过宽的写入/Shell 权限，应要求明确批准而不是授予全局访问。可参考资源：Skill 契约与权威映射、仓库校验器 004-scripts/validate_skills_v2.py。
规则与限制
- 以当前官方 Claude Code 文档为 Claude Code 行为的权威依据，本地校验器用于更严格的仓库叠加规则。
- allowed-tools 只是预批准匹配工具，并不会移除其他所有工具；未列出的工具仍由权限设置管理。
- 绝不为提高分数而添加宽泛的写入或 Shell 权限。
- 不要将平台未经证实的行为当作事实保留；应查阅当前官方文档或明确说明不确定性。
- 存在多个实时副本时，先确定唯一真源再编辑，并测试镜像是否漂移。
- 缺少校验器时执行手动结构审计并明确标注。
- 规则冲突时遵循更高优先级的仓库指令并描述冲突。
输出要求 返回规范路径、所选契约、按严重程度划分的发现、精确变更（若已授权）、校验器/测试回执、剩余风险，以及清晰的通过/失败结果。未指明验证层级时，不得称某个 Skill 为“有效”。
其他事实（如官方文本）暂未提供。