# bmad

Reads your current project state and names the next BMAD artifact or gate. Useful when you are stuck after idea notes, a PRD or an architecture draft.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 334 installs · ★ 50
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/bmad/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-bmad

## What it does

The skill acts as a front door into a BMAD/BMM workflow. It first classifies what you already have: idea notes, a product brief, a PRD, a tech spec, an architecture draft, review feedback, an active repo or milestone pressure. Then it picks a project level from 0 to 4 and infers the likely current phase.

What you get back is one next step, not a stack of parallel documents. If an artifact exists but was never reviewed, the skill often points at the review gate instead of another draft. For level 0–1 work it does not push heavy planning or architecture. Specialist jobs are routed outward on purpose: `bmad-idea` for early concept framing, `plannotator` for approval, `task-planning` for backlog slicing, and `oh-my-claudecode`, `oh-my-codex` or `oh-my-agent` for runtime setup.

Under the hood are `references/intake-packets-and-route-outs.md`, `references/core-routing.md`, `references/status-and-review.md` and `references/runtime-and-module-boundaries.md`. The skill is allowed `Read`, `Write`, `Bash`, `Grep` and `Glob`, so it inspects repo state itself. When a project already exists, it prefers a brownfield-resume packet over pretending you are starting fresh — worth checking, because that is where a working repo can get misread as a clean slate.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill bmad -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bmad/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bmad/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill bmad -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bmad/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill bmad -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bmad/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills bmad
```

2. **Manually: put the files in place**
- File: `.github/skills/bmad/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill bmad -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/bmad
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bmad/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill bmad -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/bmad/SKILL.md

## When to use it
- figure out which BMAD phase follows idea notes
- choose between a PRD and a tech spec during planning
- decide whether a review gate is needed before moving on
- turn an approved architecture into a sprint plan
- pick the next step inside an existing repository

## Example prompts
- I have idea notes and a draft PRD — what comes next in BMAD?
- The project is already in a repo with some features built. What is the next artifact?
- Architecture is done but not approved. What now?

## Similar
- [bmad-architecture](https://affpapa.org/en/nevibecode/skills/bmad-architecture.md) — skill · 12000 installs
- [bmad-brainstorming](https://affpapa.org/en/nevibecode/skills/bmad-brainstorming.md) — skill · 12000 installs
- [speckit-plan](https://affpapa.org/en/nevibecode/skills/speckit-plan.md) — skill · 2500 installs
- [goal-plan](https://affpapa.org/en/nevibecode/skills/goal-plan.md) — skill · 770 installs
- [bmad-marketing-growth-module](https://affpapa.org/en/nevibecode/skills/bmad-marketing-growth-module.md) — skill · 908 installs
- [think](https://affpapa.org/en/nevibecode/skills/think.md) — skill · 15000 installs

## Other versions with the same name
- [bmad · bmad-code-org](https://affpapa.org/en/nevibecode/skills/bmad.md) — 13300 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 22 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md