Agent skill

Bmad Loop Resolve

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

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

Custom licenceAuto-check passed

Install Bmad Loop Resolve

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

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

GitHub CLI
$ gh skill install bmad-code-org/bmad-loop bmad-loop-resolve --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-resolve .claude/skills/bmad-loop-resolve && 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-resolve
GitHub stars
149
Used in
1 other repo
Token cost
~4.9k tokens
SKILL.md length
2,704 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 5 steps: Read the context, then read the frozen… → Present the current pause evidence… → Get the human's decision. Ask follow-ups… → …
  • SKILL.md covers Identity & I/O contract, What you MUST do, Special case: a review-stage… and Special case: an…, plus 3 more sections
  • Calls git; needs BMAD_LOOP_STORY_KEY

What it does

Bmad Loop Resolve is an agent skill from bmad-code-org/bmad-loop. Interactive escalation-resolution workflow for the bmad-loop orchestrator. A bmad-loop run paused on a CRITICAL escalation (a contradiction or gap a dev/review session could not safely resolve alone); you and the human disambiguate the frozen spec so the story can be re-driven. Invoked as /bmad-loop-resolve <story-key. Unlike the automated dev/review sessions this session is interactive — a human is present and you SHOULD ask.

Its SKILL.md is about 4.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

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

Example prompts

  • “/bmad-loop-resolve”

Requirements

  • A credential in BMAD_LOOP_STORY_KEY

Workflow steps

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

  1. Read the context, then read the frozen spec at spec_file in full —
  2. Present the current pause evidence plainly to the human
  3. Get the human's decision. Ask follow-ups if the choice is unclear. Do not
  4. Update the frozen spec to encode the decision unambiguously: amend the
  5. Write the resolution marker at resolution_path (schema above), then tell

What it can do on your machine

Read from SKILL.md and the folder at commit 5cbbf66. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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 these keys or tokens, usually read from environment variables:

    • BMAD_LOOP_STORY_KEY

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

Context cost

Bmad Loop Resolve loads about 4.9k tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 2,704 words of instructions outside code blocks.

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

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 2,704 words (~4,900 tokens).

“A bmad-loop run drove a story through dev → review, a session raised a CRITICAL escalation (work could not proceed safely — usually a contradiction or an unanswered question in the frozen spec), and the orchestrator paused the whole run…”

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

Read the full SKILL.md on GitHub

Files

Just SKILL.md in src/bmad_loop/data/skills/bmad-loop-resolve of bmad-code-org/bmad-loop.

Open the folder on GitHubat commit 5cbbf66

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 Resolve 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 Resolve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Loop Resolve this skillbmad-code-org/bmad-loop1491 repos~4.9kAutomated safety check: PassCustom licence
Team Agent Orchestrationaffaan-m/ECC275k1 repos~1.2kAutomated safety check: PassMIT
Orca Orchestrationstablyai/orca87k—~916Automated safety check: PassMIT
Agent Orchestrator Taskruvnet/ruflo74k3 repos~1kAutomated safety check: PassMIT
Plan Orchestrateaffaan-m/ECC275k1 repos~4.5kAutomated safety check: PassMIT
Resolve Git Conflictspenpot/penpot61k—~772Automated safety check: PassMPL-2.0

Similar skills

  • Run team-based orchestration for agent squads: work items with owners and scope, agent Kanban state, branch isolation, control pane visibility, and merge gates.

    275k GitHub starsUsed in 1 repo~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Orca Orchestration

    stablyai/orca

    Coordinate supervised Orca workers: threaded messages, blocking ask/reply, task dispatch, worker_done/escalation waits, task DAGs, decision gates, coordinator…

    87k GitHub stars~916 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent skill for orchestrator-task - invoke with $agent-orchestrator-task

    74k GitHub starsUsed in 3 repos~1k tokens
    Agent WorkflowsAuto-check passed
  • Plan Orchestrate

    affaan-m/ECC

    Read a plan document, decompose it into steps, design a per-step agent chain from the ECC catalogue, and emit ready-to-paste /orchestrate custom prompts.

    275k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed
  • Conflict resolution flow — understand the local git conflicts, present a resolution plan, and resolve them after the user approves it.

    61k GitHub stars~772 tokensUpdated today
    DevelopmentAuto-check passed
  • Orchestrate

    sickn33/agentic-awesome-skills

    Coordinate focused subagents on substantial work, keep their ownership non-overlapping, and integrate verified results.

    47k GitHub starsUsed in 1 repo~692 tokens
    Agent WorkflowsAuto-check passed

More from bmad-code-org/bmad-loop

  • Bmad Loop Setup

    bmad-code-org/bmad-loop

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

    149 GitHub starsUsed in 1 repo~3.4k 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 today
    Auto-check: warnings

Questions about Bmad Loop Resolve

What does Bmad Loop Resolve do?

Interactive escalation-resolution workflow for the bmad-loop orchestrator. Bmad Loop Resolve is an agent skill from bmad-code-org/bmad-loop. Interactive escalation-resolution workflow for the bmad-loop orchestrator.

How do I install Bmad Loop Resolve in Claude Code?

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

How do I install Bmad Loop Resolve in Codex?

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

Can I use Bmad Loop Resolve 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-resolve -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-resolve, .gemini/skills/bmad-loop-resolve, .github/skills/bmad-loop-resolve and .opencode/skills/bmad-loop-resolve in your project.

What does Bmad Loop Resolve need to run?

Going by SKILL.md and its folder, Bmad Loop Resolve needs the command-line tools its instructions call (git) and credentials named BMAD_LOOP_STORY_KEY. Our summary lists: A credential in BMAD_LOOP_STORY_KEY.

Does Bmad Loop Resolve access the network?

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

Is Bmad Loop Resolve 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 Resolve use?

Bmad Loop Resolve 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 Resolve use?

About 4.9k tokens (SKILL.md is roughly 20k 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 Resolve?

Skills that share tags, products or a category with Bmad Loop Resolve: Team Agent Orchestration (affaan-m/ECC, 275k stars), Orca Orchestration (stablyai/orca, 87k stars), Agent Orchestrator Task (ruvnet/ruflo, 74k stars) and Plan Orchestrate (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Loop Resolve?

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 7, 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.