Initialize BMad project configuration and load config variables.

Apache-2.0Auto-check passed

Install Bmad Init

skills CLI
$ npx skills add redhat-cop/vault-config-operator --skill bmad-init -a claude-code

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

GitHub CLI
$ gh skill install redhat-cop/vault-config-operator 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/redhat-cop/vault-config-operator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/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
167
Token cost
~1.2k tokens
SKILL.md length
547 words
Files
4 (incl. scripts)
Skills in repo
21
Repo updated
First seen
Licence
Apache-2.0

At a glance

Initialize BMad project configuration and load config variables.

  • Works in 5 steps: Check what needs setup → Ask core questions (if core_missing) → Ask module questions (if module was… → …
  • Any skill needs module-specific configuration values
  • SKILL.md covers Overview, On Activation — Fast Path and Init Path — First-Time Setup
  • Runs Python scripts from its folder

What it does

Bmad Init is an agent skill from redhat-cop/vault-config-operator. Initialize BMad project configuration and load config variables. Use when any skill needs module-specific configuration values, or when setting up a new BMad project.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `resources/core-module.yaml`, `scripts/bmad_init.py` and `scripts/tests/test_bmad_init.py`).

The repository describes itself as: An operator to support Haschicorp Vault configuration workflows from within Kubernetes. The licence is Apache-2.0.

When your agent uses it

  • Any skill needs module-specific configuration values
  • Setting up a new BMad project

Example prompts

  • “/bmad-init”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check what needs setup
  2. Ask core questions (if core_missing)
  3. Ask module questions (if module was requested)
  4. Write config
  5. Return vars

What it can do on your machine

Read from SKILL.md and the folder at commit 99762c2. 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

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

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

  • Network

    No URLs in SKILL.md.

    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.2k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 547 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from redhat-cop/vault-config-operator at commit 99762c2, republished under its Apache-2.0 licence (© redhat-cop). 547 words, ~1,152 tokens.

Download SKILL.mdSave it as .claude/skills/bmad-init/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
bmad-init
description
Initialize BMad project configuration and load config variables. Use when any skill needs module-specific configuration values, or when setting up a new BMad project.
argument-hint
[--module=module_code] [--vars=var1:default1,var2] [--skill-path=/path/to/calling/skill]

Overview

This skill is the configuration entry point for all BMad skills. It has two modes:

  • Fast path: Config exists for the requested module — returns vars as JSON. Done.
  • Init path: Config is missing — walks the user through configuration, writes config files, then returns vars.

Every BMad skill should call this on activation to get its config vars. The caller never needs to know whether init happened — they just get their config back.

The script bmad_init.py is located in this skill's scripts/ directory. Locate and run it using python for all commands below.

On Activation — Fast Path

Run the bmad_init.py script with the load subcommand. Pass --project-root set to the project root directory.

  • If a module code was provided by the calling skill, include --module {module_code}
  • To load all vars, include --all
  • To request specific variables with defaults, use --vars var1:default1,var2
  • If no module was specified, omit --module to get core vars only

If the script returns JSON vars — store them as {var-name} and return to the calling skill. Done.

If the script returns an error or init_required — proceed to the Init Path below.

Init Path — First-Time Setup

When the fast path fails (config missing for a module), run this init flow.

Step 1: Check what needs setup

Run bmad_init.py with the check subcommand, passing --module {module_code}, --skill-path {calling_skill_path}, and --project-root.

The response tells you what's needed:

  • "status": "ready" — Config is fine. Re-run load.
  • "status": "no_project" — Can't find project root. Ask user to confirm the project path.
  • "status": "core_missing" — Core config doesn't exist. Must ask core questions first.
  • "status": "module_missing" — Core exists but module config doesn't. Ask module questions.

The response includes:

  • core_module — Core module.yaml questions (when core setup needed)
  • target_module — Target module.yaml questions (when module setup needed, discovered from --skill-path or _bmad/{module}/)
  • core_vars — Existing core config values (when core exists but module doesn't)
Show full SKILL.md (243 more words)Show less
Step 2: Ask core questions (if core_missing)

The check response includes core_module with header, subheader, and variable definitions.

  1. Show the header and subheader to the user
  2. For each variable, present the prompt and default
  3. For variables with single-select, show the options as a numbered list
  4. For variables with multi-line prompt (array), show all lines
  5. Let the user accept defaults or provide values
Step 3: Ask module questions (if module was requested)

The check response includes target_module with the module's questions. Variables may reference core answers in their defaults (e.g., {output_folder}).

  1. Resolve defaults by running bmad_init.py with the resolve-defaults subcommand, passing --module {module_code}, --core-answers '{core_answers_json}', and --project-root
  2. Show the module's header and subheader
  3. For each variable, present the prompt with resolved default
  4. For single-select variables, show options as a numbered list
Step 4: Write config

Collect all answers and run bmad_init.py with the write subcommand, passing --answers '{all_answers_json}' and --project-root.

The --answers JSON format:

json
{
  "core": {
    "user_name": "BMad",
    "communication_language": "English",
    "document_output_language": "English",
    "output_folder": "_bmad-output"
  },
  "bmb": {
    "bmad_builder_output_folder": "_bmad-output/skills",
    "bmad_builder_reports": "_bmad-output/reports"
  }
}

Note: Pass the raw user answers (before result template expansion). The script applies result templates and {project-root} expansion when writing.

The script:

  • Creates _bmad/core/config.yaml with core values (if core answers provided)
  • Creates _bmad/{module}/config.yaml with core values + module values (result-expanded)
  • Creates any directories listed in the module.yaml directories array
Step 5: Return vars

After writing, re-run bmad_init.py with the load subcommand (same as the fast path) to return resolved vars. Store returned vars as {var-name} and return them to the calling skill.

© redhat-cop, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in .cursor/skills/bmad-init of redhat-cop/vault-config-operator.

  • SKILL.md
  • resources/core-module.yaml
  • scripts/bmad_init.py
  • scripts/tests/test_bmad_init.py

Open the folder on GitHubat commit 99762c2

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 skillredhat-cop/vault-config-operator167—~1.2kAutomated safety check: PassApache-2.0
Initasgeirtj/system_prompts_leaks69k—~5.5kAutomated safety check: PassCC0-1.0
Initasgeirtj/system_prompts_leaks69k—~602Automated safety check: PassCC0-1.0
Bmad Initaj-geddes/claude-code-bmad-skills487—~1.4kAutomated safety check: NotesCustom licence
Initbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~596Automated safety check: NotesCustom licence
Swarm Initruvnet/ruflo74k—~319Automated safety check: PassMIT

Similar skills

  • Init

    asgeirtj/system_prompts_leaks

    Initialize new CLAUDE.md file(s) and optional skills/hooks with codebase documentation

    69k GitHub stars~5.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Init

    asgeirtj/system_prompts_leaks

    Initialize a new CLAUDE.md file with codebase documentation. An agent skill from asgeirtj/system_prompts_leaks.

    69k GitHub stars~602 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Bmad Init

    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…

    487 GitHub stars~1.4k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: notes
  • Init

    brycewang-stanford/Auto-Empirical-Research-Skills

    Fills all [FILL:] placeholders across the template to initialize a new research project.

    4.5k GitHub stars~596 tokensUpdated 2 days ago
    Auto-check: notes
  • Swarm Init

    ruvnet/ruflo

    Initialize a multi-agent swarm with anti-drift configuration.

    74k GitHub stars~319 tokensUpdated today
    SecurityAuto-check passed
  • Federation Init

    ruvnet/ruflo

    Initialize federation on this node — generate keypair and configure peers

    74k GitHub stars~221 tokensUpdated today
    Auto-check passed

More from redhat-cop/vault-config-operator

All 21 skills in this repo
  • Bmad Bmb Setup

    redhat-cop/vault-config-operator

    Sets up BMad Builder module in a project. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Bmad Eval Runner

    redhat-cop/vault-config-operator

    Run a skill's evals and report results. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Bmad Agent Builder

    redhat-cop/vault-config-operator

    Builds, edits or analyzes Agent Skills through conversational discovery.

    167 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Bmad Workflow Builder

    redhat-cop/vault-config-operator

    Builds, converts, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Bmad Module Builder

    redhat-cop/vault-config-operator

    Plans, creates, and validates BMad modules. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~643 tokensUpdated yesterday
    Auto-check passed
  • Bmad Workflow Builder

    redhat-cop/vault-config-operator

    Builds, edits, and analyzes workflows and skills. An agent skill from redhat-cop/vault-config-operator.

    167 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Questions about Bmad Init

What does Bmad Init do?

Initialize BMad project configuration and load config variables. Bmad Init is an agent skill from redhat-cop/vault-config-operator. Initialize BMad project configuration and load config variables.

When should I use Bmad Init?

Bmad Init fits situations like: any skill needs module-specific configuration values; setting up a new BMad project.

How do I install Bmad Init in Claude Code?

Run `npx skills add redhat-cop/vault-config-operator --skill bmad-init -a claude-code`. Or copy the skill folder (.cursor/skills/bmad-init in redhat-cop/vault-config-operator) 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 redhat-cop/vault-config-operator --skill bmad-init -a codex`. Or copy the skill folder (.cursor/skills/bmad-init in redhat-cop/vault-config-operator) 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 redhat-cop/vault-config-operator --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 Python for the scripts in its folder. Our summary lists: Python 3.

Does Bmad Init access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bmad Init 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. 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 is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bmad Init use?

About 1.2k tokens (SKILL.md is roughly 4.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: Init (asgeirtj/system_prompts_leaks, 69k stars), Init (asgeirtj/system_prompts_leaks, 69k stars), Bmad Init (aj-geddes/claude-code-bmad-skills, 487 stars) and Init (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bmad Init?

redhat-cop (a GitHub organization) maintains it in redhat-cop/vault-config-operator, which has 167 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 7, 2026.

Source: redhat-cop/vault-config-operator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.