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.
An exemplary lean skill body: executable commands, concrete remediation rules, and clean separation of detail into a real, well-signaled reference file. The only improvements are minor — inlining the excludes-row format and making the rerun-after-fix validation loop explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean with zero padding: every sentence states a rule, a command, or a pointer ("The check measures AGENTS.md, CLAUDE.md, GEMINI.md and SKILL.md ... and no other file"), assuming Claude's competence throughout. It clearly matches anchor 5 rather than anchor 4, which reserves room for trimmable over-explanation. | 5 / 5 |
Actionability | Copy-paste-ready commands cover both run modes, and remediation guidance is concrete ("cut restated content first, split only at a real subject boundary, and never delete a rule to fit"). It sits at anchor 4 rather than 5 because the excludes-row format — central to the described "add/tune" use case — is delegated to policy.md instead of being shown inline. | 4 / 5 |
Workflow Clarity | The sequence is clear: run the check, remediate in the stated priority order, or add an excludes row with a reason; the check itself before review and in CI serves as the validation checkpoint. Anchor 4 rather than 5 because the fix-then-rerun feedback loop is implicit — the body never says to re-run the check after remediation. | 4 / 5 |
Progressive Disclosure | The body is a concise overview with well-signaled, one-level-deep references: class selection and exclusion format point to references/policy.md (verified to exist and hold exactly that detail, with section anchors used in the links), flags/exit codes delegate to `doc-limits --help`, and the script bundle (scripts/doc-limits, scripts/lib/) is appropriately separated. This matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |