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.

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

The canonical home for this skill is context-surfing in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

77%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.

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.

DimensionReasoningScore

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

Description

75%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 that clearly states what the skill does and when to use it, including a rare and useful negative activation boundary. The main gap is that trigger conditions are task-category terms rather than concrete phrases a user would naturally say, and one mechanism phrase ('bounded external anchors') stays vague.

Suggestions

Add an explicit 'Use when...' clause with user-sayable trigger phrases (e.g., 'Use when the context window is filling up, work spans multiple sessions, or the user asks for a handoff to a fresh session') alongside the task-category triggers.

Replace 'bounded external anchors' with the concrete artifacts involved (intent frame, plan file, session log) so the 'what' is fully concrete.

DimensionReasoningScore

Specificity

Names several concrete behaviors — 'Monitors context window health', 'Uses bounded external anchors', 'one cold-context review when self-recovery is uncertain', 'a clean handoff on real drift' — but 'bounded external anchors' leaves the mechanism vague and the monitoring outputs (drift signals, exit) are not enumerated. Fits anchor 4 (several specific actions, minor gaps) rather than 5, which requires comprehensive coverage.

4 / 5

Completeness

The 'what' is clear (monitor, anchor, cold-context review, clean handoff) and the 'when' is explicit — 'during large, long-running, multi-session, or explicitly context-sensitive work' — plus a negative boundary ('Do not auto-activate merely because a medium task has an intent frame and plan'), so the missing-'Use when' cap does not apply. Not 5 because the triggers are relative task categories rather than concrete user-sayable trigger phrases.

4 / 5

Trigger Term Quality

Contains natural terms users would plausibly say — 'context window', 'large', 'long-running', 'multi-session', 'context-sensitive', 'drift', 'handoff' — with good coverage overall. It misses common variations such as 'context is filling up', 'running out of context', or 'fresh session', so it sits between anchor 3 (missing variations) and anchor 4 (good coverage) → 4.

4 / 5

Distinctiveness Conflict Risk

Context-quality drift monitoring during execution is a distinct niche, made more so by the explicit anti-trigger for ordinary Medium tasks. Minor overlap risk remains with closely related sibling skills that also claim 'multi-session' work and 'handoff' territory (e.g., a session-context skill), matching anchor 4 rather than 5.

4 / 5

Total

16

/

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

.agents/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.