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.
The body is highly actionable, with copy-paste commands for each sweep, a fully specified ranking and synthesis ordering, a genuinely validated workflow (freshness check with a regenerate-on-mismatch recovery loop), and clean one-level-deep reference usage verified against the actual bundle. Its one weakness is redundancy: the same three core principles are each restated across Mindset, Rules, Workflow, and a ~60-line Anti-Patterns section, two of whose entries largely duplicate each other.
Suggestions
Merge Anti-Patterns 2 and 5 -- both argue that a register/tech-debt pick must not be presented with rubric-sorted confidence; combine them into one entry keeping both BAD/GOOD pairs and one Consequence.
Cut the repeated WHY rationales in the Anti-Patterns section: each anti-pattern restates a Rule already stated in full above (empty-list fallthrough, no-mutation, freshness). Keep one canonical statement in Rules and let Anti-Patterns carry only the BAD/GOOD/Consequence example.
Fold the Mindset section's empty-list point ("an empty follow-up list is a completely normal outcome ... never grounds for stopping") into Rule 2, where it is stated nearly verbatim, to remove one of the four repetitions of that principle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is substantive and project-specific throughout -- no generic concepts are re-explained -- but its three core principles are each restated 3-4 times across sections: the empty-list fallthrough appears in Mindset ("an empty follow-up list is a completely normal outcome ... never grounds for stopping"), Rule 2, Workflow step 2 ("If none are ACTIVE, say so explicitly and continue anyway (Rule 2)"), and Anti-Pattern 1; the read-only/no-mutation rule in Rule 1, When NOT to Use, and Anti-Pattern 3; and the judgment-call caveat in Rule 3, step 4, Anti-Pattern 2, and Anti-Pattern 5. Anti-Patterns 2 and 5 argue the same point (never present an ungraded register/tech-debt pick with rubric-sorted confidence) in near-duplicate form. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 4 anchor, whose over-explanation is only minor and incidental rather than systematic across a ~60-line Anti-Patterns section. | 3 / 5 |
Actionability | Every sweep has a copy-paste-ready command ("find .context -name '*.md' | wc -l", "grep -il 'status: active' .context/follow-ups/*.md", "grep -c '| Open ' docs/RISK_REGISTER.md docs/TECH_DEBT.md"), prerequisites list exact paths, step 2a fully specifies the sort (severity CRITICAL/HIGH/MEDIUM/LOW, then priority P1/P2/P3, then newest date, then path, case-insensitive) including edge handling for missing/partial/invalid grades, and the report format is pinned to a worked example plus blank template in references/worked-example.md. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases' rather than the 4 anchor, which anticipates gaps in the guidance. | 5 / 5 |
Workflow Clarity | Six steps are clearly sequenced with an explicit validation checkpoint and recovery loop up front (step 1 freshness check: compare index header count to actual file count, and "If the result diverges meaningfully from the index's own header comment, run context-index first"), and branching is handled explicitly at each step ("If none are ACTIVE, say so explicitly and continue anyway (Rule 2)"; ungraded follow-ups listed separately with a count). The skill is read-only by design, so the destructive/batch validation cap does not apply. This matches the 5 anchor ('Clear sequence with explicit validation steps; feedback loops for error recovery') rather than the 4 anchor, which requires minor validation gaps; the '2a' step numbering is slightly irregular but the sequence and cross-references remain unambiguous. | 5 / 5 |
Progressive Disclosure | Both body references resolve to real bundle files (references/backlog-triage-and-ranking.md and references/worked-example.md, verified present), are one level deep and self-contained (the triage reference explicitly says it exists so the workflow 'doesn't have to re-read either source in full', with the canonical instructions dir noted only as an authority pointer, not a required navigation hop), and are well-signaled both inline at point of use (steps 2, 5, and the intro) and in a References table with When-to-Use columns. SKILL.md stays the overview while disposal logic and the report format are appropriately split out. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation' rather than the 4 anchor, which requires organization gaps. | 5 / 5 |
Total | 18 / 20 Passed |