Content
96%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 orchestrating skill: concrete commands, paths, and tool parameters; a clearly sequenced flow with user-facing checkpoints and feedback loops; and guardrails that are operational rather than aspirational. The only structural gap is that sibling-skill references (poteto-mode, create-skill, unslop) are by name only, without paths, keeping progressive disclosure at 4.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — no padding, no explanations of concepts Claude already knows, and rationale is given only where it changes behavior ("Don't glob across ~/.cursor/projects/*/. That crosses workspace boundaries and reads private chats from unrelated projects."). Every section earns its tokens; matches anchor 5 rather than anchor 4's "minor instances of over-explanation that could be trimmed". | 5 / 5 |
Actionability | Concrete, executable specifics throughout: exact glob paths (`.cursor/skills/**/*-mode/SKILL.md`), a real command (`git log -1 --format=%cI <path>`), AskQuestion parameters (`allow_multiple: true`, 4-6 options), exact placement rules, and frontmatter formatting rules. For an instruction-only skill this is copy-paste-ready guidance; matches anchor 5. | 5 / 5 |
Workflow Clarity | Steps 0-6 are clearly sequenced with branch logic for update-vs-fresh, explicit checkpoints (confirm intent via AskQuestion, cross-check signals across 2+ slices before elevating), and feedback loops ("Show the draft to the user and take feedback. Expect multiple iterations"; "Cut ruthlessly"). Anti-drift check: this fits anchor 5's explicit validation and feedback loops better than anchor 4's "minor validation gaps". | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the ~100-line body is well sectioned with nothing that clearly belongs in a separate file. The one gap: "The **poteto-mode** skill shows the shape. Read it for granularity." references a skill by name without a path, and create-skill/unslop are likewise name-only references — signal is clear but not path-resolvable. Good structure overall (anchor 4), short of anchor 5's "well-signaled one-level-deep references". | 4 / 5 |
Total | 19 / 20 Passed |