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 tightly written, highly operational skill: every step is executable, batch output is explicitly validated with reshoot feedback loops, and the recipes are properly offloaded to the example shots file. The only slack is a couple of trimmable rationale sentences in the intro and crop-guidance sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with project-specific operational knowledge (ports, scratch paths, lockfile drift, mock endpoints) and never explains concepts Claude already knows, but a few rationale sentences ('That contrast is what makes a crop read as…') and the 56px padding detail — which the script already encodes — could be trimmed. | 4 / 5 |
Actionability | Every step ships an exact, copy-paste-ready command ('node .claude/skills/ui-screenshots/scripts/setup-scratch.mjs', the server line with --port 43219, 'kill $(lsof -tiTCP:43219 -sTCP:LISTEN)'), and the bulk recipes plus field reference are provided as a working file (scripts/shots.example.mjs, verified present). | 5 / 5 |
Workflow Clarity | A 9-step workflow with explicit validation ('Look at every image… Check for: a crop that slices through a label or pill… Fix and reshoot with --only'), error-recovery loops ('If it dies with Cannot find package…, run pnpm install --frozen-lockfile'), in-context verification via preview-web.mjs, and scoped cleanup. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear workflow overview; the heavy material (shot recipes and the field reference) is offloaded exactly one level deep to scripts/shots.example.mjs, every referenced script path exists in the bundle, and sections are clearly headed with no nested references. | 5 / 5 |
Total | 19 / 20 Passed |