Content
100%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 an exemplary procedural skill: exact commands, a concrete JSON payload format, a complete paste-text template, and explicit validation checkpoints (user approval gate, duplicate reporting, missing-prefix recovery, pbcopy fallback, empty-case guard) across a clearly numbered workflow. Setup and spec details are properly deferred to one-level-deep external references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean procedural instruction with zero padding — no concept explanations, just rules like "Never edit questions.md by hand; only the helper changes it" and exact commands. Every token earns its place; the only rationale sentence ("so several people or worktrees can ask questions about the same project without colliding") is brief and load-bearing, so this is not a 4. | 5 / 5 |
Actionability | Everything is executable: the exact invocation "yarn tsx .claude/skills/design-pull/design.ts <command> ...", concrete subcommands (`list-folders`, `set-prefix '<folder>' '<PREFIX>'`, `ask-add '<folder>' '<scratchpad>/ask-items.json'`, `ask-open '<folder>'`), a complete JSON template for ask-items.json, a full paste-text template, and `pbcopy < '<scratchpad>/ask-paste.txt'` with a stated fallback. Not a 4: there are no gaps — edge cases (single question vs. range, pbcopy unavailable) are covered. | 5 / 5 |
Workflow Clarity | Seven numbered steps with explicit checkpoints and error recovery: "If a command reports no question_prefix, ask the user for one... and run set-prefix", "Show the list and wait for the user to approve or edit it", "report the duplicates", "If pbcopy is not available, show the text and say it was not copied", and the step-7 no-op guard "If nothing was added or resent, say so and do not touch the clipboard". This matches the anchor-5 feedback-loop pattern; a 4 would lack some of these checkpoints. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed: the ~58-line body is appropriately self-contained with well-organized sections (Arguments, Rules, Steps). External material is deferred via clearly signaled one-level-deep pointers — "Spec: docs/.bruno/specs/2026-10-07-design-pull-ask-skills-design.md" and "Setup ... is in the Prerequisites section of .claude/skills/design-pull/SKILL.md" — matching the anchor-5 pattern of well-signaled single-level references. Not a 4: nothing that belongs in a separate file is inlined, and navigation is trivial. | 5 / 5 |
Total | 20 / 20 Passed |