loop-budget — скилл для Claude Code: что делает, установка
Скилл loop-budget проверяет бюджет токенов и расходы цикла до и после запуска. При перерасходе или пустом состоянии останавливает итерацию.
MIT ★ 11 819 обновлён 2026-10-29
/plugin marketplace add cobusgreyling/loop-engineering
/plugin install loop-engineering@loop-engineeringЧто делает loop-budget
Скилл работает в начале и конце каждой итерации. В начале он читает loop-budget.md, журнал loop-run-log.md за последние 24 часа и суммирует tokens_estimate для активного паттерна. При расходе от 80% дневного лимита включается режим только отчёта: субагенты не запускаются, автоисправления не выполняются. При достижении 100% или флаге loop-pause-all итерация завершается сразу.
Если расход достиг 90%, а в STATE.md остаются задачи с приоритетом High Priority, скилл передаёт управление budget-negotiator, если тот установлен. При отсутствии задач для действий он завершает запуск менее чем за 5k токенов. В конце в loop-run-log.md добавляется JSON с длительностью, найденными элементами, действиями, эскалациями, оценкой токенов и результатом. Для работы нужны loop-budget.md, STATE.md и loop-run-log.md.
Какие задачи решает
- проверить дневной лимит токенов перед итерацией
- остановить цикл при достижении бюджета
- не запускать субагентов без задач для действий
- переключить цикл в режим только отчёта
- записать расход и результат в журнал
Примеры запросов агенту
- Проверь бюджет и журнал перед запуском следующей итерации.
- Запусти цикл и остановись, если в
STATE.mdнет задач для действий. - После итерации добавь расход токенов и результат в
loop-run-log.md.
Как установить loop-budget
1Через маркетплейс плагинов
/plugin marketplace add cobusgreyling/loop-engineering/plugin install loop-engineering@loop-engineeringКоманда ставит плагин loop-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a claude-code3Вручную: положить файлы
~/.claude/skills/loop-budget/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/loop-budget/
1Через Skills CLI (Vercel)
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a codex2Вручную: положить файлы
.agents/skills/loop-budget/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a cursor2Вручную: положить файлы
.cursor/skills/loop-budget/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cobusgreyling/loop-engineering skills/loop-budget2Вручную: положить файлы
.github/skills/loop-budget/SKILL.md1Через Skills CLI (Vercel)
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a gemini-cli2Командой платформы
gemini skills install https://github.com/cobusgreyling/loop-engineering --path skills/loop-budgetВручную: положить файлы
.devin/skills/loop-budget/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о loop-budget
Как установить loop-budget в Claude Code?
Выполните /plugin marketplace add cobusgreyling/loop-engineering и затем /plugin install loop-engineering@loop-engineering.
Что делает loop-budget?
Он проверяет расход токенов в начале и конце итерации, ограничивает действия при приближении к дневному лимиту и записывает результат в loop-run-log.md.
Когда loop-budget завершает итерацию?
При достижении 100% бюджета, установленном loop-pause-all или отсутствии задач для действий. При расходе от 80% он отключает субагентов и автоисправления.
Исходный текст
SKILL.md · MIT
---
name: loop-budget
description: Check token budget and run-log spend before and after a loop run. Enforces early exit when over budget or when there is no actionable work.
---
# Loop Budget Guard
Run at the **start** and **end** of every loop iteration.
## Start of run
1. Read `loop-budget.md` for daily caps and kill-switch flags.
2. Read recent entries in `loop-run-log.md` (last 24h).
3. Sum `tokens_estimate` for the active pattern today.
4. If spend ≥ 80% of the pattern's daily cap → **report-only mode** (no sub-agents, no auto-fix).
5. If spend ≥ 90% and High Priority items remain in `STATE.md`, yield to the [budget-negotiator](../budget-negotiator/SKILL.md) skill (if installed). Otherwise, if spend ≥ 100% or `loop-pause-all` is set → **exit immediately** with a one-line note in STATE.md.
6. If watchlist/state has no actionable items → **exit in <5k tokens** (do not spawn sub-agents).
## End of run
Append one JSON object to `loop-run-log.md`:
```json
{
"run_id": "<ISO8601>",
"pattern": "<pattern-id>",
"duration_s": <number>,
"items_found": <number>,
"actions_taken": <number>,
"escalations": <number>,
"tokens_estimate": <number>,
"outcome": "no-op | report-only | fix-proposed | escalated"
}
```
## Rules
- Never exceed `max sub-agent spawns/run` from `loop-budget.md`.
- High-cadence patterns (CI Sweeper, PR Babysitter) **must** early-exit when nothing is actionable.
- On self-throttle, append a line to `loop-budget.md` under **Alerts This Period**.
© Cobus Greyling · MIT · cobusgreyling/loop-engineering