Content
85%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 well-structured, lean process skill: clear sequenced workflow with an explicit confirmation checkpoint and stop condition, concrete probes and file paths, and an appropriately placed one-level-deep reference. The only minor room for improvement is trimming a few coaching sentences and tightening the abstract guidance around problem understanding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with no explanations of concepts Claude already knows, but a few dispensable coaching lines ('Users arrive in different states, meet them where they are', 'The material you need may already be the thing they are trying to create') could be trimmed. Not 5 because these framing sentences don't earn their tokens. | 4 / 5 |
Actionability | Gives concrete, executable guidance: a specific probe script ('you have given me the what; I still need when the agent should reach for this...'), concrete paths (`.tessl/memory/preferences/` with `plugins.md`, `agents.md`, `source-control-and-ci.md`), and clear ask/hunt/infer decision rules. Not 5 because some direction stays abstract ('Get the problem clear in a sentence or two', 'make sure you understand the problem'). | 4 / 5 |
Workflow Clarity | Clear four-step sequence (understand -> take stock -> fill gaps -> confirm) with an explicit validation checkpoint and feedback loop ('Before handing to plan-composition, make sure you understand... If not, keep gathering. Do not jump to building') plus a separate 'When to stop' section. This validate-and-retry loop exceeds the anchor-4 example, and no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | The body is short and well-sectioned, and the single reference (references/hunting-artifacts.md, verified to exist) is one level deep, clearly signaled at its point of use in 'Fill the gaps', and appropriately splits the detailed hunting instructions out of the main flow. | 5 / 5 |
Total | 18 / 20 Passed |