Content
100%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 instruction-only skill body: concrete tool-call syntax with arguments, explicit numeric thresholds for when to warn the user, batch guidance, and a defined fallback when the MCP server is unavailable. It stays lean while packing in only Repowise-specific knowledge Claude could not infer, and its section structure fully covers the skill's scope without needing bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is lean and assumes Claude's competence: no explanations of what refactoring or hotspots are, and every line carries Repowise-specific facts Claude cannot know (field semantics like 'fix_count over the trailing 6 months', the caveat 'the per-symbol counts are approximate — read them as "mostly here"', terse prioritization 'A file that keeps getting fixed is the strongest single signal... lead with it'). Re-checking anchor 4, no section is padded or could be trimmed without losing operational information. | 5 / 5 |
Actionability | Fully executable guidance: copy-paste-ready calls ('get_risk(targets=["path/to/file.py"])', the batch form 'get_risk(targets=["file1.py", "file2.py", "module/"])', 'get_context', 'get_health') plus specific numeric decision thresholds ('above 90th percentile', 'More than 10 dependents', 'Bus factor of 1', named risk types) and a concrete fallback for tool errors. Specific examples cover the common cases (single file, batch, refactor, error). | 5 / 5 |
Workflow Clarity | The workflow is sequenced by scenario (before editing → read risk signals → warn on thresholds → get_context before refactors → get_health for heavy refactors) with an explicit warning checklist as the validation gate before any modification and a clear error-recovery path ('If get_risk returns a tool error... Proceed with the modification but note that risk assessment was unavailable'). The destructive-operation cap does not apply: the skill itself is the pre-edit validation step, and the simple-skill exception (under 50 lines, single task) is satisfied. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, with no references/, scripts/, or assets/ bundle — nothing to offload. Five well-labeled sections ('Before editing a file', 'When modifying multiple files', 'When to warn the user', 'Before refactoring or moving code', 'Error handling') organize the content, matching the rubric's exception for short single-purpose skills. | 5 / 5 |
Total | 20 / 20 Passed |