Content
78%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.
The body is maximally lean and correctly delegates all detail to a single clearly-referenced file, but it is cryptic: the instruction is a bare pointer with an unexplained qualifier ('regardless of path setting') that leaves the reader guessing about precedence and intent. One or two clarifying words would make the guidance fully actionable without hurting token efficiency.
Suggestions
Explain what 'regardless of path setting' means in one clause (e.g., 'even if settings.json or project config points elsewhere, this file takes precedence') so the instruction is unambiguous.
State what to do with the referenced rules, e.g., 'Apply the rules in @.claude/rules/testing.md when writing the new test', to make the guidance self-contained.
Briefly confirm the guardrail from the description ('only if test rules are not present') in the body so the trigger condition and action are aligned.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a single line ('Use @.claude/rules/testing.md regardless of path setting') with zero padding or explanation of concepts Claude already knows — every token earns its place. | 5 / 5 |
Actionability | It gives one concrete pointer (an exact path, '@.claude/rules/testing.md') but no specifics about what to do with it, and 'regardless of path setting' is unexplained jargon — concrete guidance with missing key details. | 3 / 5 |
Workflow Clarity | As a single-action skill the simple-skill exception would allow a 5, but the qualifier 'regardless of path setting' introduces ambiguity (which path setting? what overrides what?), so the single action is not fully unambiguous. | 4 / 5 |
Progressive Disclosure | A single, clearly signaled, one-level-deep file reference with no inline bloat — the entire body is a pointer, which is exactly the appropriate split for this skill; no bundle files exist to verify, but the structure itself is optimal. | 5 / 5 |
Total | 17 / 20 Passed |