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.
A high-quality instruction skill body: concise and directive, rich with executable commands and a copy-paste output template, a clearly sequenced workflow with verification feedback loops, and exemplary progressive disclosure via delegation to named domain skills. The only lever is轻度 deduplication across the three caution-related sections.
Suggestions
Merge overlapping guidance across 'Verify before flagging', 'Confidence downgrades', and 'Common AI false-positive patterns' — several bullets restate the same 'read the config / cite a caller before claiming' idea and could be consolidated to tighten conciseness.
The 'Local invocation examples' section lists only two near-identical examples; either expand with genuinely distinct invocations or fold them into the 'When this skill applies' section to avoid redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, directive prose that assumes Claude's competence and avoids explaining basic concepts; held below 5 because the 'Verify before flagging', 'Confidence downgrades', and 'Common AI false-positive patterns' sections overlap thematically and a few bullets could be merged. | 4 / 5 |
Actionability | Provides concrete executable commands ('git diff origin/main...HEAD', 'gh pr diff <n>', 'make lint', 'make test', 'make update-codegen'), specific file paths, and a copy-paste-ready output format template covering the common cases. | 5 / 5 |
Workflow Clarity | A numbered 7-step workflow with explicit verification checkpoints ('Verify claims before commenting', the 'Verify before flagging' table) and feedback loops (downgrade to Question when a claim cannot be verified), matching the top anchor. | 5 / 5 |
Progressive Disclosure | Acts as a well-organized overview that delegates codebase-specific depth to clearly signaled one-level-deep domain skills (nic-structure, nic-add-feature, etc.) rather than inlining it, with clean section headers throughout. | 5 / 5 |
Total | 19 / 20 Passed |