Content
57%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 a maximally concise redirect stub that delegates everything to an external repo path. While token-efficient, it provides no actionable content of its own: the referenced file is outside the bundle, "Use" is ambiguous, and "regardless of path setting" is unexplained, leaving the reader unable to act confidently from the skill alone.
Suggestions
State the action concretely, e.g. "Before writing or modifying a docstring, read @.claude/rules/docstrings.md and apply its conventions" — 'Use' alone is ambiguous about whether to read, apply, or validate.
Bundle the conventions file (e.g. in references/) or inline the core rules, since .claude/rules/docstrings.md lives outside the skill and is not part of the bundle, making the skill break if that path moves.
Explain or drop "regardless of path setting" — the clause is cryptic without context; either clarify what path setting it overrides or remove it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a single lean line — "Use @.claude/rules/docstrings.md regardless of path setting" — with no padding and no explanation of concepts Claude already knows. Every token earns its place; this matches the anchor for lean and efficient content. | 5 / 5 |
Actionability | The only guidance is a pointer to an external file with no code, commands, or statement of what to do with it; the referenced file is not part of this skill's bundle (no references/ directory exists). This is minimal concrete guidance missing the specific steps to execute — anchor 2, not 3, since almost nothing is executable from the body itself. | 2 / 5 |
Workflow Clarity | The single action (use the rules file) is present but ambiguous — "Use" never says whether to read, apply, or validate against it, and "regardless of path setting" is cryptic without context. Under the simple-skill exception this could be 5 only if the action were unambiguous; it is not, so 3 fits. | 3 / 5 |
Progressive Disclosure | The body is a one-level-deep pointer, but it targets a path outside the skill bundle (.claude/rules/docstrings.md does not exist in this skill's directory tree), with no signaling of the file's contents and no fallback. Structure exists but is weakly organized and fragile — anchor 3. | 3 / 5 |
Total | 13 / 20 Passed |