bmad-loop-setup

Installs and upgrades the bmad-loop orchestrator tool and its per-project skills.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-loop-setup-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-loop-setup
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-loop-setup
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-loop-setup-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Setting up the bmad-loop automation module requires more than copying skill files: the Python orchestrator tool must be installed from its Git repository, per-CLI hooks must be registered, and policy configuration must be bootstrapped — none of which the BMAD installer can do on its own. ## Core Features & Use Cases - Orchestrator Install & Upgrade: Installs or upgrades the bmad-loop Python package via uv tool install from its Git repository, with optional release-tag pinning and before/after version reporting. - Project Bootstrap: Runs bmad-loop init to register hooks for selected coding CLIs (claude, codex, gemini, copilot, antigravity), lay down bundled skills, and write .bmad-loop/policy.toml plus gitignore entries. - Preflight Validation: Runs bmad-loop validate and reports results as a readiness checklist, and refreshes _bmad/bmad-loop/module-help.csv without touching installer-owned files. - Use Case: A developer wants automated dev/review loops in their BMAD project — invoke this skill to install the tool, register hooks for claude and codex, and get a validated, ready-to-run setup. ## Quick Start Ask the assistant to install the bmad-loop module and set up the orchestrator tool for the claude CLI in this project.

Frequently Asked Questions about bmad-loop-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the bmad-loop module in a BMAD project?

Invoke the bmad-loop-setup skill, which installs the orchestrator via uv tool install from its Git repository, runs bmad-loop init to register CLI hooks and skills, and validates the setup. The BMAD installer handles _bmad/ registration separately.

How do I upgrade the bmad-loop orchestrator tool?

Re-run the setup skill with an upgrade argument. It detects the existing uv-managed install, runs uv tool upgrade bmad-loop --reinstall to pull new code from Git, and refreshes per-project skills with bmad-loop init --force-skills.

Which coding CLIs does bmad-loop support?

The supported adapters are claude, codex, gemini, copilot, and antigravity. Register each one with a separate --cli flag during bmad-loop init, and point individual stages at a CLI in .bmad-loop/policy.toml.

Why does bmad-loop validate fail on a fresh project?

Validation fails when prerequisites like sprint-status.yaml from bmad-sprint-planning are missing. On a fresh project this is expected — treat the output as a readiness checklist rather than an installation failure.

Does the setup skill modify BMAD installer files?

No. It only refreshes _bmad/bmad-loop/module-help.csv. Module registration, config.toml, and the help catalog remain owned by the BMAD installer, which rebuilds them on its next run.