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.

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.

DimensionReasoningScore

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

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 well-crafted description in third-person voice that explicitly states what the skill does, when it applies, and — unusually — when not to apply it. Trigger terms are domain-appropriate and the niche is distinct; the main gaps are the jargon-heavy "bounded external anchors" phrasing and the absence of concrete user-mention trigger phrases.

Suggestions

Replace or gloss the jargon phrase "bounded external anchors" with a user-recognizable action (e.g., "re-reads the plan/intent files before side-effecting actions") to sharpen specificity.

Add a concrete "Use when the user mentions..." trigger clause (e.g., "context drift", "session handoff", "long task") to lift completeness and trigger-term quality to the top anchor.

DimensionReasoningScore

Specificity

"Monitors context window health", "one cold-context review when self-recovery is uncertain", and "a clean handoff on real drift" list several concrete actions with only minor gaps — "bounded external anchors" is jargon rather than a user-recognizable concrete action, which keeps it below the comprehensive-coverage anchor (5).

4 / 5

Completeness

Both parts are explicit: the what ("Monitors context window health... Uses bounded external anchors, one cold-context review... and a clean handoff") and the when ("during large, long-running, multi-session, or explicitly context-sensitive work") plus a negative trigger. Not anchor 5 because the when-clause uses task-size categories rather than concrete user-mention trigger phrases like "when the user mentions drift or session handoffs".

4 / 5

Trigger Term Quality

"large", "long-running", "multi-session", "explicitly context-sensitive", and "context window" are phrases a user with this need would plausibly say, giving good keyword coverage. A few natural variations (e.g., "context is degrading", "session handoff", "long task") are missing, so it falls between anchors 3 and 4, noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

"Monitors context window health during large, long-running, multi-session, or explicitly context-sensitive work" carves a clear niche, and "Do not auto-activate merely because a medium task has an intent frame and plan" actively reduces false triggers. Minor overlap risk remains with closely related scope-drift/session-management skills that the description does not disambiguate, so it is not anchor 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

agent-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.