Content
77%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.
An exceptionally actionable and well-sequenced process skill — every protocol is executable, validated, and has explicit feedback loops and limits. Its weaknesses are repetition (anchor lists and pipeline descriptions each stated three times) and a monolithic structure that inlines exit-time and setup-time material a leaner SKILL.md would offload to reference files.
Suggestions
De-duplicate the anchor-loading list and the pipeline description — state each once and cross-reference it elsewhere ('see Activation for the anchor list'), which would cut roughly 15% of the body.
Move the handoff file template, hook integration JSON, and interoperability sections into references/ files loaded only at exit or setup time, keeping SKILL.md as the lean overview.
Trim the metaphor framing ('No wipeouts. No zombie sessions.', the extended Mental Model) to a single line — the operational content stands on its own.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense, non-obvious operational guidance, but with real repetition: the anchor-loading list appears three times (Activation, 'Always load at activation', Recovery Step 1), the pipeline is described three times (Lifecycle Position diagram, task-type table, numbered 'Pipeline position'), the 'read fresh, not from recall' rule recurs several times, and the surf metaphor adds padding ('No wipeouts. No zombie sessions.'). Fits anchor 3 (mostly efficient, could be tightened) rather than 2, since most sections earn their tokens. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste commands ('entire status 2>/dev/null', 'ls .context-surfing/handoff-*.md 2>/dev/null'), a complete settings.json hook config with install-path variants, install commands, a verbatim handoff file template with an exact naming pattern, and a ready-to-use user-notification message. The one non-verbatim item (the subagent review brief) is still specified field-by-field: status, anchors read, concrete observations, alignment, and a continue/re-anchor/hand-off recommendation. | 5 / 5 |
Workflow Clarity | The lifecycle is clearly sequenced (Activation → Riding the Wave → Drift Detection → Recovery Protocol → Exit Protocol → handoff → re-entry) with an explicit validation checkpoint (the pre-commit anchor check: quote verbatim from a fresh read → state pending action → verify trace-back), a capped feedback loop ('Allow at most one local re-anchor and one cold-context check for the same drift episode'), defined escalation branches, and a checklist-style handoff template. No validation step is missing, so it matches anchor 5 over anchor 4. | 5 / 5 |
Progressive Disclosure | The single bundle file (scripts/handoff-checker.sh) is real, correctly referenced in the Hook Integration section with a copy-paste path, and section headers make the document navigable — but the skill is a ~420-line monolith with no references/ files at all. Content needed only at specific moments (the handoff template, hook setup JSON, interoperability with sibling skills, learning-signal details) is inlined rather than split into on-demand files, matching anchor 3 ('content that should be separate is inline') more than anchor 4. | 3 / 5 |
Total | 16 / 20 Passed |