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

74%

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

Fix and improve this skill with Tessl

tessl review fix ./plugin/skills/context-surfing/SKILL.md

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 unusually rigorous process skill: drift signals, recovery limits, exit protocol, and handoff template are concrete and fully sequenced with explicit validation gates. Its weaknesses are length — metaphor and interop material inflate the always-loaded body — and no use of separate reference files despite clearly splittable content.

Suggestions

Cut the Mental Model metaphor and Principles sections to a couple of lines each; they are motivational padding in an always-loaded file.

Move the intent-framed-agent relationship/cadence rules, pipeline interop tables, and Entire CLI integration details into a references/ file, keeping a one-line pointer plus the precedence rule in SKILL.md.

Supply the cold-context reviewer brief as a copy-paste-ready prompt template instead of a description of what it should contain, matching the quality of the handoff and notification templates.

DimensionReasoningScore

Conciseness

The operational core (drift signal lists, recovery protocol, exit protocol, handoff template) is concrete and earns its tokens, but the extended surfing metaphor ("Paddling in", "The peak", "The shoulder", "The close-out"), the motivational Principles section ("Ride the peak, not the whole ocean"), and repeated anchor listings (in Activation, the Full/Partial/Standalone bullets, and Project Context Files) are trimmable padding across ~420 lines. It fits anchor 3 — mostly efficient with some unnecessary explanation that could be tightened — rather than anchor 2 because the bulk is specific non-obvious guidance, not generic concepts Claude already knows.

3 / 5

Actionability

The body provides executable, copy-paste-ready artifacts: the `entire status 2>/dev/null` detection command, a complete handoff file template with exact naming pattern, the exact hooks JSON for `.claude/settings.json`, a verbatim user-notification message, and the `ls .context-surfing/handoff-*.md` fallback check. It falls short of anchor 5 because the cold-context reviewer brief in Recovery Protocol Step 2 is described rather than supplied as ready-to-send text, and directives like "maintain a running status in your output" lack a concrete format.

4 / 5

Workflow Clarity

The lifecycle is explicitly sequenced (activation → riding with pre-commit anchor checks → drift detection → recovery protocol → exit protocol → handoff/next session → close) with genuine validation checkpoints and feedback loops: the pre-commit anchor check gates every side-effecting action, re-anchor limits cap recovery attempts ("at most one local re-anchor and one cold-context check"), escalation paths branch on reviewer verdicts, and the handoff-consumed marker is set "only after re-entry succeeds". The handoff template doubles as a checklist, matching anchor 5's clear sequence, explicit validation steps, and error-recovery loops.

5 / 5

Progressive Disclosure

Section headers are clear and the one bundle file (`scripts/handoff-checker.sh`) is referenced correctly with a real path, but the ~420-line body inlines substantial material that could live in separate reference files — the cross-skill relationship/cadence rules, the pipeline interop tables, and detailed Entire CLI integration notes — with no use of a references/ directory at all. This fits anchor 3 (some structure, but content that should be separate is inline) rather than anchor 4's appropriately-placed split.

3 / 5

Total

15

/

20

Passed

Description

67%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 solid third-person description that states concrete capabilities, explicit activation conditions, and a valuable anti-trigger guard. Its main weakness is trigger phrasing written from the skill's perspective rather than in natural user-utterance form, which limits trigger-term quality.

Suggestions

Add natural trigger phrases in a 'Use when...' style, e.g. 'Use when the user mentions context degradation, context pressure, compaction, or asks for a session handoff' to broaden trigger-term coverage with synonyms users actually say.

Define the size threshold concretely (e.g. what counts as 'large' or 'long-running' — multi-hour tasks, whole-file refactors, multi-session work) so the 'when' clause is unambiguous.

Replace the jargon phrase 'bounded external anchors' with a plainer concrete action (e.g. 're-reads the intent frame, plan file, and session log before committing changes').

DimensionReasoningScore

Specificity

The description lists several distinct concrete actions — "Monitors context window health", "Uses bounded external anchors", "one cold-context review when self-recovery is uncertain", and "a clean handoff on real drift" — covering the skill's core behaviors with only minor gaps. It falls short of anchor 5 because "bounded external anchors" is jargon rather than a fully concrete action, and it exceeds anchor 3 since it names more than 1-2 actions.

4 / 5

Completeness

Both 'what' (monitor context health via bounded anchors, cold-context review, clean handoff) and 'when' ("during large, long-running, multi-session, or explicitly context-sensitive work") are explicitly present, reinforced by an anti-trigger ("Do not auto-activate merely because a medium task has an intent frame and plan"). It is not a 5 because the 'when' lacks concrete user-said trigger phrases and terms like "large" are undefined; it exceeds anchor 3 because 'when' is explicit, not merely weakly implied.

4 / 5

Trigger Term Quality

It includes some relevant keywords a user might naturally say — "long-running", "multi-session", "context window", "drift", "handoff" — but misses common variations and synonyms such as "context degradation", "context pressure", "compaction", or "session handoff". The trigger framing is skill-centric rather than user-utterance-centric, fitting anchor 3 rather than anchor 4's good keyword coverage.

3 / 5

Distinctiveness Conflict Risk

The context-quality-drift niche — monitoring the agent's own coherence and handing off on real drift — is mostly distinct from scope-monitoring or session-resumption skills, and the explicit anti-trigger actively reduces overlap with intent-framed-agent. Minor overlap risk remains with session-state/handoff-type skills, so it fits anchor 4 rather than the clear minimal-conflict niche of anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

pskoett/pskoett-ai-skills

Path

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