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.
A well-engineered skill body: an actionable decision tree front and center, terse but concrete rules, a built-in self-correction checklist, and a clean ten-file reference layer with accurate per-file summaries. Only minor trimming of duplicated statements (escalation and reproduce-first each appear twice) keeps it from full token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — no explanations of concepts Claude already knows, a compact symptom-to-command decision tree, and terse golden rules. It is not a 5 because of small redundancies: the escalation principle appears both as intro step 5 ("Escalate tools incrementally") and Golden Rule 7 ("Start Simple"), and "reproduce before you fix" is repeated across intro step 2 and Rule 2. | 4 / 5 |
Actionability | The decision tree maps every common symptom to a copy-paste command — "go build ./... 2>&1, go vet ./...", "GOTRACEBACK=all ./app", "go test -race ./...", "curl localhost:6060/debug/pprof/goroutine?debug=2" — and the body includes concrete install ("go install github.com/go-delve/delve/cmd/dlv@latest") and analysis flags ("go build -gcflags=\"-m\""). This matches the fully-executable anchor with common cases covered. | 5 / 5 |
Workflow Clarity | A clear six-step sequence opens the guide, the "Red Flags" section is an explicit feedback loop ("If any of these are happening, stop and return to Step 1"), and the cycle "Read the Error → Reproduce → Measure One Thing → Fix → Verify" gives a validation checkpoint. This matches the anchor for clear sequence with explicit validation, error-recovery loops, and a checklist; score 4 would require missing checkpoints, which are present. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview — decision tree, rules, red flags — and all ten reference files are one level deep, each cited with a one-sentence content summary in the Reference Files section and linked by symptom from the decision tree. Every referenced path was verified to exist and none nest further. This matches the clear-overview, well-signaled, one-level-deep anchor; it is above score 4, which permits organization gaps. | 5 / 5 |
Total | 19 / 20 Passed |