# loop-budget

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 11819 у репозитория
- Автор: Cobus Greyling
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/cobusgreyling/loop-engineering/tree/HEAD/skills/loop-budget/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add cobusgreyling/loop-engineering
```
В чате агента (не в терминале):
```text
/plugin install loop-engineering@loop-engineering
```
Команда ставит плагин loop-engineering целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/loop-budget/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/loop-budget/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/loop-budget/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/loop-budget/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cobusgreyling/loop-engineering skills/loop-budget
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/loop-budget/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add cobusgreyling/loop-engineering --skill loop-budget -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/cobusgreyling/loop-engineering --path skills/loop-budget
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/loop-budget/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/cobusgreyling/loop-engineering/tree/HEAD/skills/loop-budget/SKILL.md

## Когда брать
- проверить дневной лимит токенов перед итерацией
- остановить цикл при достижении бюджета
- не запускать субагентов без задач для действий
- переключить цикл в режим только отчёта
- записать расход и результат в журнал

## Примеры запросов агенту
- Проверь бюджет и журнал перед запуском следующей итерации.
- Запусти цикл и остановись, если в `STATE.md` нет задач для действий.
- После итерации добавь расход токенов и результат в `loop-run-log.md`.

## Похожие
- [token-budget-advisor](https://affpapa.org/nevibecode/skills/token-budget-advisor.md) — скилл · 6500 установок
- [token-budget-gate](https://affpapa.org/nevibecode/skills/token-budget-gate.md) — скилл · ★ 33 у репозитория
- [context-engine](https://affpapa.org/nevibecode/skills/borghei-context-engine.md) — скилл · 112 установок
- [om-auto-continue-pr-loop](https://affpapa.org/nevibecode/skills/om-auto-continue-pr-loop.md) — скилл · 4600 установок
- [loop-library](https://affpapa.org/nevibecode/skills/forward-future-loop-library.md) — скилл · 2400 установок
- [loop](https://affpapa.org/nevibecode/skills/loop.md) — скилл · 1557 установок

Из того же набора: [cobusgreyling/loop-engineering](https://affpapa.org/nevibecode/by/cobusgreyling/loop-engineering.md) — 29 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
