Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable diagnostic skill body with a clear repair workflow; its single real weakness is that the many [ref:...] pointers advertise reference files that are not present in the bundle, undermining the progressive-disclosure structure.
Suggestions
Ship the referenced bundle files (references/model-mechanics.md, failure-atlas.md, delivery-qc.md, etc.) so the [ref:...] pointers resolve, or remove pointers to files that do not exist.
Convert [ref:name] tokens into standard markdown links (e.g., [model-mechanics](references/model-mechanics.md)) so the references are clickable and verifiable rather than custom notation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and assumes Claude's competence — a compact diagnostic table, a fill-in retry template, and terse process steps with no padding explaining what Seedance or video generation is; the only soft spot is the brief editorializing 'Intent' section, which is short enough not to disqualify the lean anchor. | 3 / 3 |
Actionability | Guidance is concrete and executable throughout: a per-symptom diagnostic table with specific first repairs, a slot-fillable 'Conservative Retry Pattern' template, and explicit escalation actions — fully actionable for an instruction-only skill. | 3 / 3 |
Workflow Clarity | The 'Repair Process' lays out a clear ordered sequence (quote → name cause → remove conflicts → one repair variable → conservative retry + optional variant), the 'Escalation Rules' supply a feedback loop for repeated errors, and the 'Output Contract' defines the deliverable checklist. | 3 / 3 |
Progressive Disclosure | The body correctly defers detail to one-level-deep references signaled as [ref:...] tokens (model-mechanics, failure-atlas, delivery-qc, etc.), but no references/, scripts/, or assets/ bundle files exist, so every reference is a dangling pointer to a non-existent file and navigation is broken. | 2 / 3 |
Total | 11 / 12 Passed |