cost-compact-context — скилл для Claude Code: сжатие контекста
Скилл оборачивает getTokenOptimizer().getCompactContext() для анализа затрат на токены. Извлекает сжатый контекст из ReasoningBank, показывает, сколько токенов удалось сэкономить, и выясняет, доступен ли agent-booster.
npx skills add ruvnet/ruflo --skill cost-compact-context -a claude-codeЧто делает cost-compact-context
Скилл берёт ваш запрос и вызывает оптимизатор токенов из @claude-flow/integration. Если пакет agentic-flow установлен, вы получите таблицу с числом найденных воспоминаний, сэкономленными токенами (по данным моста), доступностью agent-booster и попаданиями в кэш. Если пакета нет, скилл выходит без ошибки и сообщает, что bridge недоступен.
Скрипт запускается как Node one-liner из папки v3/, чтобы @claude-flow/integration разрешился правильно. Импортирует канонический экспорт token-optimizer (не dist/token-optimizer.js), вызывает getCompactContext(query) и выводит markdown с JSON-строкой через COMPACT_QUIET=1.
Отчёт о сэкономленных токенах — это эвристика (query_tokens минус compact_prompt_tokens), а не измерение против baseline без RAG. Скилл передаёт эту оговорку вперёд: цифры отражают то, что считает bridge, но не проверены независимо.
Какие задачи решает
- узнать, сколько токенов сэкономит сжатие контекста для запроса
- получить список памятей, которые извлечёт оптимизатор
- проверить, доступен ли agent-booster для вашей конфигурации
- отследить попадания в кэш при повторных запросах
Примеры запросов агенту
- Что сэкономит оптимизатор для запроса про интеграцию claude-flow?
- Покажи сжатый контекст и статистику токенов для анализа RAG
- Проверь доступность agent-booster и найди кэшированные памяти
Как установить cost-compact-context
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-compact-context -a claude-code2Вручную: положить файлы
~/.claude/skills/cost-compact-context/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cost-compact-context/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-compact-context -a codex2Вручную: положить файлы
.agents/skills/cost-compact-context/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-compact-context -a cursor2Вручную: положить файлы
.cursor/skills/cost-compact-context/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ruvnet/ruflo cost-compact-context2Вручную: положить файлы
.github/skills/cost-compact-context/SKILL.md1Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-compact-context -a gemini-cli2Командой платформы
gemini skills install https://github.com/ruvnet/ruflo --path plugins/ruflo-cost-tracker/skills/cost-compact-contextВручную: положить файлы
.devin/skills/cost-compact-context/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ruvnet/ruflo --skill cost-compact-context -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора104
Весь набор →Похожие
Вопросы о cost-compact-context
Как установить cost-compact-context в Claude Code?
Выполните npx skills add ruvnet/ruflo --skill cost-compact-context -a claude-code. После установки скилл будет доступен по пути ~/.claude/skills/cost-compact-context/SKILL.md.
Что делает cost-compact-context?
Скилл вызывает оптимизатор токенов из @claude-flow/integration, сжимает контекст для вашего запроса и показывает, сколько токенов удалось сэкономить, какие памяти были извлечены и доступен ли agent-booster.
Что будет, если agentic-flow не установлена?
Скилл выведет сообщение, что bridge недоступен, вернёт нулевые сбережения (tokensSaved: 0) и завершится без ошибки.
Исходный текст
SKILL.md · MIT
---
name: cost-compact-context
description: Wrap getTokenOptimizer().getCompactContext() to retrieve compacted ReasoningBank context for cost-analysis queries; report bridge-reported tokensSaved
argument-hint: "<query>"
allowed-tools: Bash
---
# Cost Compact Context
Wraps `getTokenOptimizer().getCompactContext()` from `@claude-flow/integration` for cost-analysis queries. The bridge dynamically imports `agentic-flow` with graceful fallback: when the package isn't installed, `tokensSaved` is `0` and the skill exits cleanly. No MCP tool wraps `getTokenOptimizer` today (ADR-0002 §"Riskiest assumption"); we shell a Node one-liner instead.
## Steps
1. **Take the query** — the single argument.
2. **Invoke** — run from anywhere under `v3/` so `@claude-flow/integration` resolves:
```bash
( cd v3 && node ../plugins/ruflo-cost-tracker/scripts/compact.mjs "<QUERY>" )
```
The script imports `@claude-flow/integration/token-optimizer` (canonical export — **not** `dist/token-optimizer.js`, which would double the `.js` extension via Node's `./*` exports rule), calls `getCompactContext(query)`, and prints a markdown summary plus a JSON line via `COMPACT_QUIET=1`.
3. **Report** — markdown table with: memories retrieved, tokens saved (bridge-reported), agentic-flow availability, cache hit rate. The script also emits a "bridge-reported, not measured against a no-RAG baseline" disclaimer. On bridge-unavailable: prints "agentic-flow not installed — bridge returns inert results." and exits cleanly.
## Caveats — claimed upstream, not yet verified
CLAUDE.md root claims `ReasoningBank retrieval: -32%` tokens. The bridge's `tokensSaved` is `query_tokens − compact_prompt_tokens` (token-optimizer.ts:141–143) — a heuristic, **not** a baseline-measured saving. token-optimizer.ts:9–10 itself says: *"No fabricated metrics are reported — all stats reflect real measurements"*. This skill carries that disclaimer forward.
Booster-specific availability is **not** exposed as a getter — observable only through `optimizedEdit()` returning `method: 'agent-booster'`. The canonical Tier 1 signal is `[AGENT_BOOSTER_AVAILABLE]` (see `cost-booster-route`).
## Fallback
`agentic-flow` not installed → `getCompactContext` returns `{tokensSaved: 0, memories: []}` (line 116–124), `optimizedEdit` returns `{method: 'traditional'}`, `getOptimalConfig` falls back to anti-drift defaults. Skill exits cleanly with the "not available" message.
## Cross-references
ADR-0002 Decision #2 + §"Riskiest assumption" · `token-optimizer.ts:308` (singleton export) · `docs/benchmarks/0002-baseline.md` (verification findings).
© ruvnet · MIT · ruvnet/ruflo
