Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, actionable overview: a clear three-step migration workflow with a checklist, concrete platform-syntax cleanup rules, a working script whose documented usage matches its real interface, and example experts properly externalized into separate files. The main defects are the broken reference to the nonexistent template file and noticeable redundancy between the method, principles, checklist, and duplicated compliance notes.
Suggestions
Create the referenced `template/migration-template.md` fillable five-part template (or remove the 空白模板 section) — it is currently a dead reference in the bundle.
Deduplicate content: merge the top compliance blockquote into the 合规提醒 section, and state the platform-syntax cleanup rules once in 三步迁移法 with the checklist and principles referencing rather than restating them.
Add an explicit error-recovery step to the workflow, e.g., if placeholders remain after running the script, replace them manually; if the target AI misreads the migrated prompt, re-clean and re-paste before sending the task.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows, and every section carries actionable content. It is not 5 because the platform-syntax cleanup rules are stated three times (三步迁移法 step 2, 三大原则, and the 迁移自检清单) and the compliance notice is duplicated (top blockquote and 合规提醒 section), which is more than the 5-anchor's 'every token earns its place'; it is above 3 because the repetition is structural reinforcement rather than padding. | 4 / 5 |
Actionability | Guidance is concrete and executable — an exact command that matches the script's actual interface (`python scripts/strip_platform_syntax.py input.md -o cleaned.md`), specific cleanup rules with real syntax examples (`{{用户输入}}`、`{var}`、「调用 XX 工具」), and six real, ready-to-use example files under assets/experts/. It falls short of 5 because the referenced fillable template `template/migration-template.md` does not exist in the bundle, a concrete dead-end for users following that instruction. | 4 / 5 |
Workflow Clarity | The 核心方法论 (提取→清理→落地) is a clearly sequenced three-step workflow with an explicit validation checkpoint (等 AI 确认「明白了」后再发具体任务) and a 6-item self-check checklist — matching 'clear sequence with most checkpoints present'. It is not 5 because no error-recovery path is specified (e.g., what to do if placeholders remain after cleaning or if the target AI misinterprets the prompt). | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the SKILL.md is a concise overview with well-signaled, one-level-deep references, and 7 of 8 referenced paths resolve (all six assets/experts/*.md files and scripts/strip_platform_syntax.py exist and are accurately described). It is not 5 because `template/migration-template.md` is referenced in the body but missing from the bundle — a broken navigation path that constitutes a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |