Skip to main content
skill CX Codex

context-surfing — Claude Code skill: what it does, how to install

context-surfing monitors context coherence during extended coding sessions, saving state and performing clean handoffs before hallucinations ruin output.

no license 272 installs ★ 341 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a claude-code
Open on GitHub

What context-surfing does

The skill acts as an execution guard during long, multi-turn coding assignments. Instead of trusting internal model recall, it anchors checks to external project artifacts: user goals, instruction files, and explicit implementation plans. Execution halts before bad writes occur whenever hedging, contradictions, or invented facts surface.

When paired with intent-framed-agent, this tool specifically watches cognitive quality while the other prevents scope creep. If both trigger simultaneously, context exit takes precedence because degraded context makes scope validation unreliable.

It optionally queries Entire CLI via entire status to inspect persistent state across sessions. If Entire is missing, the tool degrades cleanly without errors, relying strictly on disk-based anchors and plan files.

What it helps with

  • catch context degradation during large multi-session refactoring jobs
  • generate clean state handoffs before session close-out occurs
  • block writes and commits when hallucinated details appear
  • leverage Entire CLI session records without breaking when tools are missing

Example prompts for the agent

  • Monitor context health while refactoring the entire authentication layer
  • Activate context-surfing for this long-running migration task
  • Check context drift against our approved plan before committing files

How to install context-surfing

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/context-surfing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/context-surfing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about context-surfing

How to install context-surfing in Claude Code?

Run npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a claude-code in your terminal. This configures the skill inside ~/.claude/skills/context-surfing/SKILL.md.

What is the difference between context-surfing and intent-framed-agent?

intent-framed-agent monitors scope boundaries to ensure the agent does not stray from the outcome. context-surfing monitors output fidelity to ensure reasoning has not broken down.

Is Entire CLI mandatory for this skill?

No. The integration is entirely optional; without Entire CLI, the agent uses project instructions and local plan files as its ground truth anchor.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set10

The whole set →
self-improvement-ci self-improvement-ci — a CI-only skill that groups recurring pull request check failures and proposes rules so the same breakage stops coming back. CX Codex +1 550installs simplify-and-harden simplify-and-harden is a Claude Code skill that reviews code after a task is complete: it simplifies and hardens the code, re-verifies changes and briefly documents non-obvious decisions while the agent remembers their intent. CX Codex +1 543installs plan-interview plan-interview — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and other agents: runs a structured requirements interview across four domains before the agent reads any code. CX Codex +1 491installs intent-framed-agent The intent-framed-agent skill writes down what a coding session is supposed to achieve before edits start, then watches for work that wanders off. Handy on long refactors and feature builds. CX Codex +1 440installs simplify-and-harden-ci simplify-and-harden-ci — a skill that reviews pull requests inside CI: it scans changed files, posts findings, and can stop a merge. CX Codex +1 393installs skill-pipeline skill-pipeline sizes up a coding task, then decides which skills to switch on: nothing extra for a typo, planning plus checks and failure recovery for a big refactor. CX Codex +1 114installs self-healing self-healing — a skill for Claude Code and Codex helps an agent diagnose failures during a task and test its fix. It activates after a command, test, build, or lint run fails. CX Codex +1 109installs pskoett-ai-skills pskoett-ai-skills is a Claude Code plugin that adds checks to an agent's workflow: plan agreement, context control, code audits and saved lessons. ★ 341repo stars

Project sponsors

Companies that keep this analytics open