Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Excellent skill content that treats technical debt analysis as a cost optimization problem rather than a code quality checklist. The combination of executable git commands, a concrete worked example with real analysis, and explicit anti-patterns ('Do not rank by complexity alone') makes this immediately actionable. The output format template ensures consistent, stakeholder-ready deliverables.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place. The cost equation is essential framing, the signals table is dense reference material, and the worked example teaches by showing rather than explaining. No padding or concepts Claude already knows. | 3 / 3 |
Actionability | Provides executable git commands for every signal, a concrete worked example with real file analysis, specific paydown plans with time estimates, and a copy-paste output format. Claude can immediately apply this. | 3 / 3 |
Workflow Clarity | Clear sequence: gather signals → plot hotspot map → analyze with cost equation → produce prioritized output. The worked example demonstrates the full workflow, and the 'Do not' section provides explicit validation guardrails (coverage first, no rewrites). | 3 / 3 |
Progressive Disclosure | Well-structured with clear sections progressing from concept (cost equation) → data gathering (signals table) → visualization (hotspot map) → application (worked example) → constraints (do not) → output format. Appropriate length for a single file with no need for external references. | 3 / 3 |
Total | 12 / 12 Passed |