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 lean reference skill: a compact four-mode capability matrix of non-obvious, project-specific facts capped by a clear decision rule. The only gap is the absence of any guidance for programmatically detecting the current mode, which an implementer would need to act on the rule.
Suggestions
Add a brief note on how to detect the active mode in code (e.g. checking previewServerConnected or a browser/deployed flag), since the decision rule depends on knowing the current mode.
Optionally enumerate which server-backed actions are affected (codemods, package installs, 'Open in') per mode in a compact table so the hide/disable decision is fully mechanical.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumption-respecting: no explanation of what Remotion is, and every line carries project-specific facts Claude would not know ('previewServerConnected is false', 'Deployed at remotion.new', 'GitHub is the only supported "Open in" action'). This matches anchor 5's 'every token earns its place'. | 5 / 5 |
Actionability | Concrete, instruction-only guidance: per-mode capability constraints plus the directive 'determine which modes support it and hide or disable it everywhere else' and 'Hide or disable actions that require a server'. It stops short of fully executable guidance because it never says how to detect which mode the Studio is running in (e.g. how to check previewServerConnected or detect the browser Studio), fitting anchor 4's 'minor gaps' rather than anchor 5. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose skill (under 50 lines, one decision procedure) and the single action is unambiguous: determine mode support from the enumerated capabilities, then hide or disable the action elsewhere. Per the simple-skill exception this matches a 5; the operation is also non-destructive, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references (no references/, scripts/, or assets/ directories exist), and the numbered mode list is well organized. This fits the guideline that such skills score 5 with just well-organized sections. | 5 / 5 |
Total | 19 / 20 Passed |