Content
86%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 reference skill: overview table, core rules with counter-examples, and cleanly split one-level-deep reference files that all exist. Its only real weakness is redundancy — three overlapping lookup structures (Quick Reference, Frequently Missed, Common Mistakes) restate many of the same ~26 conventions — which costs tokens without adding new information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven ('Quick Reference' with 24 convention rows, tight ✓/✗ code blocks), and rationale lines like 'This is load-bearing, not cosmetic' are brief and earned. However, the same conventions appear three times across the Quick Reference, 'Frequently Missed Conventions', and the 26-row Common Mistakes table (e.g. New/NewTypeName, isConnected, lowercase error strings each recur), so it sits at 'efficient with minor over-explanation that could be trimmed' rather than perfectly lean. | 4 / 5 |
Actionability | Every rule is paired with exact, copy-ready identifiers: 'MaxPacketSize', 'parseHTTPResponse', 'mrand "math/rand"', mistake→fix pairs like '`GetName()` getter → Go omits `Get`', and concrete tooling handoffs ('revive, predeclared, misspell, errname', gopls rename). This fully matches the anchor 'fully executable; specific examples cover the common cases' for a convention-reference skill. | 5 / 5 |
Workflow Clarity | As a lookup/reference skill the single action is unambiguous (check the table, apply the rule), and the risky batch operation it implies — renaming identifiers — is delegated with validation checkpoints ('refuses a rename that would break interface satisfaction', linter enforcement). It is not a 5 because the apply-fix path is delegated rather than sequenced in-skill, and there is no explicit validate-then-proceed loop inside this skill. | 4 / 5 |
Progressive Disclosure | Clear overview (Quick Reference + core rules) with five well-signaled, one-level-deep references under 'Detailed Categories', each annotated with its topic ('Getter/setter patterns (Go omits `Get`...)', 'Interface naming (`Reader`, `Closer` suffix with `-er`)'). All five referenced files exist in ./references/ with no deeper nesting — an exact match to the anchor example structure. | 5 / 5 |
Total | 18 / 20 Passed |