CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-surfing

Monitors context window health during large, long-running, multi-session, or explicitly context-sensitive work. Uses bounded external anchors, one cold-context review when self-recovery is uncertain, and a clean handoff on real drift. Do not auto-activate merely because a medium task has an intent frame and plan.

64

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A genuinely actionable, well-sequenced process skill with concrete templates, commands, and strong validation feedback loops — the execution protocol is exemplary. It is dragged down by metaphor-heavy narration, redundant restatements of activation criteria and pipeline structure, and a monolithic layout that inlines material better split into reference files.

Suggestions

Cut the surfing-metaphor narration (the "rides the wave / No wipeouts" intro, the Mental Model wave phases, and the slogan-style Principles section) and state the activation criteria and pipeline position once instead of three times across Lifecycle Position, Activation, and Interoperability — this alone would trim 80–100 lines without losing any operational content.

Move the relationship-with-intent-framed-agent section, the pipeline-depth table, and the full handoff template into separate reference files (e.g., references/handoff-template.md, references/pipeline-interop.md) linked one level deep from SKILL.md, keeping SKILL.md as an overview of activation, drift signals, and the exit decision.

Supply the context-monitor subagent brief as a literal, copy-pasteable prompt block (or ship it as a bundle file like scripts/handoff-checker.sh) rather than describing its contents, so the cold-context review step is fully executable.

DimensionReasoningScore

Conciseness

The core protocols (drift signals, pre-commit check, recovery, exit) are tight and assume Claude's competence with no basic-concept over-explanation, but there is real padding: the surfing-metaphor narrative ("The agent rides the wave of peak context… No wipeouts. No zombie sessions."), the slogan-style Principles section, and activation criteria/pipeline structure restated three times (Lifecycle Position, Activation, Interoperability). Fits "mostly efficient but could be tightened" better than the notably padded anchor 2, though the ~20% flavor/redundancy is more than minor.

3 / 5

Actionability

Highly concrete for an instruction-only skill: exact commands ("entire status", "ls .context-surfing/handoff-*.md 2>/dev/null"), a copy-paste handoff file template with named sections, exact hook JSON with install paths, and a verbatim user-notification message. Not a 5 because the context-monitor subagent brief is described rather than supplied as a literal prompt, and the referenced "plugin/agents/context-monitor.md" is absent from this bundle (though a fallback is specified).

4 / 5

Workflow Clarity

The full lifecycle is clearly sequenced — activation/anchor loading, monitoring, Recovery Protocol (pause → re-read → reconcile → cold-context check → escalate → exit), Exit Protocol (stop → write handoff → notify), and next-session re-entry steps — with explicit validation (pre-commit anchor check before side-effecting actions), feedback loops, bounded re-anchor limits, and a checklist-style handoff template. This matches the top anchor including error-recovery loops.

5 / 5

Progressive Disclosure

Sections are well-headed and the one bundle file (scripts/handoff-checker.sh) is correctly referenced from the Hook Integration section, but the 428-line body is monolithic: the intent-framed-agent relationship, pipeline-position tables, and handoff template detail are inlined in SKILL.md where one-level-deep reference files belong, and the "Full pipeline/Partial pipeline/Standalone" bullet list is stranded mid-way through the "Handoffs become learning signals" section. Fits "some structure but content that should be separate is inline" better than the mostly-appropriately-placed anchor 4.

3 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities, gives an explicit and appropriately bounded activation condition, and even includes anti-trigger guidance to prevent over-activation. Its main weakness is internal jargon ("bounded external anchors", "cold-context review") that a first-time reader must decode, and slightly thin natural-language trigger synonyms.

DimensionReasoningScore

Specificity

Names the domain and several distinct concrete actions — "Monitors context window health", "one cold-context review when self-recovery is uncertain", "a clean handoff on real drift" — with only minor coverage gaps (drift detection signals and recovery protocol are not mentioned). Not a 5 because "bounded external anchors" is opaque jargon that names a mechanism without saying what it concretely does; not a 3 because more than 1–2 specific actions are explicitly listed.

4 / 5

Completeness

Explicitly answers both what ("Monitors context window health… Uses bounded external anchors, one cold-context review…, and a clean handoff on real drift") and when ("during large, long-running, multi-session, or explicitly context-sensitive work"), with concrete trigger phrases plus an explicit anti-trigger ("Do not auto-activate merely because a medium task has an intent frame and plan"). Clearly matches the top anchor rather than the 'when could be more explicit' anchor at 4.

5 / 5

Trigger Term Quality

Includes natural terms users would plausibly say: "context window health", "long-running", "multi-session", "context-sensitive", "drift", "handoff". Not a 5 because common variations like "context degradation", "session handoff", or concrete trigger phrases users actually type are missing; not a 3 because coverage goes well beyond one or two generic keywords.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — context-quality/coherence monitoring — distinguishable from scope-drift or general session-management skills. Not a 5 because "context-sensitive work" and handoff/session language carry minor overlap risk with adjacent context-management skills; not a 3 because the triggers (context window health, drift, cold-context review) are specific enough to avoid broad collisions.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pskoett/pskoett-ai-skills

Path

skills/context-surfing/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.