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.
A well-structured, opinionated skill body with concrete commands, a clearly sequenced workflow including validation checkpoints, and proper one-level-deep reference file usage. The main weakness is mild verbosity in the formatting/epitaph-spec sections.
Suggestions
Tighten the tombstone card and epitaph-rules sections — the ASCII card column-width spec and four epitaph rules could be compressed without losing the intent.
Make the world-check step more concrete with an explicit search-and-cite loop (e.g. 'search the API/SDK named in the evidence; record found vs. not-found') rather than prose guidance.
Add an explicit verify-and-retry checkpoint around the resurrection plan's Step 0 ('confirm it still runs') so failure produces a defined next action rather than just a stated requirement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (e.g. 'two questions is a conversation; five is a deposition'), with some sections that could be trimmed — the epitaph rules and tombstone card spec are wordy relative to the core workflow. | 4 / 5 |
Actionability | Executable commands throughout (the run invocation, --days/--json/--me/--include-foreign/--state flags, the --mark-resurrected recording step) with concrete examples; the ASCII card is a precise spec, though the world-check step relies on search rather than a runnable command. | 4 / 5 |
Workflow Clarity | Clear multi-step sequence (scan -> read report -> interview -> tombstone report -> world-check -> resurrection plan -> record state) with explicit validation checkpoints (Step 0 'confirm it still runs', 'ask before touching the repo', evidence-before-repeating-a-cause); capped below 5 because some checkpoints are prose rather than a verify-and-retry loop. | 4 / 5 |
Progressive Disclosure | Well-organized overview in SKILL.md with one-level-deep, clearly signaled references to scripts/graveyard.py and references/causes-of-death.md, both of which exist as real bundle files; the taxonomy is correctly offloaded to the reference rather than inlined. | 5 / 5 |
Total | 17 / 20 Passed |