对现有 Agent Skill（SKILL.md）进行全面质量评估并生成优化建议报告。当用户想要审查、评估、诊断或改进某个 skill 的质量时使用此技能，包括：检查 skill 是否符合最佳实践、描述是否有效触发、结构是否合理、内容是否简洁。使用关键词如"评估 skill"、"优化 skill"、"审查 ski...
对现有 Agent Skill 进行质量评估和综合优化建议，帮助提升 skill 的发现率、执行效果和维护性。
首先确认要审查的 skill 路径。读取：
SKILL.md（必读）如果用户只提供目录而未指定具体 skill，列出该目录下所有 SKILL.md 供用户选择。
执行结构分析脚本（输出客观指标，不加载到上下文）：
python scripts/audit_skill.py <skill目录路径>
脚本输出：行数统计、文件树、frontmatter 字段检查。详见 scripts/audit_skill.py。
逐一读取 scripts/ 下的每个脚本文件，作为代码审查员评估以下维度：
错误处理：关键操作是否有 try/except？错误信息是否有实际帮助（说明出了什么问题、怎么修复），还是只抛出原始异常？
路径规范：文件路径是否全部使用正斜杠 /？是否存在硬编码的绝对路径？
魔法数字/字符串：是否有无解释的数字或字符串常量（如 timeout=47）？关键参数应有注释说明取值理由。
函数文档：函数是否有 docstring 说明功能、参数和返回值？
自解决能力：脚本遇到问题时是否自己处理（给出默认值、备用方案），还是直接报错甩给调用者？
对每个脚本给出简短的代码审查结论，指出具体问题行和改进建议。
根据 references/checklist.md 中的详细评估清单，逐维度打分：
| 维度 | 权重 | 评估要点 |
|---|---|---|
| 元数据质量 | 25% | name 格式、description 有效性与触发性 |
| 结构合理性 | 20% | frontmatter、行数、渐进式披露、引用深度 |
| 内容质量 | 25% | 简洁性、避免过度解释、术语一致性 |
| 示例与模式 | 15% | 是否有具体示例、工作流是否清晰 |
| 脚本质量 | 15% | 错误处理、路径规范、魔法数字、文档完整性（无脚本则跳过，权重重分配） |
每个维度评分：🔴 差（0-59）/ 🟡 待改进（60-79）/ 🟢 良好（80-100）
使用以下报告结构输出结果：
Skill 名称：{name}
评估时间：{date}
总体评分：{综合得分}/100 {等级emoji}
| 维度 | 得分 | 状态 |
|---|---|---|
| 元数据质量 | XX/100 | 🟢/🟡/🔴 |
| 结构合理性 | XX/100 | 🟢/🟡/🔴 |
| 内容质量 | XX/100 | 🟢/🟡/🔴 |
| 示例与模式 | XX/100 | 🟢/🟡/🔴 |
| 脚本质量 | XX/100 | 🟢/🟡/🔴 |
列出严重影响 skill 可用性的问题，每条附上：问题描述 + 具体位置 + 修改建议
列出影响质量的改进点
列出做得好的地方，供参考
{具体的优化后 description 文本}
评估报告生成后，询问用户：
根据用户选择执行相应操作，修改前先备份原文件。
description 必须满足：
SKILL.md 正文必须满足：
常见反模式（立即标记）：
\ 而非 /）helper、utils）ZIP package — ready to use