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.
The body is a lean, actionable, host-specific instruction set: exact tool identifiers, a concrete argument example, validation and retry logic, and well-scoped constraints. Its only flaws are minor redundancy (the start-canvas.sh warning stated twice) and a somewhat long global-entrypoint paragraph.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with host-specific facts Claude cannot know (tool names, projectDir semantics, outputTemplate, global entrypoint behavior) and contains no general-concept padding. It is not 5 because the "do not start scripts/start-canvas.sh" warning appears in both Workflow step 1 and Constraints, and the global-entrypoint paragraph could be tightened. | 4 / 5 |
Actionability | Gives the exact tool name and its full host form ("mcp__cowart_mcp__render_cowart_canvas_widget"), a copy-paste-ready JSON argument {"projectDir": "/absolute/path/to/user/codex-project"}, concrete storage paths, and a specific failure-recovery path. Fully executable guidance for an instruction-only skill. | 5 / 5 |
Workflow Clarity | Three numbered steps with an explicit validation checkpoint ("Confirm the widget opens for the user") and a feedback loop for error recovery (tool not visible → discovery → retry within the same task → only then suggest a new task). The operation is non-destructive, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external reference files, and is organized into clear Workflow and Constraints sections, which merits a 5 per the simple-skill guideline. The mentioned scripts/start-canvas.sh is absent from the bundle but is explicitly designated a do-not-use local-development fallback, so it does not create buried navigation. | 5 / 5 |
Total | 19 / 20 Passed |