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.
A highly actionable behavioral skill with explicit sequences, validation gates, and copy-paste-ready commands, templates, and hook configuration. Its weaknesses are length and organization: the pipeline is described three times, metaphor and cross-skill commentary add padding, and everything lives inline in one long SKILL.md instead of being split across reference files.
Suggestions
Consolidate the three separate pipeline descriptions (Lifecycle Position, When to Use the Full Pipeline, and Pipeline position) into one section and reference it elsewhere, cutting significant duplicate tokens.
Move the handoff file template and the intent-framed-agent relationship/cadence-separation details into a references/ file (one level deep) and link to them from the Exit Protocol and a short "Relationship with other skills" section.
Trim the Mental Model metaphor section and the "Handoffs become learning signals" section (which itself says nothing special is required) to their operational essentials — the wave-anchor and close-out terminology can be defined in one line each.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational guidance but noticeably padded: the pipeline is described three times (Lifecycle Position, When to Use the Full Pipeline, and Pipeline position), the extended surfing metaphor ("Paddling in", "The peak", "The shoulder", "The close-out") is conceptual overhead, and the "Handoffs become learning signals" section opens with "You don't need to do anything special". It sits at the mostly-efficient-but-could-be-tightened anchor rather than anchor 2 because it never explains concepts Claude already knows. | 3 / 5 |
Actionability | Guidance is fully executable: exact commands (`entire status`, `ls .context-surfing/handoff-*.md`, `touch '<handoff-path>.consumed'`), a copy-paste-ready hook JSON config, a complete handoff file template with every section specified, and an explicit subagent brief for the cold-context review. For an instruction-only skill, all common cases (Entire present/absent, intent frame present/absent, drift vs. clean completion) are covered. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints: Activation → Drift Detection (strong/weak/not-drift taxonomy) → Recovery Protocol with a bounded re-anchor limit ("at most one local re-anchor and one cold-context check") → Exit Protocol (stop, write handoff, notify) → next-session resume steps. The pre-commit anchor check (quote verbatim → state pending action → verify trace-back) and the handoff template act as checklists with feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The bundle contains a single script (scripts/handoff-checker.sh) which is correctly referenced by the hook config, but the body itself is a ~415-line monolith: content that would fit reference files — the intent-framed-agent relationship and cadence-separation details, the handoff template, and the interoperability/pipeline listings — is inlined in SKILL.md. Structure is good (clear section headers), matching the some-structure anchor rather than anchor 4's "most content is appropriately placed". | 3 / 5 |
Total | 16 / 20 Passed |