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 short conventions skill: every token carries project-specific knowledge mined from real review comments, with concrete script names, paths, and behaviors rather than abstractions. The only minor weakness is the build-vs-runtime section deferring entirely to other skills instead of summarizing the applicable rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~23-line body is lean with zero padding: it explains only project-specific conventions Claude could not know (e.g., why uninstall.sh must not remove shared system packages, that /back is legacy), never generic concepts. Every sentence carries non-obvious information, matching the 5 anchor. | 5 / 5 |
Actionability | Guidance is concrete throughout — exact paths ("install/production-filesystem/services/scripts/check-*.sh"), named scripts with their actual behaviors ("check-first-run-config.sh exits non-zero on a critical failure", "check-ramdisk.sh exits 0 even when it detects a real issue"), and explicit rules ("must only remove NetAlertX's own files"). It stops short of the 5 anchor because the build-vs-runtime section fully defers to other skills ("See the devcontainer-configs/devcontainer-management skills") without restating the applicable rule, leaving a minor gap. | 4 / 5 |
Workflow Clarity | This is a single-purpose conventions skill with no multi-step process; each section is an unambiguous rule, and the one implicit verification step is made explicit ("check what that specific script is actually guarding before suggesting a change to its exit behavior"). Under the simple-skill guideline this earns a 5; there are no destructive or batch operations requiring missing validation. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, needs no external reference files (none exist in the bundle), and is organized into clearly headed sections each covering one concern. Per the guideline for short skills with no external references, well-organized sections alone merit a 5; its cross-references to sibling skills are one level deep and clearly signaled. | 5 / 5 |
Total | 19 / 20 Passed |