# Context Window Pruner

> Optimize information density by filtering workspace files based on relevance to the current task. Excludes high-noise files (lockfiles, assets) and prioritizes source code matching semantic queries. Use when this capability is needed.

- Skill: `tomevault-io/context-window-pruner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/context-window-pruner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/context-window-pruner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/context-window-pruner

---


# SKILL-008: Context Window Pruner

## Overview

Large repos flood the agent's context window with noise. This skill generates a `RELEVANT_FILES.txt` list by aggressively pruning irrelevant directories and searching for files related to a specific "Focus".

## Trigger Phrases

- `focus on <topic>`
- `find relevant files for <task>`
- `prune context`

## Inputs

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `--focus` | string | Yes | - | Keywords to filter file names/content (e.g. "gas", "auth") |
| `--max-files` | int | No | 50 | Limit output size |

## Outputs

1. `RELEVANT_FILES.txt`: List of absolute paths to read.
2. Console output summarizing token savings (estimated).

## Safety Checks

- Always respects `.gitignore`.
- Never includes binary files.
- Caps output to avoid context overflow.

## Implementation

See `prune_context.ps1`.

## Integration

```powershell
$files = .\skills\08_context_pruner\prune_context.ps1 -Focus "EVM opcode"
# Agent works only with $files
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/sounder25) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->