review-a-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Review A Skill

评审Skill

Goal

目标

Evaluate a single skill's quality, relevance, and safety before it enters or stays in a library.

评估单个skill在进入或保留在技能库之前的质量、相关性和安全性。

Guardrails

操作规范

Always use
```
--format json
```
for machine-readable output in automated pipelines.
Always use
```
--fields
```
to limit output size when inspecting catalog entries.
Always use
```
--dry-run
```
before curating or removing a skill.
Never remove a skill without first checking if other skills depend on it via
```
info --format json
```
dependencies.

自动化流水线中需始终使用
```
--format json
```
参数输出机器可读的结果。
检查目录条目时始终使用
```
--fields
```
参数限制输出大小。
整理或移除skill前务必先执行
```
--dry-run
```
（试运行）。
移除skill前必须先通过
```
info --format json
```
的依赖项检查确认是否有其他skill依赖该skill。

Workflow

工作流程

Preview the skill content to check for quality and safety.

bash

npx ai-agent-skills preview <skill-name>

The preview command sanitizes content — if it flags sanitization, investigate before proceeding.

Inspect the catalog entry for metadata completeness.

bash

npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies

Validate the skill's SKILL.md structure.

bash

npx ai-agent-skills validate <skill-name>

If the skill needs curation (notes, collections, verification):

bash

npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify --dry-run
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify

If the skill should be removed:

bash

npx ai-agent-skills curate <skill-name> --remove --dry-run
npx ai-agent-skills curate <skill-name> --remove --yes

预览skill内容以检查质量和安全性。

bash

npx ai-agent-skills preview <skill-name>

preview命令会对内容进行消毒处理，如果它标记了消毒操作，需要先调查再继续后续流程。

bash

npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies

验证skill的SKILL.md结构是否合规。

bash

npx ai-agent-skills validate <skill-name>

如果skill需要整理（补充备注、调整分类、验证状态）：

bash

npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify --dry-run
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify

如果skill应该被移除：

bash

npx ai-agent-skills curate <skill-name> --remove --dry-run
npx ai-agent-skills curate <skill-name> --remove --yes

Decision Criteria

决策标准

Keep: Clear description, valid frontmatter, useful to the library's audience, no injection patterns.
Curate: Needs better whyHere, collection placement, or verification status.
Remove: Duplicate, outdated, broken source, or contains suspicious content.

保留：描述清晰、frontmatter有效、对技能库受众有用、无注入风险模式。
整理：需要完善whyHere字段、调整分类归属或验证状态。
移除：重复、过时、源文件损坏或包含可疑内容。

Gotchas

注意事项

The
```
preview
```
command only works for vendored (house) skills. Upstream skills show description and whyHere only.
The
```
validate
```
command checks frontmatter structure but not content quality — that requires human or agent judgment.
Removing a skill that other skills depend on will break the dependency graph. Always check
```
dependencies.usedBy
```
first.

```
preview
```
命令仅适用于内部（自有）skill。上游skill仅会显示描述和whyHere字段。
```
validate
```
命令仅检查frontmatter结构，不会校验内容质量——内容质量需要人工或Agent判断。
移除被其他skill依赖的skill会破坏依赖图，务必先检查
```
dependencies.usedBy
```
字段。