kco-pack

Files (1)

• SKILL.md

SKILL.md (first lines)

# Smart Context Pack

When the user runs `/kco-pack` or asks "what files do I need for X", build a curated, token-budget-aware list of files to load instead of guessing or reading the whole repo.

## How to use

```bash
node ${KIMI_SKILL_DIR}/../../src/smart-pack.js "the task description"
```

Or for the current git state without a description:
```bash
node ${KIMI_SKILL_DIR}/../../src/smart-pack.js
```

Or to feed it back into automation as JSON:
```bash
node ${KIMI_SKILL_DIR}/../../src/smart-pack.js --json "..."
```

## How it ranks files

Priority order:
1. **Mentioned in prompt** — explicit file paths or recognisable names → relevance 100
2. **Modified in git working tree** → 85
3. **Historically useful** in this project (high confidence, edited often) → up to 70
4. **Keyword match** against the task → up to 70

For each file the pack also suggests `offset` / `limit` — pointing at the structurally relevant section based on file landmarks (function/class declarations near task keywords).

## Token budget awareness

Pack stops adding files once it would exceed 25% of the user's effective context budget. The budget respects the active model's context window from `~/.kimi-code/config.toml` (e.g. the full 1M window on k3).

## Presentation

After running, present the list to the user and offer to:
- Read the top N files with the suggested offset/limit
- Save the set as a template (`/kco-templates create <name>`)
- Drop low-relevance items if they want a tighter pack

From egorfedorov/kimi-context-optimizer, MIT.

More from egorfedorov/kimi-context-optimizer