Content
50%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-organized into clear phases with concrete commands and useful guardrails, but it relies on bundle files (reference.md for the CONTEXT template, scripts/upsert-index.sh) that are absent, undermining both actionability and progressive disclosure.
Suggestions
Add the missing reference.md (CONTEXT file template, status mapping, INDEX.md upsert logic) and scripts/upsert-index.sh to the bundle, or inline the template so the skill is executable from SKILL.md alone.
Fold the 'read existing context file before overwriting' guard into the Phase 1/3 workflow as an explicit checkpoint, and add a post-write verification step (e.g. confirm the file exists and INDEX.md was upserted).
Trim the editorializing Philosophy section and merge 'When Not to Use' with 'Anti-Patterns' to remove redundancy and tighten token use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and avoids explaining basics Claude knows, but the Philosophy section is editorializing and 'When Not to Use' overlaps with 'Anti-Patterns', so it could be tightened; not a 1 because no padded concept explanations are present. | 2 / 3 |
Actionability | Concrete commands are given (rtk ls, mkdir -p ... && mv ...) and Phase 2 specifies sections with token budgets, but the core output — the CONTEXT file template — is deferred to 'reference.md' which is not present in the bundle, leaving a key detail missing. | 2 / 3 |
Workflow Clarity | The three phases are clearly sequenced with stream-regex validation and status-gated archival, but the 'read existing file before overwrite' guard lives only in Anti-Patterns rather than the workflow, and there is no post-write verification; the destructive-ops guideline caps this at 2. | 2 / 3 |
Progressive Disclosure | A single one-level-deep reference is clearly signaled ('See reference.md for ...'), but the referenced file and scripts/upsert-index.sh do not exist in the bundle, so the navigation is broken rather than achieving easy navigation. | 2 / 3 |
Total | 8 / 12 Passed |