Content
100%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.
An exemplary instruction-only skill body: lean, fully actionable commands, a workflow with genuine validation feedback loops around a potentially destructive sync operation, and an explicit output contract with anti-false-success rules. Structure is appropriately sized with no content that belongs in separate files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense — every section (适用范围, 工作流程, 架构边界, 输出契约, 验证) carries non-obvious domain-specific constraints, with no padding and no explanation of concepts Claude already knows. This matches anchor 5 ('lean and efficient; assumes Claude's competence; every token earns its place'); anchor 4 would require over-explanation that could be trimmed, and none is present. | 5 / 5 |
Actionability | Commands are copy-paste ready ('python3 scripts/validate_repo.py --strict', 'python3 scripts/sync_skills.py --destination "<destination>" --profile core --check'), the output contract enumerates exact report fields and the PASS/PARTIAL/BLOCKED vocabulary, and a concrete fallback path ('包内 scripts/audit.py') is specified for when no validator exists. This matches anchor 5 (fully executable, specific coverage of the common cases); it is above anchor 4 because there are no minor gaps in the primary workflows. | 5 / 5 |
Workflow Clarity | The 6-step workflow has a clear sequence with explicit validation checkpoints: strict validation up front, read-only '--check' before any write, '--apply' only on explicit user request, and a mandatory second '--check' after apply. This is precisely the anchor-5 pattern (explicit validation steps, feedback loops, verification checklist), and the destructive/batch cap of 3 does not apply because validation is thoroughly present — including the rule that old stdout or a single apply is never accepted as success evidence. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with well-organized sections and no need for external reference files; the only bundle file (scripts/audit.py) is correctly positioned as a portable fallback rather than inlined detail, so content is appropriately split. Per the rubric's simple-skill guidance this scores 5 with well-organized sections; there are no multi-level or buried references. | 5 / 5 |
Total | 20 / 20 Passed |