Back to Details

skill-qa

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill QA Review

Skill QA 评审

Run this checklist against the target SKILL.md. Report pass/fail for each item with a one-line explanation for failures.

对照目标SKILL.md执行此检查清单，为每个条目上报通过/不通过结果，不通过的条目需要给出单行原因解释。

Checklist

检查清单

Metadata

元数据

```
name
```
: lowercase, hyphens only, max 64 chars, no reserved words
```
description
```
: non-empty, max 1024 chars, third person, includes both what and when
```
description
```
includes specific trigger phrases users would say

```
name
```
：全小写，仅可使用连字符，最大长度64字符，不包含保留字
```
description
```
：非空，最大长度1024字符，使用第三人称表述，同时包含功能内容和适用场景
```
description
```
包含用户会使用的具体触发短语

Conciseness

简洁性

SKILL.md body is under 500 lines
No explanations of concepts Claude already knows
No verbose preambles or background sections
Each paragraph justifies its token cost

SKILL.md正文内容不超过500行
不包含Claude已经知晓的概念解释
没有冗长的前言或背景章节
每个段落的存在都匹配其token消耗价值

Structure

结构

Reference files are one level deep (no nested chains)
Files over 100 lines have a table of contents
Progressive disclosure used (details in separate files)
Conditional workflows use clear decision points

引用文件仅一层深度（无嵌套链式引用）
超过100行的文件需包含目录
采用渐进式披露（详细内容放在独立文件中）
条件工作流使用清晰的决策节点

Workflows

工作流

Complex tasks have numbered steps
Multi-step workflows include a copy-paste checklist
Feedback loops exist for quality-critical operations
Steps that must not be combined are explicitly marked

复杂任务带有编号步骤
多步骤工作流包含可复制粘贴的检查清单
质量关键操作存在反馈闭环
明确标记禁止合并执行的步骤

Scripts

脚本

Execute vs read intent is clear for each script
Scripts handle errors (don't punt to Claude)
No magic constants without justification
Required packages are listed

每个脚本的执行意图与读取意图清晰区分
脚本处理错误（不将错误抛给Claude处理）
无无合理理由的魔法常量
列出所有依赖包

Anti-patterns

反模式