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.
An exemplary overview skill: lean, dense, and structured entirely around orientation and routing, with concrete rules instead of fluff and clearly labeled one-hop pointers into the ginkgo:* family. The only improvement space is adding a minimal example spec to make the declare/initialize rule immediately copy-paste-able.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its tokens: the two-phase model is stated once, consequences are given as one-line rules ('Declare in the container, initialize in BeforeEach'), and the taxonomy is a compact labeled list. It assumes Claude's competence — no explaining what a test framework is, no library intros — matching the lean top anchor. | 5 / 5 |
Actionability | Guidance is concrete and directly followable: named nodes and decorators, explicit rules ('No assertions in container bodies', 'A goroutine that might fail needs defer GinkgoRecover()'), and real CLI flags (--randomize-all, -p, --focus). It stops short of a 5 because there is no small executable spec snippet illustrating the declare-vs-initialize pattern, leaving a minor gap for an instruction-only skill. | 4 / 5 |
Workflow Clarity | This is a single-purpose orientation skill under 50 lines whose one action — internalize the two-phase model, then route to the right sibling — is unambiguous, and the 'Where to go next' section gives a decision list with concrete destinations. Per the simple-skill exception this scores 5; no destructive or batch operations exist, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is exactly what an overview should be: a short mental model plus clearly signaled one-level-deep references ('→ ginkgo:writing-specs', '→ ginkgo:decorators', and a final routing section with descriptive labels). There are no bundle files in this skill, so nothing needs to be split out; sections are well organized and easy to navigate. | 5 / 5 |
Total | 19 / 20 Passed |