Agent skill

Context Surfing

by pskoett in pskoett/pskoett-ai-skills

Monitors context window health throughout a session and rides peak context quality for maximum output fidelity.

No licenceAuto-check passedAgent Workflows

Install Context Surfing

skills CLI
$ npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pskoett/pskoett-ai-skills context-surfing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/context-surfing .claude/skills/context-surfing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
context-surfing
GitHub stars
314
Token cost
~4.7k tokens
SKILL.md length
2,294 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

Monitors context window health throughout a session and rides peak context quality for maximum output fidelity.

  • Works in 2 steps: Pause and re-read → Reconcile
  • A multi-step agent task is underway and session continuity
  • SKILL.md covers Install, Mental Model, Lifecycle Position and Activation, plus 8 more sections
  • Calls npx

What it does

Context Surfing is an agent skill from pskoett/pskoett-ai-skills. Monitors context window health throughout a session and rides peak context quality for maximum output fidelity. Activates automatically after plan-interview and intent-framed-agent. Stays active through execution and hands off cleanly to simplify-and-harden and self-improvement when the wave completes naturally or exits via handoff. Use this skill whenever a multi-step agent task is underway and session continuity or context drift is a concern. Especially important for long-running tasks, complex refactors, or…

Its SKILL.md is about 4.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Context engineering and Refactoring.

When your agent uses it

  • A multi-step agent task is underway and session continuity
  • Context drift is a concern
  • Even if the user doesnt say context surfing — if an agent task is running across multiple steps with intent and a plan already established
  • This skill is live

Example prompts

  • “t say”
  • “Use the context-surfing skill to monitor context window health throughout a session and rides peak context quality for maximum output fidelity”
  • “/context-surfing”

Requirements

  • Node.js

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Pause and re-read
  2. Reconcile

What it can do on your machine

Read from SKILL.md and the folder at commit 5a836dc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Context Surfing loads about 4.7k tokens when it runs. Until then it costs about 192 tokens; SKILL.md has 2,294 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~192
When it runs · the whole SKILL.md, loaded when a task matches
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,294 words (~4,725 tokens).

“The agent rides the wave of peak context. When the wave crests, it commits. When it detects drift, it pulls out cleanly — saving state, handing off, and letting the next session catch the next wave.”

— opening of SKILL.md by pskoett
name
context-surfing

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/context-surfing of pskoett/pskoett-ai-skills.

Open the folder on GitHubat commit 5a836dc

Compare with similar skills

Context Surfing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Context Surfing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Context Surfing this skillpskoett/pskoett-ai-skills314—~4.7kAutomated safety check: PassNone
Skillpper Saverkipperacademy/skillpper144—~1.6kAutomated safety check: PassNone
Swarmcj-vana/claude-swarm117—~11kAutomated safety check: WarnMIT
Project Structure Mapsteipete/agent-scripts7.3k—~1.9kAutomated safety check: PassMIT
Skill Progressive Disclosure Designsamber/cc-skills228—~4.3kAutomated safety check: PassMIT
Agents Best PracticesDenisSergeevitch/agents-best-practices2.4k—~7.4kAutomated safety check: PassMIT

Similar skills

  • Skillpper Saver

    kipperacademy/skillpper

    Aggressive token, context, and cost optimization mode for AI coding agents (Claude Code, Antigravity, Cursor, etc.).

    144 GitHub stars~1.6k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Swarm

    cj-vana/claude-swarm

    Orchestrate parallel Claude Code worker swarms with protocol-based behavioral governance.

    117 GitHub stars~11k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check: warnings
  • Project Structure Map

    steipete/agent-scripts

    Compresses a TypeScript or Swift repository into one symbol-map text file sized for an LLM context window, for refactor planning and architecture recon.

    7.3k GitHub stars~1.9k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Decide how to split skill content between SKILL.md and reference files for context efficiency and reliable triggering.

    228 GitHub stars~4.3k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Agents Best Practices

    DenisSergeevitch/agents-best-practices

    A skill your agent uses when designing, generating an MVP blueprint for, auditing, troubleshooting, refactoring, or explaining an agentic harness for any domain.

    2.4k GitHub stars~7.4k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Ripwire Code Navigation

    redhat-et/ripwire

    Answers questions about a named symbol, such as its callers, what it calls, the path between two symbols or the downstream impact of changing it, using the ripwire CLI.

    2.4k GitHub stars~4.8k tokensUpdated today
    DevelopmentAuto-check: notes

More from pskoett/pskoett-ai-skills

All 24 skills in this repo
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    314 GitHub stars~5k tokensUpdated 4 days ago
    Auto-check passed
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    314 GitHub stars~5.4k tokensUpdated 4 days ago
    Auto-check passed
  • Self Healing

    pskoett/pskoett-ai-skills

    Active runtime recovery for coding agents: when something breaks mid-task, diagnose the root cause, write a fix, VERIFY by re-running the broken thing, then file a HEAL- entry to .learnings/HEALS.md…

    314 GitHub stars~5.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Skill Tester

    pskoett/pskoett-ai-skills

    Validates all interactive skills in this repo against the Agent Skills spec, project conventions, and structural requirements.

    314 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed
  • Skill Tester CI

    pskoett/pskoett-ai-skills

    Validates all CI skills in this repo. An agent skill from pskoett/pskoett-ai-skills.

    314 GitHub stars~845 tokensUpdated 4 days ago
    Auto-check passed
  • Context Decay

    pskoett/pskoett-ai-skills

    Revalidate persistent agent knowledge by classifying why it can become stale and how quickly it changes, then retain, revise, externalize, or retire it.

    314 GitHub stars~3.3k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Context Surfing

What does Context Surfing do?

Monitors context window health throughout a session and rides peak context quality for maximum output fidelity. Context Surfing is an agent skill from pskoett/pskoett-ai-skills. Monitors context window health throughout a session and rides peak context quality for maximum output fidelity.

When should I use Context Surfing?

Context Surfing fits situations like: A multi-step agent task is underway and session continuity; context drift is a concern; even if the user doesnt say context surfing — if an agent task is running across multiple steps with intent and a plan already established; this skill is live.

How do I install Context Surfing in Claude Code?

Run `npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a claude-code`. Or copy the skill folder (.agents/skills/context-surfing in pskoett/pskoett-ai-skills) into .claude/skills/context-surfing in your project. Claude Code loads it when a task matches its description.

How do I install Context Surfing in Codex?

Run `npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a codex`. Or copy the skill folder (.agents/skills/context-surfing in pskoett/pskoett-ai-skills) into .agents/skills/context-surfing in your project. Codex loads it when a task matches its description.

Can I use Context Surfing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/context-surfing, .gemini/skills/context-surfing, .github/skills/context-surfing and .opencode/skills/context-surfing in your project.

What does Context Surfing need to run?

Going by SKILL.md and its folder, Context Surfing needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Context Surfing access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Context Surfing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Context Surfing use?

No licence was found for Context Surfing or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Context Surfing use?

About 4.7k tokens (SKILL.md is roughly 19k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Context Surfing?

Skills that share tags, products or a category with Context Surfing: Skillpper Saver (kipperacademy/skillpper, 144 stars), Swarm (cj-vana/claude-swarm, 117 stars), Project Structure Map (steipete/agent-scripts, 7.3k stars) and Skill Progressive Disclosure Design (samber/cc-skills, 228 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Context Surfing?

pskoett (a GitHub user) maintains it in pskoett/pskoett-ai-skills, which has 314 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 5, 2026.

Source: pskoett/pskoett-ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.