New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Bmad Init

by aj-geddes in aj-geddes/claude-code-bmad-skills

Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…

Custom licenceAuto-check: notesProduct & Project Management

Install Bmad Init

skills CLI
$ npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-init -a claude-code

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

GitHub CLI
$ gh skill install aj-geddes/claude-code-bmad-skills bmad-init --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/aj-geddes/claude-code-bmad-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bmad-planning-orchestrator/skills/bmad-init .claude/skills/bmad-init && 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-init
GitHub stars
488
Token cost
~1.4k tokens
SKILL.md length
541 words
Files
7 (incl. scripts)
Skills in repo
20
Repo updated
First seen
Licence
Custom licence

At a glance

Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…

  • Works in 6 steps: Check for an existing workspace. Glob… → Gather rough scope signals in… → Suggest a track. Run the helper to print… → …
  • The user says initialize BMAD
  • SKILL.md covers What it produces, The three TRACKS (never…, Workflow and Three intents, plus 1 more section
  • Runs Shell scripts from its folder; calls bash

What it does

Bmad Init is an agent skill from aj-geddes/claude-code-bmad-skills. Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and a project-context.md "constitution". Use when the user says "initialize BMAD", "set up BMAD", "start a new BMAD project", "scaffold the planning workspace", "bmad init", "create the bmad config", or is beginning planning and has no bmad-output/ folder yet. Also use when the user asks "which track should I use?" or…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `REFERENCE.md`, `scripts/init-project.sh` and `scripts/select-track.sh`).

It sits in Product & Project Management, covering PRD writing and Architecture decision records. The repository describes itself as: BMAD Method skills for Claude Code - Auto-detection, Memory integration, Slash commands. Transform Claude Code into a BMAD-powered development environment.

When your agent uses it

  • The user says initialize BMAD
  • Start a new BMAD project
  • Scaffold the planning workspace
  • Create the bmad config

Example prompts

  • “constitution”
  • “initialize BMAD”
  • “set up BMAD”
  • “/bmad-init”

Requirements

  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, TodoWrite

Workflow steps

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

  1. Check for an existing workspace. Glob for bmad-output/config.yaml (or a
  2. Gather rough scope signals in conversation (don't interrogate)
  3. Suggest a track. Run the helper to print the three tracks and a suggested
  4. Scaffold. Once the user confirms name + track, run
  5. Open the constitution. Walk the user through filling the first sections of
  6. Hand off. Recommend the next planning step based on track

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • TodoWrite

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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 Init loads about 1.4k tokens when it runs. Until then it costs about 164 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~164
When it runs · the whole SKILL.md, loaded when a task matches
~1.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite

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); the scripts in this folder 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 541 words (~1,406 tokens).

“Set up the planning workspace and choose the TRACK that scales the rest of the BMAD planning workflows. This is a planning skill: it creates folders and seed documents only. It never writes application code, runs tests, or builds anything.”

— opening of SKILL.md by aj-geddes, Custom licence
name
bmad-init
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, TodoWrite

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (scripts) in bmad-planning-orchestrator/skills/bmad-init of aj-geddes/claude-code-bmad-skills.

  • SKILL.md
  • REFERENCE.md
  • scripts/init-project.sh
  • scripts/select-track.sh
  • templates/config.template.yaml
  • templates/decision-log.template.md
  • templates/project-context.template.md

Open the folder on GitHubat commit 27dca0e

Compare with similar skills

Bmad Init 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 Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bmad Init this skillaj-geddes/claude-code-bmad-skills488—~1.4kAutomated safety check: NotesCustom licence
Schematicblader/schematic240—~2.2kAutomated safety check: PassMIT
Shep Workstreamsshep-ai/shep264—~2.5kAutomated safety check: PassMIT
Write Update Tidb Docspingcap/docs615—~2.3kAutomated safety check: PassCustom licence
App Spec Packagerinstructa/agent-skills139—~1.5kAutomated safety check: PassNone
Ad Handoffalexandremendoncaalvaro/CorridorKey-Runtime7561 repos~4.2kAutomated safety check: NotesCustom licence

Similar skills

  • Schematic

    blader/schematic

    Reverse engineer a detailed product and technical specification document from a git branch's implementation.

    240 GitHub stars~2.2k tokensUpdated 7 mo ago
    Product & Project ManagementAuto-check passed

  • Shep Workstreams

    shep-ai/shep

    A skill your agent uses when a large body of work (a version milestone, an epic, a roadmap, a set of PRDs/design docs) needs to be broken into parallel workstreams and executed with the shep CLI.

    264 GitHub stars~2.5k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

  • Write Update Tidb Docs

    pingcap/docs

    Write new TiDB documentation or update existing TiDB documentation from code changes, PRs, issues, design docs, product specs, rough drafts, existing docs, or short feature descriptions.

    615 GitHub stars~2.3k tokensUpdated today
    Product & Project ManagementAuto-check passed

  • App Spec Packager

    instructa/agent-skills

    A skill your agent uses when the user wants to turn an application, product, startup idea, SaaS, mobile app, web app, API, AI product, or internal tool into a production-ready Markdown specification…

    139 GitHub stars~1.5k tokensUpdated 11 days ago
    Product & Project ManagementAuto-check passed

  • Ad Handoff

    alexandremendoncaalvaro/CorridorKey-Runtime

    Compact the current session into a handoff document a fresh agent can pick up from.

    756 GitHub starsUsed in 1 repo~4.2k tokens
    Product & Project ManagementAuto-check: notes

  • Rfc Modeling

    mirumee/nimara-ecommerce

    A skill your agent uses when designing, drafting, refining, or stress-testing an RFC for an approved PRD, including requests for a design doc, solution design, or how to build it.

    129 GitHub stars~920 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from aj-geddes/claude-code-bmad-skills

All 20 skills in this repo

  • Bmad Architecture

    aj-geddes/claude-code-bmad-skills

    Solutioning skill (Winston, the Architect). An agent skill from aj-geddes/claude-code-bmad-skills.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes

  • Bmad Brainstorm

    aj-geddes/claude-code-bmad-skills

    Facilitates structured ideation sessions using proven brainstorming techniques (SCAMPER, SWOT, 5 Whys, Mind Mapping, Six Thinking Hats, Reverse Brainstorming, Starbursting, Brainwriting).

    488 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes

  • Bmad Builder

    aj-geddes/claude-code-bmad-skills

    Meta-skill for scaffolding and validating custom PLANNING/ORCHESTRATION skills within the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check: notes

  • Bmad Epics And Stories

    aj-geddes/claude-code-bmad-skills

    Solutioning flagship — shards a PRD + architecture into epics.md and individual {epic}.{story}.{slug}.story.md context objects, the LAST planning artifact before external dev handoff.

    488 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check: notes

  • Bmad Help

    aj-geddes/claude-code-bmad-skills

    Orchestration spine and "what do I do next?" router for the BMAD Planning & Orchestrator plugin.

    488 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check: notes

  • Bmad Parallel Plan

    aj-geddes/claude-code-bmad-skills

    Turns a sequential, ready-for-dev story backlog into conflict-free CONCURRENT WAVES.

    488 GitHub stars~1.8k tokensUpdated 3 mo ago
    Auto-check: notes

Categories

Questions about Bmad Init

What does Bmad Init do?

Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow / BMad Method / Enterprise) interactively, then scaffold the output folder, a config file, an empty decision-log.md, and…. Bmad Init is an agent skill from aj-geddes/claude-code-bmad-skills.md "constitution".

When should I use Bmad Init?

Bmad Init fits situations like: the user says initialize BMAD; start a new BMAD project; scaffold the planning workspace; create the bmad config.

How do I install Bmad Init in Claude Code?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-init -a claude-code`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-init in aj-geddes/claude-code-bmad-skills) into .claude/skills/bmad-init in your project. Claude Code loads it when a task matches its description.

How do I install Bmad Init in Codex?

Run `npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-init -a codex`. Or copy the skill folder (bmad-planning-orchestrator/skills/bmad-init in aj-geddes/claude-code-bmad-skills) into .agents/skills/bmad-init in your project. Codex loads it when a task matches its description.

Can I use Bmad Init 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 aj-geddes/claude-code-bmad-skills --skill bmad-init -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-init, .gemini/skills/bmad-init, .github/skills/bmad-init and .opencode/skills/bmad-init in your project.

What does Bmad Init need to run?

Going by SKILL.md and its folder, Bmad Init needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite.

Does Bmad Init access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Bmad Init safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bmad Init use?

Bmad Init 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 Init use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Init?

Skills that share tags, products or a category with Bmad Init: Schematic (blader/schematic, 240 stars), Shep Workstreams (shep-ai/shep, 264 stars), Write Update Tidb Docs (pingcap/docs, 615 stars) and App Spec Packager (instructa/agent-skills, 139 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Init?

aj-geddes (a GitHub user) maintains it in aj-geddes/claude-code-bmad-skills, which has 488 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 20, 2026.

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