Content
56%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 well-structured with a clearly sequenced workflow and genuine operational detail (parallel reads, filename mapping, done/ handling, an AskUserQuestion fallback loop). Its two real defects are the delegation of report formatting to a reference.md that is missing from the bundle, and redundancy — the AskUserQuestion guard and trigger phrases each appear twice.
Suggestions
Restore reference.md (or a references/reference.md) to the bundle, or inline the essential report-formatting rules into SKILL.md — currently Phase 3, the skill's core deliverable, points to a file that does not exist.
Deduplicate the AskUserQuestion guidance: keep the detailed guard procedure in one place and have the anti-pattern bullet reference it in a single line rather than restating the rationale.
Replace the pseudo-bash comment blocks in Usage Examples with the actual commands/sequences (or trim the section), and drop the repetition of frontmatter trigger phrases in "When to Use".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational and free of concept explanations Claude already knows, but it could be tightened: the AskUserQuestion guard is stated in full twice ("⚠️ AskUserQuestion Guard" section and again as an anti-pattern), the frontmatter trigger phrases are repeated in "When to Use", and the ~20-line Usage Examples section contains only non-executable comments. This fits the mostly-efficient-but-could-be-tightened anchor at 3 rather than the minor-trims anchor at 4. | 3 / 5 |
Actionability | Phase 1 includes a real, executable command ("rtk ls -t .context/session/CONTEXT-*llm.md ...") and the filename mapping rule is concrete, but Phase 3 — the skill's core deliverable — delegates all report formatting to "See reference.md", and reference.md does not exist in the bundle. Missing key execution details for the main output fits anchor 3 rather than the minor-gaps anchor at 4. | 3 / 5 |
Workflow Clarity | Three phases are clearly sequenced (Detect & Read → Expand Resources → Format Report) with an explicit checkpoint: the empty-AskUserQuestion check with a fallback to a numbered text list and wait. It is not a 5 because validation steps are not fully explicit in the flow — the anti-pattern demands verifying session_id after load, yet no workflow step performs that check, and file-not-found recovery is only a brief mention of the done/ subfolder. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and the single reference is clearly signaled in two places (Phase 3 and a References section), but the sole referenced file, reference.md, does not exist in the bundle (no references/ directory, no reference.md at skill root), so navigation dead-ends exactly where the detailed rules live. A clearly signaled but broken pointer is more than a minor organization gap, placing this at anchor 3 rather than 4. | 3 / 5 |
Total | 13 / 20 Passed |