bmad-loop-setup

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

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-loop-setup-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-loop-setup
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-loop-setup
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-loop-setup-pastasus

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, bootstrapped per project with CLI hooks, and kept in sync on upgrades. This Skill automates that entire install, upgrade, and preflight workflow. ## Core Features & Use Cases - Orchestrator Install & Upgrade: Installs or upgrades the bmad-loop Python package from its Git repository via uv tool install, 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 a readiness checklist covering config, sprint-status, git, tmux, and the coding CLI. - Use Case: A developer adds BMAD Loop automation to an existing BMAD project and asks to 'install bmad-loop module' — the Skill detects a fresh install, installs the tool, registers hooks for claude and codex, and reports the preflight results. ## 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 project?

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

How do I upgrade the bmad-loop orchestrator tool?

Re-run the setup skill with an upgrade argument. It runs uv tool upgrade bmad-loop --reinstall (required for Git sources), then bmad-loop init with --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, and point each stage at a CLI via the [adapter] tables in .bmad-loop/policy.toml.

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

A non-zero exit on a fresh project is expected, not an install failure. It means prerequisites like sprint-status.yaml or a bmad-sprint-planning run are missing; treat the output as a readiness checklist of what remains.

Does this skill register the module in the BMAD help system?

It only refreshes _bmad/bmad-loop/module-help.csv; the BMAD installer owns module registration, config.toml, and the help catalog. On projects that never ran the installer, help entries appear after the next npx bmad-method install run.