Content
32%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 lean overview that correctly delegates detail to sub-modules, but the actual instructions are empty and every referenced sub-skill file is missing, leaving no executable guidance. It reads as an incomplete skeleton rather than a working skill.
Suggestions
Populate the empty "## Instructions" section with concrete, executable steps for conducting technical debt analysis (e.g., specific commands, metrics to collect, analysis commands), or inline a quick-start example.
Provide the eight referenced ./sub-skills/*.md files so the progressive-disclosure links resolve; until they exist, inline the most critical guidance directly in SKILL.md.
Add validation checkpoints to the workflow (e.g., confirm debt items are measurable, verify remediation ROI before prioritizing) so the multi-step process has explicit feedback loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with no concept over-explanation, but it repeats the frontmatter description verbatim and carries generic "Use this skill when / Do not use this skill when" boilerplate that could be tightened, matching the mostly-efficient-with-some-unnecessary-content anchor. | 3 / 5 |
Actionability | The "## Instructions" section is empty and the only guidance is a list of eight module links, all of which point to non-existent files; there is high-level structure but no specific executable steps, matching the minimal-guidance anchor. | 2 / 5 |
Workflow Clarity | The eight modules imply a rough sequence (inventory → impact → metrics → plan → implementation → prevention → communication → success metrics), but steps are poorly defined, validation checkpoints are absent, and the linked files do not exist, matching the rough-sequence-many-gaps anchor. | 2 / 5 |
Progressive Disclosure | References are one level deep and cleanly signaled as a numbered list, but all eight referenced ./sub-skills/*.md files are absent from the bundle, so the disclosure structure is broken and navigation dead-ends, falling below the well-organized anchors. | 2 / 5 |
Total | 9 / 20 Passed |