budget-negotiator
An advanced skill for L3 autonomous loops. When the token budget nears exhaustion, the agent analyzes its ROI and autonomously…
@cobusgreylingInstall SkillDevelopment
Skill
/install-loop
Install Loop Engineering into a project via the unified CLI front door (@cobusgreyling/loop). Prefer this over invoking loop-init / loop-audit separately. Week-one is report-only; never enable auto-merge or unattended fixes unless the human explicitly asks and doctor is healthy.
Claude Code
$ npx -y skills add cobusgreyling/loop-engineering --skill install-loop --agent claude-code
Codex
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a codex -y
Cursor
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a cursor -y
Gemini CLI
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a gemini-cli -y
GitHub Copilot
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a github-copilot -y
OpenCode
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a opencode -y
Windsurf
$ npx skills add cobusgreyling/loop-engineering --skill install-loop -a windsurf -y
SKILL.md
install-loop.SKILL.mdname: install-loop
description: >
Install Loop Engineering into a project via the unified CLI front door
(@cobusgreyling/loop). Prefer this over invoking loop-init / loop-audit
separately. Week-one is report-only; never enable auto-merge or unattended
fixes unless the human explicitly asks and doctor is healthy.
Install Loop Engineering
Goal
Leave the repo with a scaffolded **report-only** loop, a **Loop Ready** score, and clear next actions — using the **single** CLI:
npx @cobusgreyling/loop
Do **not** deprecate or remove existing `loop-init` / `loop-audit` usages you find; both doors stay valid. Prefer `loop` for new work.
Steps
1. **Detect context**
- If `LOOP.md` or `STATE.md` already exists, run doctor only (skip init unless human asks to re-scaffold):
npx @cobusgreyling/loop doctor . --json
npx @cobusgreyling/loop status .- Otherwise continue.
2. **Pick pattern** (default: `daily-triage`) | Pain | Pattern | |------|---------| | Morning chaos / unclear priorities | `daily-triage` | | PRs stalling | `pr-babysitter` | | CI red / flakes | `ci-sweeper` | | CVE / Dependabot noise | `dependency-sweeper` | | Post-merge TODOs | `post-merge-cleanup` | | Stale release notes | `changelog-drafter` | | Noisy issues | `issue-triage` | | One GitHub Action, almost no files | `thin-loop` |
3. **Pick tool** — `claude` | `grok` | `codex` | `opencode` (default `claude`).
4. **Scaffold**
npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>
Optional harness (only if human wants Foundry): add `--with-foundry`.
5. **Doctor**
npx @cobusgreyling/loop doctor .
- Exit `0` = healthy · `1` = warnings · `2` = blocked
- Follow the **top 3** printed actions; do not invent extra architecture.
6. **Cost check** before high-cadence schedules:
npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d
7. **Week-one rule**
- Report only. No auto-fix, no auto-merge.
- Tell the human the first `/loop` or scheduler command from init output.
- Suggest badge only when score is strong: `npx @cobusgreyling/loop badge .`
Compatibility
These remain fully supported (do not rewrite existing docs/scripts unless asked):
npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest
Stop conditions
- Stop after doctor + first-run instructions unless the human asks for L2+.
- Never expand into fleet/memory/foundry unless score ≥ 80 **and** human opts in.
Read more
name: install-loop description: > Install Loop Engineering into a project via the unified CLI front door (@cobusgreyling/loop). Prefer this over invoking loop-init / loop-audit separately. Week-one is report-only; never enable auto-merge or unattended fixes unless the human explicitly asks and doctor is healthy.
Install Loop Engineering
Goal
Leave the repo with a scaffolded **report-only** loop, a **Loop Ready** score, and clear next actions — using the **single** CLI:
npx @cobusgreyling/loop
Do **not** deprecate or remove existing `loop-init` / `loop-audit` usages you find; both doors stay valid. Prefer `loop` for new work.
Steps
1. **Detect context**
- If `LOOP.md` or `STATE.md` already exists, run doctor only (skip init unless human asks to re-scaffold):
npx @cobusgreyling/loop doctor . --json
npx @cobusgreyling/loop status .- Otherwise continue.
2. **Pick pattern** (default: `daily-triage`) | Pain | Pattern | |------|---------| | Morning chaos / unclear priorities | `daily-triage` | | PRs stalling | `pr-babysitter` | | CI red / flakes | `ci-sweeper` | | CVE / Dependabot noise | `dependency-sweeper` | | Post-merge TODOs | `post-merge-cleanup` | | Stale release notes | `changelog-drafter` | | Noisy issues | `issue-triage` | | One GitHub Action, almost no files | `thin-loop` |
3. **Pick tool** — `claude` | `grok` | `codex` | `opencode` (default `claude`).
4. **Scaffold**
npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>
Optional harness (only if human wants Foundry): add `--with-foundry`.
5. **Doctor**
npx @cobusgreyling/loop doctor .
- Exit `0` = healthy · `1` = warnings · `2` = blocked
- Follow the **top 3** printed actions; do not invent extra architecture.
6. **Cost check** before high-cadence schedules:
npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d
7. **Week-one rule**
- Report only. No auto-fix, no auto-merge.
- Tell the human the first `/loop` or scheduler command from init output.
- Suggest badge only when score is strong: `npx @cobusgreyling/loop badge .`
Compatibility
These remain fully supported (do not rewrite existing docs/scripts unless asked):
npx @cobusgreyling/loop-init . npx @cobusgreyling/loop-audit . --suggest
Stop conditions
- Stop after doctor + first-run instructions unless the human asks for L2+.
- Never expand into fleet/memory/foundry unless score ≥ 80 **and** human opts in.
Stats
11,772
Stars
1,586
Forks
Active
Maintenance
TypeScript
Language
MIT
License
Last commit
Created
Ships withloop-engineering
Stop prompting. Design the loop. Get a score. Start in 5 minutes · Quickstart · What do you want to do? · Refactor path · 中文 · Pattern picker --tool defaults to claude if you omit it. Swap for grok, codex, or opencode. Week one is report-only.
12k14 skills2 agents
Stars on GitHub
Momentum
- stars in total
- 11.8k
Other skills on loop-engineering.
@cobusgreylingInstall Skillloop-budget
Check token budget and run-log spend before and after a loop run. Enforces early exit when over budget or when there is no…
@cobusgreylingInstall Skillloop-constraints
Read loop-constraints.md at the start of every run and enforce every rule. This skill runs BEFORE triage or any action skill.…
@cobusgreylingInstall Skillloop-triage
Triage recent changes, CI failures, issues, and conversations. Produces a concise, actionable findings report suitable for a loop…
@cobusgreylingInstall Skillloop-verifier
Independent verification agent for loop-produced changes. Finds reasons to reject. Runs tests. Confirms diff scope. Use after…
@cobusgreylingInstall Skillminimal-fix
Produce the smallest possible code change that fixes a specific, well-scoped issue (CI failure, reviewer comment, typo). Use only…
@cobusgreylingInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about install-loop.
- Which coding agents can use install-loop?
- install-loop installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.