bmad-loop-setup

Installs and upgrades the bmad-loop orchestrator tool and its automation skills in a project.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-loop-setup-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-loop-setup
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-loop-setup
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-loop-setup-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Setting up the BMAD Loop module requires more than copying skill files: the bmad-loop orchestrator is a Python package that must be installed from its Git repository, registered per coding CLI, bootstrapped with hooks and policy files, and validated — steps the BMAD installer cannot perform on its own. ## Core Features & Use Cases - Orchestrator Install & Upgrade: Installs or upgrades the bmad-loop 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 per-CLI hooks (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 — this skill detects fresh-install vs upgrade, installs the tool, registers hooks for their chosen CLIs, and confirms readiness. ## Quick Start Ask the assistant to install the bmad-loop module and set up BMAD Loop Skills 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?

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, install bundled skills, and write policy.toml and gitignore entries.

How do I upgrade the bmad-loop tool and skills?

Re-run the setup skill with an upgrade argument. It runs uv tool upgrade bmad-loop --reinstall to pull new code from Git, then bmad-loop init with --force-skills so the per-project skill copies are refreshed.

Which coding CLIs does bmad-loop support?

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

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

Validation exits non-zero when prerequisites are missing, such as a sprint-status.yaml from bmad-sprint-planning or the bmm module config. On a fresh project this is expected and should be treated as a readiness checklist, not an install 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 are owned by the BMAD installer and are never written by this skill.