Content
93%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 lean skill body: concrete commands and paths, project rules that capture non-derivable constraints, and a clean one-level reference split. The only gap is the absence of an explicit failure-handling loop around the test/build verification step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body contains only project-specific knowledge Claude cannot infer: paths ("/home/igor/SNB/snb-worktime-webui", "internal/web/static"), architecture constraints, category names ("worked, confirmed, unconfirmed, idle, disconnected, unknown"), and exact build commands. No padding and no explanation of concepts Claude already knows; every token earns its place, matching the 5 anchor. | 5 / 5 |
Actionability | Guidance is concrete and copy-paste ready: "go test ./..." and "GOOS=windows GOARCH=amd64 go build -o dist/snb-worktime-webui.exe ./cmd/snb-worktime-webui", plus specific packages ("internal/worktime") and file locations. Per the rubric's instruction-only-skill note, the absence of code samples is not penalized because the guidance is directly actionable; matches the 5 anchor. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence exists with an explicit validation gate ("Before finishing, run: go test ./... [and the] GOOS=windows ... go build"), and tests are required for parser/calculation changes. It is 4 rather than 5 because there is no explicit error-recovery feedback loop (e.g., what to do when tests or the build fail), and the read-README/confirm-map steps lack checkpoints. | 4 / 5 |
Progressive Disclosure | The body is a lean overview with well-organized sections (Overview, Workflow, Project Rules, Typical Tasks, References) and a single clearly-signaled, one-level-deep reference: "Read references/project-map.md before substantial changes", repeated in the References section. The referenced file exists and itself contains no nested references, matching the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |