Content
81%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 behavioral protocol with a clearly sequenced lifecycle, explicit validation gates, and copy-paste-ready commands, templates, and hook configuration. Its weakness is token efficiency: metaphor-driven framing, motivational prose, and duplicated anchor/check descriptions inflate the length — ironic for a skill about conserving context — and the single-file structure forgoes reference-file splitting.
Suggestions
Cut the extended ocean-wave metaphor ('Paddling in… The close-out', 'No wipeouts. No zombie sessions.') and the closing Principles section — the drift taxonomy and protocols carry the skill on their own and would trim roughly 15-20% of tokens.
Remove duplication: the wave-anchor list appears twice (Activation and the stranded 'Full pipeline / Partial pipeline / Standalone' bullets that currently dangle after 'Handoffs become learning signals' — move or delete them), and the pre-commit anchor check is fully described in the Monitoring Paradox section and then restated in 'Riding the Wave'; keep one canonical description and one cross-reference.
If the skill grows further, move the 40-line handoff template and the drift-signal taxonomy into a references/ file and keep SKILL.md as a leaner overview, per progressive-disclosure best practice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is dense, novel protocol (drift taxonomy, recovery/exit steps, handoff template) rather than concepts Claude already knows, but there are several padded passages: the extended ocean-wave metaphor ('Paddling in… The close-out'), motivational prose ('No wipeouts. No zombie sessions.', the closing Principles section), a duplicated anchor enumeration, and a stranded pipeline bullet list that repeats activation guidance. This sits between anchors 2 and 3 — the padding is roughly a quarter of the document, above the midpoint, so 3 rather than 2. | 3 / 5 |
Actionability | Fully executable guidance throughout: copy-paste commands ('entire status 2>/dev/null', 'ls .context-surfing/handoff-*.md 2>/dev/null'), a complete settings.json hook configuration with exact script path (verified to exist in the bundle), an exact handoff filename pattern and full template, explicit re-anchor limits ('at most one local re-anchor and one cold-context check'), and a concrete read-only subagent brief. Standalone-mode fallbacks cover the common cases where optional dependencies are absent. | 5 / 5 |
Workflow Clarity | The lifecycle is clearly sequenced (activation → drift detection → recovery protocol → exit protocol → next-session resume) with explicit validation checkpoints: the pre-commit anchor check gates every side-effecting action, the recovery protocol is a bounded feedback loop with escalation, and the handoff is 'marked consumed only after re-entry succeeds'. The handoff template doubles as a checklist. No destructive or batch operations apply the score-3 cap. | 5 / 5 |
Progressive Disclosure | Good section structure with clear headers and a real, correctly pathed bundle script reference (scripts/handoff-checker.sh, confirmed present). Not score 5 because the SKILL.md is a ~420-line monolith rather than an overview pointing to reference files — the handoff template and drift-signal taxonomy are candidates for separate reference files — and there are minor organization gaps, notably the stranded 'Full pipeline / Partial pipeline / Standalone' bullet list that belongs in the Activation section. | 4 / 5 |
Total | 17 / 20 Passed |