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)

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

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>

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)

快速评审检查表

Category	Check	Status
Frontmatter	name present?
	description present?
	description in third-person?
	includes trigger conditions?
Instructions	imperative form?
	under 500 lines?
	workflow pattern?
Resources	no 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.

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.

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

必备章节

Summary - What this PR does
What's NOT Changed - Show respect for original
Rationale - Why each change helps
Test Plan - How to verify

Template:

references/pr_template.md

摘要 - 本次PR的内容
未修改内容 - 表明对原作者的尊重
修改理由 - 每项修改的作用
测试方案 - 验证方式

模板：

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

参考资料

```
references/evaluation_checklist.md
```
- Full evaluation checklist
```
references/pr_template.md
```
- PR description template
```
references/marketplace_template.json
```
- marketplace.json template
Best practices: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices

```
references/evaluation_checklist.md
```
- 完整评审检查表
```
references/pr_template.md
```
- PR描述模板
```
references/marketplace_template.json
```
- marketplace.json模板
最佳实践：https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices