# Contextpilot

> Optimize document ordering in LLM context for better retrieval performance

- Skill: `efficientcontext/contextpilot` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add efficientcontext/contextpilot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/efficientcontext/contextpilot/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: EfficientContext (https://skillmd.com/u/efficientcontext)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/efficientcontext/contextpilot

---


# ContextPilot Integration

You have ContextPilot enabled as a transparent proxy. All your LLM API requests are automatically routed through ContextPilot, which reorders documents in your context window for optimal retrieval performance.

## What ContextPilot Does

When your request contains multiple documents (in system prompts or tool results), ContextPilot:

1. **Extracts** documents from XML tags (`<documents>`, `<files>`, etc.), numbered lists, separators, or markdown headers
2. **Clusters** documents by semantic similarity using hierarchical clustering
3. **Reorders** documents to minimize attention distance between related content
4. **Reconstructs** the request preserving the original format

## Supported Document Formats

- XML tags: `<documents><document>...</document></documents>`, `<files><file>...</file></files>`
- Numbered: `[1] doc [2] doc [3] doc`
- Separator: docs separated by `---` or `===`
- Markdown headers: sections split by `#` or `##` headers

## How to Verify

Check the `X-ContextPilot-Result` response header:

```
X-ContextPilot-Result: {"intercepted":true,"documents_reordered":true,"total_documents":5,"sources":{"system":1,"tool_results":1}}
```

## Configuration Headers

Send these headers with your API requests to control behavior:

| Header | Values | Default |
|--------|--------|---------|
| `X-ContextPilot-Enabled` | `true`/`false` | `true` |
| `X-ContextPilot-Mode` | `auto`/`xml_tag`/`numbered`/`separator`/`markdown_header` | `auto` |
| `X-ContextPilot-Scope` | `all`/`system`/`tool_results` | `all` |
| `X-ContextPilot-Alpha` | float | `0.001` |