Agent skill

Context Surfing

by pskoett in pskoett/pskoett-ai-skills

Monitors context window health during large, long-running, multi-session, or explicitly context-sensitive work.

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/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
~5.8k tokens
SKILL.md length
2,918 words
Files
2 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

Monitors context window health during large, long-running, multi-session, or explicitly context-sensitive work.

  • Works in 2 steps: Pause and re-read → Reconcile
  • Tasks that involve Context engineering
  • SKILL.md covers Install, Mental Model, Lifecycle Position and Activation, plus 7 more sections
  • Runs Shell scripts from its folder; calls gh and npx

What it does

Context Surfing is an agent skill from pskoett/pskoett-ai-skills. 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.

Its SKILL.md is about 5.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/handoff-checker.sh`).

It sits in Agent Workflows, covering Context engineering.

When your agent uses it

  • Tasks that involve Context engineering

Example prompts

  • “Use the context-surfing skill to monitor context window health during large, long-running, multi-session, or explicitly context-sensitive work”
  • “/context-surfing”

Requirements

  • Node.js
  • A Bash shell

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • 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 5.8k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 2,918 words of instructions outside code blocks.

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

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); the scripts in this folder 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,918 words (~5,825 tokens).

“Fallback using the Agent Skills CLI:”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in skills/context-surfing of pskoett/pskoett-ai-skills.

  • SKILL.md
  • scripts/handoff-checker.sh

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—~5.8kAutomated safety check: PassNone
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Picoclaw Skill Creatorsipeed/picoclaw30k—~4.4kAutomated safety check: PassMIT
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.8k—~938Automated safety check: PassApache-2.0
Context Mode for Antigravity CLImksglu/context-mode26k—~850Automated safety check: PassCustom licence

Similar skills

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check: notes
  • Picoclaw Skill Creator

    sipeed/picoclaw

    Guidance for creating, updating and reviewing Picoclaw skills, from the SKILL.md structure to organizing bundled scripts, references and assets.

    30k GitHub stars~4.4k tokensUpdated 15 days ago
    Agent WorkflowsAuto-check passed
  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.8k GitHub stars~938 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Routing rules for using context-mode MCP tools in Antigravity CLI: sandboxed code runs, file analysis, indexed search and web fetches that keep large output out of the conversation.

    26k GitHub stars~850 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Token Optimizer

    alexgreensh/token-optimizer

    Audit a Claude Code or Codex setup for context-window waste, then fix it and measure the savings.

    2.5k GitHub stars~3.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

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 during large, long-running, multi-session, or explicitly context-sensitive work. Context Surfing is an agent skill from pskoett/pskoett-ai-skills. Monitors context window health during large, long-running, multi-session, or explicitly context-sensitive work.

When should I use Context Surfing?

Context Surfing fits situations like: tasks that involve Context engineering.

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 (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 (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 a shell for the scripts in its folder and the command-line tools its instructions call (gh and npx). Our summary lists: Node.js; A Bash shell.

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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

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 5.8k tokens (SKILL.md is roughly 23k 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: Context Mode Output Sandbox (mksglu/context-mode, 26k stars), Memori Long-Term Memory (MemoriLabs/Memori, 17k stars), Picoclaw Skill Creator (sipeed/picoclaw, 30k stars) and ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.8k 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.