Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise routing skill that efficiently maps file patterns to language-specific standards files. Its main weakness is the lack of concrete tool invocation examples and missing error handling for cases where standards files don't exist. The workflow is understandable but would benefit from explicit sequencing and edge case handling.
Suggestions
Add an explicit example of the Read tool invocation, e.g., `Read file: ../../code-standards/go/CLAUDE.md` to make the loading step fully actionable.
Add a brief error handling note for when a standards file is missing or unreadable (e.g., 'If the standards file does not exist, proceed with default conventions and note the missing file to the user').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient. It avoids explaining what coding standards are or how languages work. Every section serves a clear purpose: detection table, loading instruction, application rule. No wasted tokens. | 3 / 3 |
Actionability | The language detection table with file patterns and paths is concrete and useful. However, the 'Loading Standards' and 'Applying Standards' sections are somewhat vague — they mention using 'the Read tool' but don't show the exact invocation, and 'follow these standards' is abstract guidance without showing how to handle conflicts between defaults and project conventions. | 2 / 3 |
Workflow Clarity | The workflow is implicit rather than explicitly sequenced: detect language → check if already loaded → read file → apply standards. There's no validation step (e.g., what to do if the standards file doesn't exist or can't be read), and the session-caching logic ('only load once per language per session') lacks guidance on how to track what's been loaded. | 2 / 3 |
Progressive Disclosure | The skill is appropriately structured as a concise overview that delegates detailed standards to separate per-language CLAUDE.md files via clear one-level-deep references. The table format makes navigation easy. For a skill under 50 lines with clear external references, this is well-organized. | 3 / 3 |
Total | 10 / 12 Passed |