Agent skill

Bmad Loop Setup

by bmad-code-org in bmad-code-org/bmad-loop

Sets up BMAD Loop Skills module in a project. An agent skill from bmad-code-org/bmad-loop.

Custom licenceAuto-check passed

Install Bmad Loop Setup

skills CLI
$ npx skills add bmad-code-org/bmad-loop --skill bmad-loop-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bmad-code-org/bmad-loop bmad-loop-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bmad-code-org/bmad-loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/bmad_loop/data/skills/bmad-loop-setup .claude/skills/bmad-loop-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bmad-loop-setup
GitHub stars
149
Used in
1 other repo
Token cost
~3.4k tokens
SKILL.md length
1,756 words
Files
3 (incl. assets)
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

Sets up BMAD Loop Skills module in a project. An agent skill from bmad-code-org/bmad-loop.

  • Works in 3 steps: Install or upgrade the orchestrator tool… → Run bmad-loop init to register the… → Preflight with bmad-loop validate and…
  • The user requests to install bmad-loop module
  • SKILL.md covers Overview, On Activation, Register Help Entries and Install the Orchestrator Tool, plus 2 more sections
  • Calls uv and npx

What it does

Bmad Loop Setup is an agent skill from bmad-code-org/bmad-loop. Sets up BMAD Loop Skills module in a project. Use when the user requests to 'install bmad-loop module', 'configure BMAD Loop Skills', or 'setup BMAD Loop Skills'.

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including assets (for example `assets/module.yaml`).

The repository describes itself as: Automate the BMad Dev Cycle.

When your agent uses it

  • The user requests to install bmad-loop module
  • Configure BMAD Loop Skills
  • Setup BMAD Loop Skills

Example prompts

  • “install bmad-loop module”
  • “configure BMAD Loop Skills”
  • “setup BMAD Loop Skills”
  • “/bmad-loop-setup”

Requirements

  • Python 3
  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install or upgrade the orchestrator tool (the installer copies skill directories only — it cannot carry a Python package).
  2. Run bmad-loop init to register the per-CLI hooks, lay down the bundled skills, and write .bmad-loop/policy.toml + gitignore entries.
  3. Preflight with bmad-loop validate and point the user at per-role adapter config.

What it can do on your machine

Read from SKILL.md and the folder at commit 0c7322c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bmad Loop Setup loads about 3.4k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 1,756 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,756 words (~3,357 tokens).

“Installs, configures, and upgrades the bmad-loop module in a project.”

— opening of SKILL.md by bmad-code-org, Custom licence
name
bmad-loop-setup

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (assets) in src/bmad_loop/data/skills/bmad-loop-setup of bmad-code-org/bmad-loop.

  • SKILL.md
  • assets/module-help.csv
  • assets/module.yaml

Open the folder on GitHubat commit 0c7322c

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in bmad-code-org/bmad-loop, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bmad Loop Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bmad Loop Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Loop Setup this skillbmad-code-org/bmad-loop1491 repos~3.4kAutomated safety check: PassCustom licence
Manage Settingsasgeirtj/system_prompts_leaks69k—~3.1kAutomated safety check: PassCC0-1.0
Warp Settings Editorwarpdotdev/warp65k1 repos~675Automated safety check: PassAGPL-3.0
Es Modulesthedaviddias/Front-End-Checklist74k—~482Automated safety check: PassMIT
Warp Settings Page Builderwarpdotdev/warp65k1 repos~4.5kAutomated safety check: PassAGPL-3.0
Add Server Env Var for User Settinglobehub/lobehub83k—~644Automated safety check: PassCustom licence

Similar skills

  • Manage Settings

    asgeirtj/system_prompts_leaks

    Any explicit Muse Code setting question or change (model, reasoning effort, /settings) requires a silent readskill call for bundled:manage-settings as FIRST ACTION—no assistant text or other tool…

    69k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Warp Settings Editor

    warpdotdev/warp

    Finds and changes Warp application settings by searching a bundled JSON schema and editing the matching TOML settings file at the right nesting depth.

    65k GitHub starsUsed in 1 repo~675 tokens
    Productivity & AutomationAuto-check passed
  • Es Modules

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Use ES modules (import/export).

    74k GitHub stars~482 tokensUpdated yesterday
    Auto-check passed
  • How to build a settings page in the Warp desktop client so widgets, page titles and settings search behave correctly, and which common mistakes to avoid.

    65k GitHub starsUsed in 1 repo~4.5k tokens
    Frontend & DesignAuto-check passed
  • Adds a server-side environment variable that sets the default for a user setting in LobeHub, wired from the env schema through server config to the user store and docs.

    83k GitHub stars~644 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Add Settings Page

    simstudioai/sim

    Add a new Sim settings page, or audit existing settings pages for design-system compliance with the shared SettingsPanel layout.

    30k GitHub stars~1.6k tokensUpdated today
    Frontend & DesignAuto-check passed

More from bmad-code-org/bmad-loop

  • Bmad Loop Resolve

    bmad-code-org/bmad-loop

    Interactive escalation-resolution workflow for the bmad-loop orchestrator.

    149 GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed
  • Bmad Loop Sweep

    bmad-code-org/bmad-loop

    Triage the deferred-work ledger for the bmad-loop orchestrator: verify every selected open entry against the actual codebase and return a machine-readable partition (bundles, already-resolved…

    149 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check: warnings

Questions about Bmad Loop Setup

What does Bmad Loop Setup do?

Sets up BMAD Loop Skills module in a project. An agent skill from bmad-code-org/bmad-loop. Bmad Loop Setup is an agent skill from bmad-code-org/bmad-loop. Sets up BMAD Loop Skills module in a project.

When should I use Bmad Loop Setup?

Bmad Loop Setup fits situations like: the user requests to install bmad-loop module; configure BMAD Loop Skills; setup BMAD Loop Skills.

How do I install Bmad Loop Setup in Claude Code?

Run `npx skills add bmad-code-org/bmad-loop --skill bmad-loop-setup -a claude-code`. Or copy the skill folder (src/bmad_loop/data/skills/bmad-loop-setup in bmad-code-org/bmad-loop) into .claude/skills/bmad-loop-setup in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Loop Setup in Codex?

Run `npx skills add bmad-code-org/bmad-loop --skill bmad-loop-setup -a codex`. Or copy the skill folder (src/bmad_loop/data/skills/bmad-loop-setup in bmad-code-org/bmad-loop) into .agents/skills/bmad-loop-setup in your project. Codex loads it when a task matches its description.

Can I use Bmad Loop Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bmad-code-org/bmad-loop --skill bmad-loop-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bmad-loop-setup, .gemini/skills/bmad-loop-setup, .github/skills/bmad-loop-setup and .opencode/skills/bmad-loop-setup in your project.

What does Bmad Loop Setup need to run?

Going by SKILL.md and its folder, Bmad Loop Setup needs the command-line tools its instructions call (uv and npx). Our summary lists: Python 3; Node.js.

Does Bmad Loop Setup access the network?

SKILL.md contains no URLs. Its commands use uv and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bmad Loop Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bmad Loop Setup use?

Bmad Loop Setup has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Bmad Loop Setup use?

About 3.4k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bmad Loop Setup?

Skills that share tags, products or a category with Bmad Loop Setup: Manage Settings (asgeirtj/system_prompts_leaks, 69k stars), Warp Settings Editor (warpdotdev/warp, 65k stars), Es Modules (thedaviddias/Front-End-Checklist, 74k stars) and Warp Settings Page Builder (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Loop Setup?

bmad-code-org (a GitHub organization) maintains it in bmad-code-org/bmad-loop, which has 149 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 6, 2026.

Source: bmad-code-org/bmad-loop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.