Content
85%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 well-structured overview skill that sequences a four-phase debugging workflow with explicit verification checkpoints and clean one-level-deep progressive disclosure. Minor conciseness redundancy and high-level (rather than in-body executable) guidance are the only weaknesses.
Suggestions
Trim the restated Core Principle sentence ('Random fixes waste time...') since the bold NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST line already conveys it, and consider whether the Quick Reference adds enough over the Four Techniques section to earn its tokens.
Add one short inline executable example (e.g., a sample find-polluter.sh invocation or a reproduce→isolate command pattern) so the body is actionable without requiring a reference load for common cases.
Narrow the 'When to Use' scope (e.g., drop or qualify 'investigating performance issues') to reduce overlap with dedicated performance/testing skills.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean overview, but the Core Principle is restated as 'Random fixes waste time and create new bugs...' and the Quick Reference re-routes the same Four Techniques, giving minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Concrete phased guidance (Phase 1–4 with sub-steps), a real referenced script (scripts/find-polluter.sh), and explicit 'Load when' triggers give mostly executable direction, though deep executable detail is delegated to references. | 4 / 5 |
Workflow Clarity | A clearly sequenced four-phase process with a gate ('Complete each phase before proceeding'), an explicit validation checkpoint ('Iron law: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE'), and a feedback loop (Red Flags → return to process). | 5 / 5 |
Progressive Disclosure | A clear overview points to four one-level-deep reference files plus one script, each signaled with references/X.md and a 'Load when:' trigger; all referenced files exist and a Quick Reference provides navigation. | 5 / 5 |
Total | 18 / 20 Passed |