bmad-run-inspector agent skill by tronghieu

At a glance

Before you install

Read from the skill's files at the directory's October 22, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

• Bundled scripts: 4 script files (4 Python). Your agent may run them, so read them first.
• Tool permissions requested: Read Glob Grep Bash(python3 *) Bash(bmad-loop *) Bash(git *) Bash(ls *) Bash(ps *) Bash(wc *) Bash(tmux *) Bash(psmux *) (the allowed-tools field of SKILL.md).
• License: MIT, an open-source or open-content license.

Install bmad-run-inspector

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

npx skills add https://github.com/tronghieu/agent-skills/tree/main/skills/bmad-run-inspector

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/tronghieu/agent-skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/bmad-run-inspector .claude/skills/
rm -rf "$tmp"

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/tronghieu/agent-skills.git "$tmp/repo"
mkdir -p .agents/skills
cp -R "$tmp/repo/"skills/bmad-run-inspector .agents/skills/
rm -rf "$tmp"

For a user-level install, copy the folder to ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex). Inside Codex, $skill-installer can also fetch a skill from GitHub. New to skills? Read How to install agent skills in Claude Code, Codex and Cursor.

tronghieu/agent-skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Inspect and explain bmad-loop run artifacts under `.bmad-loop/runs/`. Use for live health checks ("is it stuck?", "is the loop alive?", "what is the agent doing?") and post-run forensics ("what happened?", "why did story X fail?", "where did the tokens go?"). Also triggers on "monitor/check/summarize the loop", "why did the run pause?", Vietnamese "theo dõi bmad loop", "phân tích run", "đọc log của run", and equivalent requests in other languages. Use only for bmad-loop's own run artifacts, not application runtime logs or CI-provider build logs.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

• The one thing to get right
• Know the project before you read it
• Check the CLI before reading the disk
• Workflow
• 1. Probe the state
• 2. Reconstruct the narrative
• 3. Cross-check against the working tree
• Deciding whether verify passed
• Reporting
• Reference material
• Honesty rules

Files in the skill folder

• README.md
• README.vi.md
• README.zh.md
• SKILL.md
• assets/templates/environment.md
• assets/templates/environment.toml
• assets/templates/project-readme.md
• references/adapter-bootstrap.md
• references/anomaly-triage.md
• references/log-forensics.md
• references/run-anatomy.md
• scripts/bootstrap_adapter.py
• scripts/extract_transcript.py
• scripts/run_probe.py
• tests/test_scripts.py

Suede Skill Check: 90/100 · A

bmad-run-inspector passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

Where this skill is cited

tronghieu/agent-skills appears in 2 curated lists: VoltAgent/awesome-agent-skills, hesreallyhim/awesome-claude-code.

More AI agent skills

All AI agent and LLM engineering skills

More from tronghieu/agent-skills

All 19 skills in tronghieu/agent-skills