Content
90%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 tight, highly actionable orchestration skill: lean prose, concrete paths and commands, a clearly sequenced flow with user-facing checkpoints, and appropriately referenced (not inlined) sibling skills. The only structural gaps are minor — implicit landing/trigger verification and unverified/relative external references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — e.g. "Don't dump 20 questions.", "Cut ruthlessly. A mode skill is not a manual.", "Patterns seen in 2+ slices are high-confidence. Lone signals are weak and usually get dropped." — with no explanation of concepts Claude already knows and every line carrying instruction. It assumes competence and earns its tokens, matching the 5 anchor rather than the 4 anchor (no trimmable over-explanation found). | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: concrete paths ("`.cursor/skills/<handle>/<handle>-mode/SKILL.md`", "`~/.cursor/skills/*-mode/SKILL.md`"), a runnable command ("`git log -1 --format=%cI <path>`"), tool parameters ("`AskQuestion` … 4-6 options each, `allow_multiple: true`"), and specific subagent slicing instructions ("last 2-4 weeks, split into 3 slices"). Per the scoring notes, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Steps 0–6 are clearly sequenced with real checkpoints: intent confirmation via AskQuestion in step 0, cross-slice validation in step 1 ("Cross-check across slices before elevating a signal"), and an explicit user feedback loop in step 5 ("Show the draft to the user and take feedback. Expect multiple iterations."). Not a 5 because a few checkpoints are implicit rather than explicit validation steps (e.g. no check that the PR landed or that the new skill actually triggers), though no destructive or batch operation requires a cap. | 4 / 5 |
Progressive Disclosure | Good structure with well-organized sections (Flow, Guardrails, Evaluation, When not to use) and clearly signaled one-level references (the adapter doc at the top, "The **poteto-mode** skill shows the shape. Read it for granularity.", "Reference, don't inline"). Not a 5: sibling skills are referenced by name without paths, and the adapter path `../../docs/harness/claude-code.md` points outside the skill directory and could not be verified to exist; no bundle files are present to absorb any detail. | 4 / 5 |
Total | 18 / 20 Passed |