К основному содержанию
скилл CX Codex

loop-budget — скилл для Claude Code: что делает, установка

Скилл loop-budget проверяет бюджет токенов и расходы цикла до и после запуска. При перерасходе или пустом состоянии останавливает итерацию.

MIT ★ 11 819 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add cobusgreyling/loop-engineering
/plugin install loop-engineering@loop-engineering
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/loop-budget/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/loop-budget/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
token-budget-advisor affaan-m Скилл token-budget-advisor для Claude Code предлагает выбрать глубину ответа и оценивает объём токенов до генерации. Помогает заранее задать длину ответа. CX Codex +1 6 500установок token-budget-gate chrono-meta Скилл token-budget-gate считает примерную стоимость многошаговой задачи в токенах и выдаёт вердикт GREEN, YELLOW, ORANGE или RED до того, как агент начнёт тратить бюджет. CX Codex +1 ★ 33звёзд репо context-engine borghei Скилл context-engine для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который управляет тем, что попадает в контекстное окно агента, что хранится в памяти между сессиями и что подтягивается по запросу. CX Codex +1 112установок om-auto-continue-pr-loop open-mercato Скилл om-auto-continue-pr-loop для Claude Code продолжает незавершённый PR, запущенный через om-auto-create-pr-loop. Он находит следующий незавершённый шаг в плане и доводит работу до финальной проверки. CX Codex +1 4 600установок loop-library Forward-Future Скилл loop-library для Claude Code — устаревший алиас Loopy: находит повторяющиеся задачи и подбирает или проектирует циклы с точками выхода. CX Codex +1 2 400установок loop Alireza Rezvani Скилл loop для Claude Code, который запускает автономный цикл экспериментов autoresearch по расписанию. Задаётся интервал от 10 минут до месяца, дальше агент сам читает конфиг, правит код, коммитит и оценивает результат. CX Codex +1 1 557установок

Из того же набора29

Весь набор →
changelog-scan Скилл changelog-scan собирает изменения с прошлого релиза по коммитам и мержам и раскладывает их в список пунктов с итоговой сводкой. CX Codex +1 ★ 11 819звёзд репо draft-release-notes Скилл draft-release-notes собирает черновик релиз-ноутс из данных сканирования по категориям вроде фич и багфиксов. Выдаёт чистый Markdown для CHANGELOG или GitHub Releases и ждёт подтверждения человека. CX Codex +1 ★ 11 819звёзд репо changelog-scan Скилл changelog-scan сканирует свежие слияния, PR и коммиты, чтобы собрать материал для changelog. Подходит для подготовки структурированных заметок к релизу. CX Codex +1 ★ 11 819звёзд репо draft-release-notes Скилл draft-release-notes превращает вывод сканирования changelog в черновик релизных заметок с разделами. Публикацию оставляет человеку: скилл только предлагает текст. CX Codex +1 ★ 11 819звёзд репо changelog-verifier Субагент changelog-verifier проверяет черновики списков изменений на основе сырых данных коммитов и PR. Находит выдуманные пункты, пропущенные критические правки и защищает от инъекций в описаниях задач. CX Codex ★ 11 819звёзд репо loop-constraints Скилл loop-constraints загружает правила проекта до начала работы и проверяет их перед изменениями, тестами, отправкой и слиянием кода. CX Codex +1 ★ 11 819звёзд репо ci-triage Скилл ci-triage разбирает упавшие CI-прогоны: находит job и шаг, относит сбой к флейку, регрессии, окружению или конфигу и говорит, что делать дальше. CX Codex +1 ★ 11 819звёзд репо dependency-triage Скилл dependency-triage сканирует манифесты и локфайлы пакетов на уязвимости и устаревшие версии. Помогает приоритизировать обновления зависимостей в проекте. CX Codex +1 ★ 11 819звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой