bmad-customize

Author TOML override files to customize BMad agents and workflows.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/peshay/portfolixir --skill bmad-customize-peshay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-customize
Source: https://github.com/peshay/portfolixir/tree/main/.claude/skills/bmad-customize
Command: npx skills add https://github.com/peshay/portfolixir --skill bmad-customize-peshay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to customize BMad skills by providing overrides for installed skills, enabling users to tailor the behavior of BMad agents and workflows to their specific needs.

Core Features & Use Cases

  • Customization Overrides: Authors and updates customization overrides for installed BMad skills.
  • Intent Classification: Classifies user intent into directed, exploratory, audit/iterate, or cross-cutting.
  • Discovery and Routing: Discovers and routes user requests to the appropriate BMad skill and customization surface.
  • Override Composition: Composes and writes TOML override files for agents and workflows.
  • Team and User Placement: Places overrides in the appropriate team or user directory.
  • Verification: Verifies the correctness of the overrides and provides a summary of changes.

Quick Start

Use the bmad-customize skill to customize the behavior of a BMad agent or workflow by providing the specific changes you want to make.

Frequently Asked Questions about bmad-customize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize BMad agent and workflow behavior for my project?

You can customize BMad agent and workflow behavior by authoring TOML override files that specify your required behavioral changes. The system classifies your intent and routes the request to compose and write the appropriate TOML overrides in the correct team or user directory.

What is the best way to override default BMad workflow configurations?

The best way to override default BMad workflow configurations is by creating TOML override files tailored to your specific requirements. This approach allows you to apply targeted modifications to installed skills without altering the base system directly.

Do I need access to the project root directory to apply BMad customization overrides?

Yes, you need access to the project root directory to apply BMad customization overrides. The system places the generated TOML override files in the appropriate team or user directories within the project structure to ensure correct discovery and routing.

Can I verify the correctness of TOML override files for BMad agents?

Yes, the customization system verifies the correctness of TOML override files for BMad agents after composing them. It provides a summary of changes, ensuring your overrides accurately tailor the workflow or agent behavior before finalizing the update.

How does intent classification work when tailoring BMad skills?

Intent classification for tailoring BMad skills works by sorting user requests into directed, exploratory, audit/iterate, or cross-cutting categories. This classification drives the discovery and routing process to apply the correct customization surface for your overrides.

Why should I use TOML files to modify BMad agents instead of direct configuration edits?

Using TOML override files to modify BMad agents isolates your specific changes from the base installation, preventing conflicts during updates. This method composes structured overrides that the system can automatically discover, route, and verify for correctness.