bmad-loop-setup

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

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-loop-setup-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-loop-setup
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-loop-setup
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-loop-setup-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bmad-loop, and 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 - Tool 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 the readiness checklist, plus refreshes _bmad/bmad-loop/module-help.csv without touching installer-owned files. - Use Case: A developer adds BMAD Loop automation to an existing BMAD project and needs the orchestrator installed, hooks registered for both claude and codex, and a mixed dev/review adapter policy explained. ## Quick Start Ask the assistant to install the bmad-loop module in this project and register hooks for your coding CLI of choice.

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?

Run the bmad-loop-setup skill, which installs the orchestrator via uv tool install from its Git repository, then runs bmad-loop init to register CLI hooks, lay down bundled skills, and write policy.toml and gitignore entries.

How do I upgrade bmad-loop to a newer version?

Re-run the setup skill with an upgrade argument. It runs uv tool upgrade bmad-loop --reinstall (required for Git sources) and bmad-loop init --force-skills so the per-project skill copies are refreshed against the upgraded tool.

Which coding CLIs does bmad-loop support?

The supported adapters are claude (default), codex, gemini, copilot, and antigravity. Pass one --cli flag per CLI to bmad-loop init; skills land in .claude/skills/ for claude and .agents/skills/ for the others.

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

A non-zero validate exit on a fresh project is expected, not an install failure. It typically means sprint-status.yaml does not exist yet because bmad-sprint-planning has not run; treat the output as a readiness checklist.

Can I use different CLIs for dev and review stages?

Yes. Register hooks for both CLIs with --cli during init, then edit .bmad-loop/policy.toml: set the default [adapter] name and add an [adapter.review] table pointing the review stage at the other CLI.