Content
81%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 well-engineered, self-contained workflow: a crisp four-phase loop with explicit diagnostic validation, evidence-based recovery, and reporting templates, organized into scannable sections with a useful scope-boundary and cross-skill integration guide. Weaknesses are minor — slight redundancy in the heuristics section and a few directional rather than executable recovery instructions. It fully succeeds as an instruction-only skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and template/table-driven with no explanation of concepts Claude already knows; it earns an 'efficient, minor trimming possible' score because the 回復ヒューリスティクス section (lines 119-136) partially restates Phase 2/3 guidance and the 良いパターン list repeats the four-phase loop. Not a 5 due to that redundancy; not a 3 because there is no padded or over-explained content. | 4 / 5 |
Actionability | Concrete, actionable guidance throughout: three copy-paste markdown templates (障害キャプチャ, 回復アクション, 自己デバッグレポート), a failure-pattern table with specific errors (ECONNREFUSED, 429, 書き込み後にファイルが見つからない) and concrete checks, and an explicit anti-hallucination rule about not claiming to reset agent state. Not a 5 because some guidance remains directional rather than executable, e.g. 「推測的な推論から直接観察に切り替える」 and the checks column gives what to verify but not how. | 4 / 5 |
Workflow Clarity | A clearly sequenced four-phase loop (キャプチャ → 診断 → 回復 → レポート) with explicit validation checkpoints (「診断を検証する最小の可逆的アクションは何か?」), a post-recovery evidence requirement (「修正が機能したことを証明するエビデンスは何か」), a feedback-loop rule (「チェックがサポートする場合にのみ計画を変更する」), and outcome states (成功 | 部分的 | ブロック中). This matches the top anchor's 'explicit validation steps, feedback loops, and checklists'; no destructive or batch operations apply the cap. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent) and the single SKILL.md is well-sectioned with clear headers, a scope-boundary section, and nothing that clearly belongs in a separate file. Not a 5: at ~150 lines with three inline templates it exceeds the under-50-line simple-skill exception and content is not split across files; not a 3: organization is good and no inline content is clearly misplaced. | 4 / 5 |
Total | 17 / 20 Passed |