Skip to content
Development
Skill

/loop-doctor

Checks that the loop is actually installed and working in this project - files present, role profiles valid, connections alive, effort level real. Use after setup, after an upgrade, or when something behaves as if the method is not loaded.

From plugin
loop-kit
87 skills6 agents2 hooks

Claude Code

$ npx -y skills add cbdreamer11/CB-loop-kit-claude-plugin --skill loop-doctor --agent claude-code

SKILL.md

loop-doctor.SKILL.md
name: loop-doctor
description: Checks that the loop is actually installed and working in this project - files present, role profiles valid, connections alive, effort level real. Use after setup, after an upgrade, or when something behaves as if the method is not loaded.

Doctor

Verify the installation the same way the method verifies everything else: by observing, not by assuming it took.

1 · The files

`ls -la .loop/ .loop/roles/ .claude/agents/ 2>&1` and confirm: `STATE.md`, `VERIFY.md`, `DECISIONS.md`, `GOTCHAS.md`, the four role profiles, the `loop` wrapper (and that it is executable), and the role agents in the project's `.claude/agents/`.

Report anything missing, and whether `.loop/ACCESS.local.md` is gitignored — if it is tracked, stop and say so loudly: it is the file most likely to hold a credential.

2 · The contract is still true

`.loop/VERIFY.md` rots faster than anything else. **Run each declared command** and report which ones still work. A verification contract with a stale build command is worse than none, because it produces confident green nonsense.

3 · The connections

Re-run the connection table from session 0: build, browser, database, payments test mode, git remote. PASS / FAIL / ABSENT. Every ABSENT should already be a declared GAP in `.loop/VERIFY.md`; if it is not, add it.

4 · The effort this session is really running at

This session's effort level: **${CLAUDE_EFFORT}**

If that shows a level, that is the real one — including any silent downgrade. If it printed the placeholder literally, this version does not interpolate it; run `echo "$CLAUDE_EFFORT"` in a shell instead. There is deliberately no equivalent for the model: **no session can read which model it is running on**, so do not print a guess. If the role matters, relaunch with `./loop <role>` and trust the profile.

5 · Verdict

One table: what is healthy, what is broken with the exact command to fix it, and what is absent by design. If anything in section 1 or 2 is broken, say plainly that the method is **not** in force in this project yet.

Read more
@cbdreamer11
Ships withloop-kit

A working method for building real software with coding agents, across many sessions.

87 skills6 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
8
Star history of cbdreamer11/CB-loop-kit-claude-plugin on GitHub, a chart by star-history.com

Other skills on loop-kit.

loop-close

loop-close

Closes a slice or a session - adversarial audit of the diff, ledger entry, selective commit, honest report, and the handoff for…

loop-council

loop-council

Sends an open design question to several independent voices in parallel and returns a decision with its evidence. Use before…

loop-plan

loop-plan

The planning session. Turns a goal into an ordered list of thin complete slices, decides which role and model runs each following…

loop-setup

loop-setup

Session 0. Sets up the loop in this project - detects the stack, checks which connections actually work (git, database, browser,…

loop-verify

loop-verify

Runs this project's verification contract and decides honestly whether something is verified, a gap, or a lie. Use before calling…

loop

loop

The build loop - locate yourself, investigate the real code, build one slice completely, verify it for real, fix and re-verify,…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills12d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc13d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react2d252k
@facebook@facebookInstall Skill

Questions about loop-doctor.

Which coding agents can use loop-doctor?
loop-doctor 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.