Content
82%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 strong, highly actionable skill body that front-loads repo-specific knowledge (existing component discovery, deprecated sizing system, telemetry allowlist coupling) and defers bulk detail to external documents with precise navigation aids. Weaknesses are minor: one unresolvable 'recipe's step 3' reference and slight redundancy between the barrel export list and the instruction to read the barrel in full.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Windmill-specific knowledge Claude cannot already know (barrel paths, deprecated 'size'/'xs2' props, telemetry allowlist) and assumes competence throughout, matching 'Efficient; minor instances of over-explanation that could be trimmed'. Not 5: the full export list partially duplicates 'read it in full' instructions, and emphatic asides like 'not after, and not only when something looks unfamiliar' could be tightened. | 4 / 5 |
Actionability | Fully executable guidance: exact import paths ('$lib/components/common', '$lib/components/select/Select.svelte'), runnable Svelte snippets with full prop signatures, and concrete commands like `grep -n '^#' frontend/brand-guidelines.md`. The examples (Button, TextInput, Select, lucide icons) cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | A clear phase order exists: a 2-step pre-work checklist ('Do both of these before the first line of markup'), an explicit feedback loop ('svelte-autofixer: MUST use... keep calling until no issues'), and post-change verification via Playwright MCP. Not 5: the end-to-end flow is distributed across sections rather than one explicit sequence, and verification details are deferred to frontend/AGENTS.md rather than inline. | 4 / 5 |
Progressive Disclosure | Strong deferral of bulk detail: 'Don't load all 34k chars — jump to the section' with a build-type-to-section table and grep-based line ranges, plus one-level-deep references (brand-guidelines.md, AGENTS.md, docs/feature-telemetry.md). Not 5: the reference 'see the recipe's step 3' is dangling — no recipe is identified anywhere, so the pointer cannot be resolved. | 4 / 5 |
Total | 17 / 20 Passed |