# Context Optimizer

Optimize token usage and context management.

- Repository: https://github.com/rohitg00/pro-workflow (2940 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-09-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rohitg00/pro-workflow --skill context-optimizer -g -a claude-code -y`
Codex: `npx skills add rohitg00/pro-workflow --skill context-optimizer -g -a codex -y`
Cursor: `npx skills add rohitg00/pro-workflow --skill context-optimizer -g -a cursor -y`
Gemini CLI: `npx skills add rohitg00/pro-workflow --skill context-optimizer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rohitg00/pro-workflow`

## Description

Optimize token usage and context management. Use when sessions feel slow, context is degraded, or you're running out of budget.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Context Optimizer

Manage your context window and token budget effectively.

## Quick Diagnosis

1. Run `/context` to check current usage
2. If > 70% → compact now before it degrades
3. If > 90% → you're in the "dumb zone", compact immediately

## Optimization Strategies

### Immediate

| Action | Saves | When |
|--------|-------|------|
| `/compact` | 30-50% context | At task boundaries |
| Disable unused MCPs | ~5% per MCP | When switching domains |
| Use subagents for exploration | Keeps main context clean | Heavy search/read tasks |
| Fresh session via `/resume` | 100% reset | When starting unrelated work |

### Configuration

Set proactive auto-compaction:
```json
{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}
```

### MCP Audit

Keep <10 MCPs enabled, <80 tools total. Each MCP adds overhead to every request.

```bash
/mcp          # List active servers
# Disable what you're not using
```

### Prompt Engineering for Token Efficiency

- Scope your prompts: "In src/auth/, fix the login bug"
- Provide constraints: "Don't modify the middleware"
- Give acceptance criteria: "Should return 429 after 5 attempts"
- Avoid vague prompts: "Fix the code" (forces Claude to read everything)

### Subagent Delegation

Heavy operations that generate lots of output should go to subagents:

- Test suite output → subagent
- Large file exploration → subagent
- Documentation generation → subagent
- Log analysis → subagent

The main session stays clean while subagents handle the volume.

## Context Budget Planning

| Phase | Target Usage | Action If Over |
|-------|-------------|----------------|
| Planning | < 20% | Keep plans concise |
| Implementation | < 60% | Compact between files |
| Testing | < 80% | Delegate to subagent |
| Review | < 90% | Start fresh session |

## Token Efficiency

The rest: https://github.com/rohitg00/pro-workflow/blob/HEAD/skills/context-optimizer/SKILL.md