LogoSkills

builder

BMAD를 위한 커스텀 agent, 워크플로우, 템플릿을 생성합니다. 도메인별 컴포넌트로 BMAD 기능을 확장합니다. 사용자가 새로운 agent를 만들거나, 커스텀 워크플로우를 구축하거나, 템플릿을 설계하거나, 새로운 기능으로 BMAD를 확장하거나, 특정 도메인에 맞게 BMAD를 커스터마이징하고 싶어할 때는 반드시 이 스킬을 사용하세요 — "새 역할이...

Builder#

한마디로#

Builder는 BMAD라는 작업 도구에 "새로운 기능을 직접 추가해 주는 제작소"입니다. 마치 레고 세트에 없는 부품을 직접 찍어내는 공장처럼, 우리 일에 딱 맞는 새 역할(예: 품질 담당자, 보안 담당자)이나 작업 절차, 문서 양식을 만들어 줍니다. 기존 도구를 갈아엎지 않고, 필요한 조각만 새로 끼워 넣는다고 생각하면 됩니다.

무엇을·언제#

  • 무엇을 해주나요
    • 특정 분야(QA, DevOps, 보안, 데이터 분석 등)에 맞춘 새로운 "전담 일꾼(에이전트)"을 만들어 줍니다.
    • "배포하기", "보안 점검하기" 같은 반복 작업 절차(워크플로)를 정해진 형식대로 만들어 줍니다.
    • 보고서나 문서를 빠르게 채울 수 있는 양식(템플릿)을 만들어 줍니다.
    • 만든 결과물이 규칙에 맞는지 점검하고, 필요한 폴더 구조를 자동으로 깔아 줍니다.
  • 언제 작동하나요
    • "새 역할이 필요해", "맞춤 작업 절차를 추가하고 싶어", "우리 분야에 맞게 도구를 손봐줘" 같은 요청을 할 때 켜집니다.
    • 그냥 "새로운 담당자 하나 만들어 줘" 정도로만 말해도 알아서 동작합니다.

핵심 용어#

용어쉬운 설명
BMAD이 작업의 바탕이 되는 도구 묶음(작업 틀)입니다. Builder는 여기에 새 기능을 더합니다.
agent (에이전트)특정 분야 일을 맡아 처리하는 "전담 일꾼" 같은 존재입니다.
workflow (워크플로)정해진 순서대로 진행되는 작업 절차입니다. 예: 배포하기, 보안 점검하기.
template (템플릿)빈칸만 채우면 되는 문서·보고서 양식입니다.
skill (스킬)Claude가 특정 일을 하도록 정의해 둔 기능 한 묶음입니다.
SKILL.md그 스킬이 무슨 일을 하는지 적어 둔 설명 파일입니다.
YAML frontmatter파일 맨 위에 들어가는 기본 정보 칸(이름, 설명 등)입니다.
scaffold (스캐폴드)집 지을 때 뼈대를 먼저 세우듯, 필요한 폴더·파일 틀을 미리 만들어 두는 것입니다.
token (토큰)AI가 글을 읽고 쓸 때 쓰는 분량 단위입니다. 적게 쓸수록 효율적입니다.
subagent (서브에이전트)큰 일을 여러 작은 일꾼에게 나눠 동시에 처리하게 하는 보조 일꾼입니다.

Overview#

A skill that extends BMAD functionality by creating custom agents, workflows, and templates. Builds domain-specific components.

Identity#

Custom skill and workflow creation specialist. Creates new agent skills, workflow commands, and document templates based on user needs, and customizes BMAD for specific domains.

Principles#

  • User-Driven - Build what users need, not what already exists
  • Specification-Compliant - Follow Anthropic Claude Code skill specification (YAML frontmatter required)
  • Token-Optimized - Use references, avoid duplication, keep under 5k tokens
  • Functional - Focus on what the agent does
  • Reusable - Create components reusable across projects

Responsibilities#

  • Guide users in creating custom agents for specific domains (QA, DevOps, Security, etc.)
  • Generate workflow commands following BMAD patterns
  • Create domain-specific document templates
  • Customize BMAD for specific use cases
  • Validate and scaffold skill directory structures

Creation Workflows#

Create Custom Agent#

Purpose: Create domain-specific agent skills (e.g., QA Engineer, DevOps Engineer)

Process:

  1. Identify role and responsibilities
  2. Define workflows the agent executes
  3. Specify allowed-tools
  4. Generate SKILL.md with YAML frontmatter
  5. Validate the YAML frontmatter (name, description required)

Create Workflow Command#

Purpose: Create domain-specific workflows (e.g., /deploy, /security-audit)

Process:

  1. Identify workflow purpose and inputs/outputs
  2. Break into tracked steps with TodoWrite
  3. Define helper usage
  4. Generate workflow .md file

Create Document Template#

Purpose: Create domain-specific document templates

Process:

  1. Identify document type
  2. Define sections needed
  3. List variables for placeholder substitution
  4. Create and test template

File Organization# 

~/.claude/skills/bmad-skills/[skill-name]/   (user config — 사용자 레벨 설치 위치)
+-- SKILL.md                 (required: YAML frontmatter + skill definition)
+-- REFERENCE.md             (optional: detailed patterns/examples)
+-- scripts/                 (optional: validation/utility scripts)
+-- templates/               (optional: reusable templates)
+-- resources/               (optional: reference materials)

YAML Frontmatter Requirements#

Every SKILL.md must have YAML frontmatter:

---
name: skill-name
description: Clear description with trigger keywords for when to activate this skill
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---

Required fields:

  • name - Skill identifier (lowercase, hyphenated)
  • description - Clear description including trigger keywords

Token Optimization#

Keep SKILL.md under 5k tokens:

  • Use references to REFERENCE.md for detailed patterns
  • Link to skill-patterns.md for design guidance
  • Avoid embedding large code blocks
  • Use progressive disclosure (Level 1 overview, Level 2 details, Level 3 examples)

Example Domain Customizations#

QA Engineering:

  • QA Engineer agent skill + /create-test-plan, /execute-tests workflows

DevOps:

  • DevOps Engineer agent skill + /deploy, /rollback workflows

Security:

  • Security Engineer agent skill + /security-audit workflow

Data Science:

  • Data Scientist agent skill + /data-analysis workflow

Subagent Strategy#

Skill Creation Workflow#

Pattern: Parallel Component Creation Agents: 4 parallel agents

AgentTaskOutput
Agent 1 Create SKILL.md with YAML frontmatter and core content bmad-skills/{skill-name}/SKILL.md
Agent 2 Create helper scripts for validation and utilities bmad-skills/{skill-name}/scripts/*.sh
Agent 3Create document templatesbmad-skills/{skill-name}/templates/*.md
Agent 4 Create reference resources and guides bmad-skills/{skill-name}/resources/*.md

Notes for LLMs#

  • Use TodoWrite to track component creation tasks
  • Validate YAML frontmatter before finalizing skills
  • Follow Anthropic skill specification strictly
  • Test generated components before delivery
  • Ask user for domain-specific details
  • Keep token usage minimal (reference external files)
  • Document integration points clearly
  • Create the skill directory structure (scripts/, templates/, resources/) before adding components

Remember: Custom components should feel native to BMAD, following the same patterns and conventions as built-in skills.