Claude技能质量检查器,自动验证技能是否符合官方最佳实践标准。Use when 创建新技能需要验证规范、 修改现有技能需要质量检查、从他人处获取技能需要评估质量、批量检查多个技能的合规性。 适用于: (1) 新技能开发后的质量验证 (2) 技能更新后的合规检查 (3) 第三方技能的质量评估 (4) 团队技能库的标准化管理 (5) 技能打包前的最终审核
Claude技能质量检查器,基于官方创建流程规范自动验证技能质量。
准备待检查的技能
/mnt/skills/user/my-skill)执行检查
python scripts/check_skill.py <技能路径>
查看报告
| 输入类型 | 示例 | 说明 |
|---|---|---|
| 技能目录 | /mnt/skills/user/my-skill |
本地技能目录 |
| .skill文件 | /home/claude/my-skill.skill |
打包的技能文件 |
| 相对路径 | ./my-skill |
当前目录的技能 |
| 绝对路径 | /home/claude/skill-folder |
任意位置的技能 |
检查器会验证以下7个维度:
结构完整性 (30分)
YAML规范性 (20分)
描述质量 (15分)
内容质量 (20分)
引用有效性 (10分)
代码质量 (5分)
文档质量
| 分数 | 等级 | 说明 |
|---|---|---|
| 90-100 | A - 优秀 | 完全符合最佳实践 |
| 80-89 | B - 良好 | 基本符合,有少量改进空间 |
| 70-79 | C - 合格 | 满足基本要求,建议优化 |
| 60-69 | D - 需改进 | 存在明显问题 |
| 0-59 | F - 不合格 | 有致命问题 |
通过标准: 评分≥70分 且 无致命问题
用户请求检查
↓
准备工作空间
- .skill文件自动解压
- 目录直接使用
↓
执行7项检查
- 结构、YAML、描述
- 内容、引用、代码、文档
↓
计算综合评分
- 扣分规则计算
- 等级评定
↓
生成详细报告
- 问题分级
- 改进建议
↓
输出检查结果
🔴 致命问题 (Critical)
⚠️ 警告 (Warning)
⭐ 建议 (Suggestion)
============================================================
技能质量检查报告
============================================================
技能名称: my-skill
综合评分: 85/100
评级等级: B - 良好
总问题数: 5
检查结果: ✅ 通过
============================================================
🔴 致命问题 (Critical Issues)
============================================================
1. 缺少必需文件: SKILL.md
💡 改进建议: 创建SKILL.md文件,这是技能的核心文档
============================================================
⚠️ 警告 (Warnings)
============================================================
1. description缺少"何时使用"说明
💡 改进建议: 添加 "Use when..." 或 "适用于..." 描述触发场景
2. 发现3个示例文件未清理
💡 改进建议: 删除以下文件: scripts/example.py, ...
============================================================
💡 优化建议 (Suggestions)
============================================================
1. 建议添加章节: 快速开始, 工作流程
💡 改进建议: 这些章节帮助用户快速理解如何使用技能
优先修复致命问题
处理警告
考虑建议
重新检查
检查器使用固定的评分标准,基于官方最佳实践文档。如需了解详细的检查项目和评分规则,参见:
references/checklist.mdreferences/quick_fixes.md如果你需要调整评分标准(不推荐),可以修改 scripts/check_skill.py 中的扣分参数:
# 示例: 调整description缺少"何时使用"的扣分
if not any(keyword in description.lower() for keyword in ...):
self.score -= 8 # 改为你希望的扣分值
工作流:
# 1. 创建技能
python /mnt/skills/examples/skill-creator/scripts/init_skill.py my-skill
# 2. 开发技能内容
# ... 编写SKILL.md, scripts, references ...
# 3. 质量检查
python /mnt/skills/user/skill-quality-validator/scripts/check_skill.py my-skill
# 4. 根据报告改进
# 5. 重新检查直到通过
工作流:
# 1. 修改技能内容
# ... 更新SKILL.md或添加新功能 ...
# 2. 验证更新是否合规
python scripts/check_skill.py /mnt/skills/user/existing-skill
# 3. 确保评分未降低
工作流:
# 1. 下载技能文件
# downloaded-skill.skill
# 2. 质量评估
python scripts/check_skill.py downloaded-skill.skill
# 3. 查看报告决定是否使用
工作流:
# 检查所有用户技能
for skill in /mnt/skills/user/*/; do
echo "检查: $skill"
python scripts/check_skill.py "$skill"
echo "---"
done
# 标准技能发布流程
# 1. 质量检查
python /mnt/skills/user/skill-quality-validator/scripts/check_skill.py my-skill
# 确保通过 (≥70分, 无致命问题)
# 2. 打包技能
python /mnt/skills/examples/skill-creator/scripts/package_skill.py my-skill
# 生成 my-skill.skill
# 3. 分发使用
建议在以下时机执行检查:
如需添加特定项目的检查规则,可以扩展 scripts/check_skill.py:
def _check_custom_requirement(self):
"""自定义检查项"""
# 你的检查逻辑
if not meets_requirement:
self._add_issue('warning', '问题描述', '改进建议')
self.score -= 5
在自动化流程中使用:
# GitHub Actions 示例
- name: Validate Skill Quality
run: |
python check_skill.py my-skill
if [ $? -ne 0 ]; then
echo "质量检查未通过"
exit 1
fi
基于检查结果生成README徽章:
references/checklist.md - 所有检查项的完整说明references/quick_fixes.md - 常见问题的解决方案# 确保Python 3可用
python3 --version
# 确保有执行权限
chmod +x scripts/check_skill.py
# .skill文件本质是zip文件
# 手动解压测试
unzip -t skill-file.skill
references/checklist.md 了解评分规则建议: 质量检查通过后,仍需进行实际功能测试。
