Content
86%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 an exemplary lean instruction-only skill: a tight five-step recovery procedure with explicit role handling, ask-user checkpoints, and clear delegation to sibling APM skills instead of duplicating their file lists. The only meaningful gap is the absence of an explicit verification step confirming the rebuilt state before continuing, and reliance on framework placeholders for full executability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and prescriptive with zero padding: it assumes APM knowledge (never explains what compaction, a Handoff, or the bus are) and every sentence carries an instruction, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'. It is not a 4 because there is no over-explanation that could be trimmed — even the gating paragraph adds a condition ('or an APM instruction directs you here') beyond the frontmatter. | 5 / 5 |
Actionability | Guidance is concrete and directive — reread '{SKILL_PATH:apm-2-initiate-manager} §1', keep the current prompt's 'log_path', record the recovery in 'the Tracker's Notes' — with both Manager and Worker branches covered, fitting 'Mostly executable guidance; concrete code or commands with minor gaps'. It is not a 5 because key operations resolve through templated placeholders and external structures ({VERSION}, {SKILL_PATH:...}, 'the bus and the code') rather than fully literal, self-contained instructions; not a 3 because no key details are missing for the APM context it targets. | 4 / 5 |
Workflow Clarity | Five numbered steps in a clear sequence with explicit checkpoints — 'If neither settles it, ask' (step 1), 'Ask the User about gaps the files cannot settle' (step 3), and the report-back in step 5 — matching 'Clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because there is no explicit verification that the rebuilt state matches the pre-loss state before continuing; not a 3 because checkpoints are explicit, not merely implied, and the operation is non-destructive so no cap applies. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files, and the body is well organized (title, gating, context, numbered procedure) while correctly delegating the file lists to the sibling initiation skills via clearly signaled one-level references ('{SKILL_PATH:apm-2-initiate-manager} §1'), matching both the under-50-lines guideline and 'Clear overview with well-signaled one-level-deep references'. No nesting or buried references exist, so no lower anchor fits. | 5 / 5 |
Total | 18 / 20 Passed |