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
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/context-surfing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/context-surfing/
1Skills CLI (Vercel)
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a codex2Manually: put the files in place
.agents/skills/context-surfing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a cursor2Manually: put the files in place
.cursor/skills/context-surfing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pskoett/pskoett-ai-skills skills/context-surfing2Manually: put the files in place
.github/skills/context-surfing/SKILL.md1Skills CLI (Vercel)
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a gemini-cli2Platform CLI
gemini skills install https://github.com/pskoett/pskoett-ai-skills --path skills/context-surfingManually: put the files in place
.devin/skills/context-surfing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pskoett/pskoett-ai-skills --skill context-surfing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.