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 well-structured, highly actionable skill body: the 5-phase workflow is unambiguous, state persistence and error recovery are handled explicitly, and detail is properly pushed into three real, well-signposted reference files read at defined moments. The only weakness is mild — a little conversational framing that could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — tables, terse numbered steps, and concrete tool calls with no explanations of concepts Claude already knows. It sits at anchor 4 rather than 5 because of minor trimmable framing: the role preamble ('You are a design consultant embedded in a developer's workflow') and a few justificatory asides ('the interview is where most of the value is') add tokens without adding instruction. | 4 / 5 |
Actionability | Guidance is directly executable: exact SDK calls (`create_project`, `generate_screen_from_text` with `deviceType: DESKTOP`), versioned filename conventions (`desktop-v1.html`), platform-specific open commands (`open`/`xdg-open`/`start`), a copy-paste zip command, a completed DESIGN.md template, and a feedback-to-tool mapping table. Deferring exact SDK parameter shapes is explicitly justified ('consider the Stitch SDK documentation as the ground truth'; tool names discovered via `list_tools`), which satisfies the pseudocode exception. | 5 / 5 |
Workflow Clarity | The five phases are clearly sequenced with per-phase transition rules ('Move to Phase B when you have: project name + what it does + target users + desired CTA'), explicit validation checkpoints (SDK auth verification in Phase 0, full-summary confirmation before generation), loop guardrails at rounds 3 and 5, and a dedicated Resume & Error Recovery section covering async completion, rate limits, and project expiry. This matches the anchor 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clean overview with a Reference Files table giving per-file 'When to read' and 'Contains' columns; all three referenced files exist and are one level deep with no nested chains (the single cross-link in interview-framework.md points laterally to a sibling reference, reachable directly from SKILL.md). Detailed material (question bank, font mappings, pitfalls, DEPLOY template) is correctly split out of the main body. This matches the anchor 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |