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.
An exemplary skill body: dense with non-obvious operational detail, concrete API names and commands, a well-sequenced verification workflow with feedback loops, and textbook progressive disclosure via a purpose table for two real reference files. The only weakness is the absence of a complete example call payload in the body itself.
Suggestions
Add one compact end-to-end example in the body (e.g., a minimal applyManualKeyframeTrack call with a two-keyframe track object, or a full export_video request) so the most common case is copy-paste ready without opening a reference.
Optionally include one explicit JSON snippet for the export_video polling re-invocation ({ fileKey, jobId }) alongside the ffmpeg frame-extraction command to complete the verification loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: every line carries non-obvious operational knowledge (the exact gating error string, the export cost model, server clamps, poll mechanics) with zero explanations of concepts Claude already knows. Not 4 because no section can be identified as over-explanation or padding. | 5 / 5 |
Actionability | Highly concrete guidance: exact API signatures (node.applyManualKeyframeTrack(field, track), node.setTimelineDuration(id, seconds)), exact public enum names (EASE_IN_AND_OUT, never EASE_IN_OUT), numeric render params (fps: 5, WIDTH 320), and a copy-paste ffmpeg command. Not 5 because no complete example call payload (e.g., a full manualKeyframeTracks object or export_video invocation) appears in the body — detail is deferred to references — which is a minor gap; not 3 since nothing is vague or pseudocode. | 4 / 5 |
Workflow Clarity | The verification workflow is a clearly numbered plan (pick moments → size → set fps) with an explicit poll loop, an iterate-until-right feedback loop ('fix the keyframes/styles and re-export... batch every fix into one pass before re-rendering'), bail-out-fast error handling for the feature gate, and a pre-flight checklist. Matches the top anchor with feedback loops and checklists. | 5 / 5 |
Progressive Disclosure | Model progressive disclosure: the body is an overview with a 'Doc | When to load | What it covers' table pointing to two real, verified, one-level-deep references (motion-patterns.md, motion-easing.md — the #animatable-fields anchor exists), plus a clear cross-link to the foundational figma-use skill. Nothing that belongs in a reference is inlined. | 5 / 5 |
Total | 19 / 20 Passed |