Back to Details

skill-reviewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Reviewer

Claude Code技能评审工具

Review and improve Claude Code skills against official best practices.
对照官方最佳实践评审并改进Claude Code技能。

Setup (Auto-Install Dependencies)

安装设置（自动安装依赖）

Before using this skill, ensure 
skill-creator
is installed for automated validation.
Auto-install sequence:
bash
undefined
使用本技能前，请确保已安装
skill-creator
以进行自动化验证。
自动安装流程：
bash
undefined

1. Check if skill-creator exists

1. 检查skill-creator是否存在

SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1)
SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1)

2. If not found, install it

2. 若未找到则安装

if [ -z "$SKILL_CREATOR" ]; then claude plugin marketplace add https://github.com/daymade/claude-code-skills claude plugin install skill-creator@daymade-skills SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1) fi
echo "skill-creator location: $SKILL_CREATOR"
undefined
if [ -z "$SKILL_CREATOR" ]; then claude plugin marketplace add https://github.com/daymade/claude-code-skills claude plugin install skill-creator@daymade-skills SKILL_CREATOR=$(find ~/.claude/plugins/cache -name "skill-creator" -type d 2>/dev/null | head -1) fi
echo "skill-creator location: $SKILL_CREATOR"
undefined

Three Modes

三种工作模式

Mode 1: Self-Review

模式1：自我评审

Check your own skill before publishing.
Automated validation (run after setup):
bash
undefined
在发布前检查你自己的技能。
自动化验证（设置完成后运行）：
bash
undefined

Quick validation

快速验证

python3 "$SKILL_CREATOR"/*/quick_validate.py <target-skill>
python3 "$SKILL_CREATOR"/*/quick_validate.py <target-skill>

Security scan

安全扫描

python3 "$SKILL_CREATOR"/*/security_scan.py <target-skill> --verbose

**Manual evaluation**: See `references/evaluation_checklist.md`.
python3 "$SKILL_CREATOR"/*/security_scan.py <target-skill> --verbose

**手动评估**：请查看`references/evaluation_checklist.md`。

Mode 2: External Review

模式2：外部评审

Evaluate someone else's skill repository.
Review Workflow:
- [ ] Clone repository to /tmp/
- [ ] Read ALL documentation first
- [ ] Identify author's intent
- [ ] Run evaluation checklist
- [ ] Generate improvement report
评估他人的技能仓库。
评审工作流：
- [ ] 将仓库克隆到/tmp/目录
- [ ] 先阅读所有文档
- [ ] 明确作者的设计意图
- [ ] 执行评估检查表
- [ ] 生成改进报告

Mode 3: Auto-PR

模式3：自动PR

Fork, improve, and submit PR to external skill repository.
Auto-PR Workflow:
- [ ] Fork repository (gh repo fork)
- [ ] Create feature branch
- [ ] Apply additive improvements only
- [ ] Self-review: respect check passed?
- [ ] Create PR with detailed explanation
复刻、改进并向外部技能仓库提交PR。
自动PR工作流：
- [ ] 复刻仓库（gh repo fork）
- [ ] 创建功能分支
- [ ] 仅做增量改进
- [ ] 自我评审：是否通过尊重性检查？
- [ ] 创建带有详细说明的PR

Evaluation Checklist (Quick)

快速评审检查表

CategoryCheckStatus
Frontmattername present?
description present?
description in third-person?
includes trigger conditions?
Instructionsimperative form?
under 500 lines?
workflow pattern?
Resourcesno hardcoded paths?
scripts have error handling?
Full checklist: 
references/evaluation_checklist.md
分类检查项状态
前置元数据是否包含名称？
是否包含描述？
描述是否为第三人称？
是否包含触发条件？
操作说明是否为祈使句式？
内容是否少于500行？
是否包含工作流模式？
资源文件是否存在硬编码路径？
脚本是否包含错误处理？
完整检查表：
references/evaluation_checklist.md

Core Principle: Additive Only

核心原则：仅做增量改进

When improving external skills, NEVER:
  • Delete existing files
  • Remove functionality
  • Change primary language
  • Rename components
ALWAYS:
  • Add new capabilities
  • Preserve original content
  • Explain every change
❌ "Removed metadata.json (non-standard)"
✅ "Added marketplace.json (metadata.json preserved)"

❌ "Rewrote README in English"
✅ "Added README.en.md (Chinese preserved as default)"
改进外部技能时，绝对禁止：
  • 删除现有文件
  • 移除功能
  • 更改主要语言
  • 重命名组件
必须遵守：
  • 添加新功能
  • 保留原始内容
  • 对每一处修改做出说明
❌ “移除了metadata.json（非标准文件）”
✅ “添加了marketplace.json（保留原metadata.json）”

❌ “将README重写为英文”
✅ “添加了README.en.md（保留中文为默认语言）”

Common Issues & Fixes

常见问题与修复方案

Issue: Description Not Third-Person

问题：描述未使用第三人称

yaml
undefined
yaml
undefined

Before

修改前

description: Browse YouTube videos and summarize them.
description: Browse YouTube videos and summarize them.

After

修改后

description: Browses YouTube videos and generates summaries. Use when...
undefined
description: Browses YouTube videos and generates summaries. Use when...
undefined

Issue: Missing Trigger Conditions

问题：缺少触发条件

yaml
undefined
yaml
undefined

Before

修改前

description: Processes PDF files.
description: Processes PDF files.

After

修改后

description: Extracts text from PDFs. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
undefined
description: Extracts text from PDFs. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
undefined

Issue: No Workflow Pattern

问题：缺少工作流模式

Add checklist for complex tasks:
markdown
undefined
为复杂任务添加检查清单：
markdown
undefined

Workflow

工作流

Copy this checklist:
``` Task Progress:
  • Step 1: ...
  • Step 2: ... ```
undefined
复制以下检查清单：
``` 任务进度：
  • 步骤1：...
  • 步骤2：... ```
undefined

Issue: Missing Marketplace Support

问题：缺少市场支持配置

bash
mkdir -p .claude-plugin
bash
mkdir -p .claude-plugin

Create marketplace.json from template

从模板创建marketplace.json


See `references/marketplace_template.json`.

请查看`references/marketplace_template.json`。

PR Guidelines

PR提交指南

When submitting PRs to external repos:
向外部仓库提交PR时：

Tone

语气要求

❌ "Your skill doesn't follow best practices"
✅ "This PR aligns with best practices for better discoverability"

❌ "Fixed the incorrect description"
✅ "Improved description with trigger conditions"
❌ “你的技能不符合最佳实践”
✅ “本次PR调整以符合最佳实践，提升技能可发现性”

❌ “修复了错误的描述”
✅ “为描述添加了触发条件，进行了优化”

Required Sections

必备章节

  1. Summary - What this PR does
  2. What's NOT Changed - Show respect for original
  3. Rationale - Why each change helps
  4. Test Plan - How to verify
Template: 
references/pr_template.md
  1. 摘要 - 本次PR的内容
  2. 未修改内容 - 表明对原作者的尊重
  3. 修改理由 - 每项修改的作用
  4. 测试方案 - 验证方式
模板：
references/pr_template.md

Self-Review Checklist

自我评审检查表

Before submitting any PR:
Respect Check:
- [ ] No files deleted?
- [ ] No functionality removed?
- [ ] Original language preserved?
- [ ] Author's design decisions respected?
- [ ] All changes are additive?
- [ ] PR explains the "why"?
提交任何PR前，请确认：
尊重性检查：
- [ ] 未删除任何文件？
- [ ] 未移除任何功能？
- [ ] 保留了原始语言？
- [ ] 尊重了作者的设计决策？
- [ ] 所有修改均为增量改进？
- [ ] PR中说明了修改原因？

References

参考资料