bmad-loop-setup

Install and upgrade the BMad Loop orchestrator with uv and configure project files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the complex, multi-step process of installing, configuring, and upgrading the BMad Loop orchestrator and its associated automation skills, ensuring your project environment is always synchronized and ready for development.

Core Features & Use Cases

  • Unified Setup & Upgrade: Handles both fresh installations and seamless upgrades of the bmad-loop orchestrator tool and project-specific skill copies.
  • Configuration Management: Consolidates project settings into shared and user-specific YAML files while maintaining an anti-zombie cleanup pattern for legacy configurations.
  • Use Case: When you need to initialize a new project with BMad automation or upgrade an existing one to the latest version of the orchestrator, this skill manages the tool installation, hook registration, and directory cleanup automatically.

Quick Start

Use the bmad-loop-setup skill to install or upgrade the bmad-loop module and orchestrator in your current 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 automate development loop setup and orchestrator configuration for a new project?

Automate development loop setup by running the skill to install the bmad-loop Python package via uv, synchronize project-level configuration files, and register CLI hooks for development workflows.

What is the best way to upgrade an existing automation orchestrator without breaking configuration?

Upgrade an existing automation orchestrator by executing the skill, which handles tool installation, synchronizes shared and user-specific YAML files, and applies an anti-zombie cleanup pattern for legacy configurations.

Do I need uv installed to configure the bmad-loop orchestrator?

Yes, you need uv installed because the skill manages the installation of the bmad-loop Python package via uv, alongside validating project readiness through preflight checks.

How does preflight validation work when initializing project automation?

Preflight validation works by checking project readiness before synchronizing configuration files and registering coding CLI hooks, ensuring your directory is fully prepared for the automation orchestrator.

Can I consolidate user-specific and shared YAML configurations during orchestrator setup?

Yes, you can consolidate project settings into shared and user-specific YAML files during orchestrator setup, while the skill simultaneously cleans up legacy configurations to maintain consistency.

Why does my development loop setup fail during CLI hook registration?

Development loop setup may fail during CLI hook registration if preflight checks detect an unready project directory, preventing the synchronization of configuration files and help system entries.