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.

66

Quality

83%

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

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.

An instruction-dense, highly actionable skill body with exemplary workflow sequencing and validation gates, but it pays for that with significant verbosity — metaphor framing, duplicated protocol summaries, and repeated pipeline tables — and keeps clearly separable material (handoff template, hook setup, interop details) inlined in a ~420-line file instead of reference files.

Suggestions

Cut the 'Mental Model' wave-metaphor section, the 'No wipeouts. No zombie sessions.' taglines, and the 'Riding the Wave' re-summary of the pre-commit check (it duplicates 'The Monitoring Paradox' verbatim-protocol content) — this alone removes roughly a quarter of the body's tokens without losing any actionable guidance.

Move the handoff file template, 'Hook Integration' setup, and 'Interoperability with Other Skills' into reference files (e.g. references/handoff-template.md, references/hooks.md), keeping SKILL.md a lean overview with one-level-deep, clearly signaled references.

Compress or remove the 'Handoffs become learning signals' digression — it describes downstream tooling behavior rather than instructing the executing agent, and its bullet points ('Which drift signals most commonly trigger handoffs → …') add no action for the current session.

DimensionReasoningScore

Conciseness

Noticeably verbose across several padded sections: the 'Mental Model' ocean-wave metaphor ('Paddling in', 'The shoulder', 'The close-out', 'Wipe-out territory'), tagline prose ('No wipeouts. No zombie sessions.'), the pre-commit anchor check explained in full under 'The Monitoring Paradox' and then re-summarized in 'Riding the Wave', and the pipeline/task-type table duplicated in both 'When to Use the Full Pipeline' and 'Pipeline position'. The 'Handoffs become learning signals' digression adds further padding. Not 'mostly efficient' (anchor 3) — roughly a third of the file could be cut without losing actionable content.

2 / 5

Actionability

Fully executable throughout: copy-paste install commands ('gh skill install pskoett/pskoett-skills context-surfing'), 'entire status 2>/dev/null' detection, a complete handoff file template with named sections, hook JSON for .claude/settings.json with concrete path variants, Codex hook config, the fallback 'ls .context-surfing/handoff-*.md' command, the 'touch <handoff-path>.consumed' marker, and a scripted escalation message. Even the judgment-based drift signals are given as concrete, checkable examples ('it depends', 'could be', 'might want to consider').

5 / 5

Workflow Clarity

Every multi-step process is explicitly sequenced with validation checkpoints and feedback loops: Activation (numbered anchor-loading list), Recovery Protocol (Steps 1–2 with branch outcomes, 'at most one local re-anchor and one cold-context check' limits), Exit Protocol (Steps 1–3), next-session procedure (numbered 1–6), and Session Close. The pre-commit anchor check ('quote verbatim → state pending action → verify trace-back → on failure enter Recovery Protocol') is an explicit validation gate before side-effecting actions, and the cold-context subagent escalation path is a genuine error-recovery loop.

5 / 5

Progressive Disclosure

In-file structure is good — clear section headers, and the one bundle reference (scripts/handoff-checker.sh) is real, correctly pathed, and clearly signaled. But ~420 lines are monolithic: the handoff file template, Hook Integration setup, and Interoperability sections are clearly separable reference-file material, and no references/ directory is used at all. Anchor 3 ('content that should be separate is inline') fits better than anchor 4 given the length and the multiple separable chunks.

3 / 5

Total

15

/

20

Passed

Description

87%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 names concrete mechanisms, gives an explicit and qualified activation condition, and includes an unusually good anti-trigger clause that disambiguates it from sibling pipeline skills. Its only weakness is trigger-term naturalness — several jargon phrases users would not actually say, and a few common synonyms are missing.

DimensionReasoningScore

Specificity

Lists several specific actions/mechanisms — 'Monitors context window health', 'Uses bounded external anchors', 'one cold-context review when self-recovery is uncertain', 'a clean handoff on real drift'. Not 5: phrases like 'bounded external anchors' describe mechanisms abstractly and coverage has minor gaps (no mention of the pre-commit anchor check, the skill's primary gate).

4 / 5

Completeness

Clearly answers both questions: the 'what' is explicit (monitor context window health via external anchors, cold-context review, clean handoff) and the 'when' is explicit and qualified ('during large, long-running, multi-session, or explicitly context-sensitive work') — plus an explicit anti-trigger ('Do not auto-activate merely because a medium task has an intent frame and plan'). Anchor 4's 'when could be more explicit or specific' does not fit: the when is stated outright with multiple concrete qualifiers.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'context window', 'large, long-running, multi-session', 'drift', 'handoff'. Not 5: jargon-heavy phrases ('bounded external anchors', 'cold-context review') are not things users would say, and common synonyms a user might actually use ('context pressure', 'session degradation', 'long task', 'compact/compaction') are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche — context-quality drift (hallucination, contradiction, coherence loss) — explicitly separated from adjacent lifecycle skills, and the closing anti-trigger clause ('Do not auto-activate merely because a medium task has an intent frame and plan') actively prevents misfires on the intent-framed-agent/plan-interview skills it most overlaps with.

5 / 5

Total

18

/

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.