Content
92%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.
A high-quality instruction/code skill body: executable workflow with validation gates and feedback loops, copy-paste commands with exact thresholds, and well-signaled one-level-deep references backed by real bundle files. The only minor drag is some overlap between the body's scoping prose and the frontmatter description.
Suggestions
Trim the repeated scope/route guidance in the body ('When to use', 'NOT SUPPORTED', 'Read /hyperframes first') since the frontmatter description already covers it; keep one canonical 'When to use' block and link out.
Consider collapsing the 'What this skill explicitly does NOT do' section into the existing 'When to use' / lint-step blockers, since the useState/useEffect rationale is already stated in Step 1.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and action-oriented with no padding of concepts Claude already knows, but the 'When to use'/'Do NOT use'/'NOT SUPPORTED' material partially duplicates the frontmatter description and the overview's caveat block, adding some repetition that could be tightened. | 4 / 5 |
Actionability | Fully executable guidance — concrete lint categories with specific APIs, a copy-paste render/diff bash block, exact threshold values (~0.02 below p05), and a pixel-format fix (Config.setVideoImageFormat('png') + bt709) covering the common cases. | 5 / 5 |
Workflow Clarity | Five-step sequence (lint → plan → generate → validate → document) with an explicit validation checkpoint ('If any blocker fires, stop'), a feedback loop on diff failure (frame_strip → re-read reference), and a destructive-operation cap satisfied by the lint-gate before translation. | 5 / 5 |
Progressive Disclosure | Body is a concise overview that signals one-level-deep references via a load-decision table (api-map, parameters, sequencing, timing, media, transitions, lottie, fonts, eval, limitations, escape-hatch), each verified as a real file; nothing is deeply nested and navigation is explicit. | 5 / 5 |
Total | 19 / 20 Passed |