{"id":"fe58d7c3-d720-467b-9f48-29cc32665a7e","shortId":"HY64NE","kind":"skill","title":"bmad-orchestrator","tagline":"Orchestrates Codex BMAD workflows. Use for bmad:init, bmad:status, and bmad:next to manage project setup, state tracking, and phase routing.","description":"# BMAD Orchestrator\n\n## Trigger Intents\n\n- `bmad:init`\n- `bmad:status`\n- `bmad:next`\n\n## Workflow Variants\n\n1. `init`\n- Initialize project BMAD artifacts and baseline state.\n\n2. `status`\n- Summarize workflow progress and current phase readiness.\n\n3. `next`\n- Recommend the next workflow intent from current state.\n\n## Inputs\n\n- repository root and target project root\n- existing BMAD files under `bmad/`\n- project level and phase state from YAML artifacts\n\n## Language Guard (Mandatory)\n\nEnforce language selection separately for chat responses and generated artifacts.\n\nChat language (`communication_language`) fallback order:\n\n1. `language.communication_language` from `bmad/project.yaml`\n2. `English`\n\nRules for chat responses:\n\n- Use the resolved chat language for all assistant responses (questions, status updates, summaries, and handoff notes).\n- Do not switch chat language unless the user explicitly requests a different language in the current thread.\n\nArtifact language (`document_output_language`) fallback order:\n\n1. `language.document_output_language` from `bmad/project.yaml`\n2. `English`\n\nRules for generated artifacts:\n\n- Use the resolved artifact language for all generated BMAD documents and structured artifacts.\n- write prose and field values in the resolved document language\n- avoid mixed-language requirement clauses with English modal verbs (for example, `System shall` followed by non-English text)\n- allow English acronyms/abbreviations in non-English sentences (for example, `API`, `SLA`, `KPI`, `OAuth`, `WCAG`)\n- Keep code snippets, CLI commands, file paths, and identifiers in their original technical form.\n\n## Mandatory Reference Load\n\nBefore executing `init`, `status`, or `next`, read `REFERENCE.md` first.\nTreat `REFERENCE.md` as required context for routing, sequencing, and state handling.\n\n## Output Contract\n\n- `bmad/project.yaml`\n- `bmad/workflow-status.yaml`\n- `bmad/sprint-status.yaml`\n- status summary and next-intent recommendation\n\n## Core Workflow\n\n1. Initialize state files and directories (`init`).\n2. Read YAML state and show completion by phase (`status`).\n3. Compute next recommended intent by project level and completion (`next`).\n4. Route to phase skill with explicit handoff context.\n\n## Script Selection\n\nPrimary scripts:\n\n- Init project:\n  ```bash\n  bash scripts/init-project.sh --name \"MyApp\" --type web-app --level 2\n  ```\n- Show status:\n  ```bash\n  bash scripts/show-status.sh bmad/workflow-status.yaml\n  ```\n- Recommend next:\n  ```bash\n  bash scripts/recommend-next.sh bmad/workflow-status.yaml\n  ```\n\nCompatibility wrappers:\n\n- `scripts/check-status.sh` -> wrapper to `show-status.sh`\n- `scripts/validate-config.sh` -> project config structural validation\n\nShared state helpers are in `../bmad-shared/scripts/`.\n\n## Template Map\n\n- `templates/project.template.yaml`\n- Why: orchestrator-owned project config template used by `init-project.sh`.\n\n- `templates/workflow-status.template.yaml`\n- Why: orchestrator-owned workflow status template used by `init-project.sh`.\n\n- `templates/sprint-status.template.yaml`\n- Why: orchestrator-owned sprint status template used by `init-project.sh`.\n\n## Reference Map\n\n- `REFERENCE.md`\n- Must read first for routing logic and orchestration heuristics.\n\n- `resources/workflow-phases.md`\n- Use for phase-level guidance and sequencing.\n\n- `../bmad-shared/workflows.registry.yaml`\n- Use for intent mapping and level-based routing rules.\n\n## Error Handling\n\n- Missing `bmad/workflow-status.yaml` -> recommend `bmad:init`\n- Invalid YAML or missing required fields -> report exact file and key\n- State mismatch across files -> normalize via shared update script\n\n## Handoff Rules\n\nWhen routing to another skill, include:\n\n- project level\n- current phase\n- completed and required workflows\n- expected output artifact path","tags":["bmad","orchestrator","codex","skills","xmm","agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis"],"capabilities":["skill","source-xmm","skill-bmad-orchestrator","topic-agent-skills","topic-agentic-ai","topic-agentic-workflow","topic-agile","topic-ai-coding-agent","topic-ai-skills","topic-analysis","topic-bmad","topic-code-reviews","topic-codex","topic-codex-cli","topic-developer-tool"],"categories":["codex-bmad-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/xmm/codex-bmad-skills/bmad-orchestrator","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add xmm/codex-bmad-skills","source_repo":"https://github.com/xmm/codex-bmad-skills","install_from":"skills.sh"}},"qualityScore":"0.465","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 30 github stars · SKILL.md body (3,811 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T07:01:07.102Z","embedding":null,"createdAt":"2026-04-18T22:22:56.437Z","updatedAt":"2026-05-01T07:01:07.102Z","lastSeenAt":"2026-05-01T07:01:07.102Z","tsv":"'/bmad-shared/scripts':359 '/bmad-shared/workflows.registry.yaml':416 '1':38,105,156,277 '2':47,110,162,284,330 '3':56,294 '4':305 'acronyms/abbreviations':213 'across':447 'allow':211 'anoth':459 'api':221 'app':328 'artifact':43,85,98,149,167,171,180,472 'assist':123 'avoid':191 'base':424 'baselin':45 'bash':320,321,333,334,339,340 'bmad':2,6,10,12,15,26,30,32,34,42,74,77,176,432 'bmad-orchestr':1 'bmad/project.yaml':109,161,265 'bmad/sprint-status.yaml':267 'bmad/workflow-status.yaml':266,336,342,430 'chat':94,99,114,119,135 'claus':196 'cli':229 'code':227 'codex':5 'command':230 'communic':101 'compat':343 'complet':290,303,466 'comput':295 'config':351,368 'context':256,313 'contract':264 'core':275 'current':53,64,147,464 'differ':143 'directori':282 'document':151,177,189 'enforc':89 'english':111,163,198,209,212,217 'error':427 'exact':441 'exampl':202,220 'execut':244 'exist':73 'expect':470 'explicit':140,311 'fallback':103,154 'field':184,439 'file':75,231,280,442,448 'first':251,400 'follow':205 'form':239 'generat':97,166,175 'guard':87 'guidanc':413 'handl':262,428 'handoff':130,312,454 'helper':356 'heurist':406 'identifi':234 'includ':461 'init':11,31,39,245,283,318,433 'init-project.sh':372,383,394 'initi':40,278 'input':66 'intent':29,62,273,298,419 'invalid':434 'keep':226 'key':444 'kpi':223 'languag':86,90,100,102,107,120,136,144,150,153,159,172,190,194 'language.communication':106 'language.document':157 'level':79,301,329,412,423,463 'level-bas':422 'load':242 'logic':403 'manag':18 'mandatori':88,240 'map':361,396,420 'mismatch':446 'miss':429,437 'mix':193 'mixed-languag':192 'modal':199 'must':398 'myapp':324 'name':323 'next':16,35,57,60,248,272,296,304,338 'next-int':271 'non':208,216 'non-english':207,215 'normal':449 'note':131 'oauth':224 'orchestr':3,4,27,365,376,387,405 'orchestrator-own':364,375,386 'order':104,155 'origin':237 'output':152,158,263,471 'own':366,377,388 'path':232,473 'phase':24,54,81,292,308,411,465 'phase-level':410 'primari':316 'progress':51 'project':19,41,71,78,300,319,350,367,462 'prose':182 'question':125 'read':249,285,399 'readi':55 'recommend':58,274,297,337,431 'refer':241,395 'reference.md':250,253,397 'report':440 'repositori':67 'request':141 'requir':195,255,438,468 'resolv':118,170,188 'resources/workflow-phases.md':407 'respons':95,115,124 'root':68,72 'rout':25,258,306,402,425,457 'rule':112,164,426,455 'script':314,317,453 'scripts/check-status.sh':345 'scripts/init-project.sh':322 'scripts/recommend-next.sh':341 'scripts/show-status.sh':335 'scripts/validate-config.sh':349 'select':91,315 'sentenc':218 'separ':92 'sequenc':259,415 'setup':20 'shall':204 'share':354,451 'show':289,331 'show-status.sh':348 'skill':309,460 'skill-bmad-orchestrator' 'sla':222 'snippet':228 'source-xmm' 'sprint':389 'state':21,46,65,82,261,279,287,355,445 'status':13,33,48,126,246,268,293,332,379,390 'structur':179,352 'summar':49 'summari':128,269 'switch':134 'system':203 'target':70 'technic':238 'templat':360,369,380,391 'templates/project.template.yaml':362 'templates/sprint-status.template.yaml':384 'templates/workflow-status.template.yaml':373 'text':210 'thread':148 'topic-agent-skills' 'topic-agentic-ai' 'topic-agentic-workflow' 'topic-agile' 'topic-ai-coding-agent' 'topic-ai-skills' 'topic-analysis' 'topic-bmad' 'topic-code-reviews' 'topic-codex' 'topic-codex-cli' 'topic-developer-tool' 'track':22 'treat':252 'trigger':28 'type':325 'unless':137 'updat':127,452 'use':8,116,168,370,381,392,408,417 'user':139 'valid':353 'valu':185 'variant':37 'verb':200 'via':450 'wcag':225 'web':327 'web-app':326 'workflow':7,36,50,61,276,378,469 'wrapper':344,346 'write':181 'yaml':84,286,435","prices":[{"id":"1b5973f5-f64d-43ed-8702-84ba625cd910","listingId":"fe58d7c3-d720-467b-9f48-29cc32665a7e","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"xmm","category":"codex-bmad-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:22:56.437Z"}],"sources":[{"listingId":"fe58d7c3-d720-467b-9f48-29cc32665a7e","source":"github","sourceId":"xmm/codex-bmad-skills/bmad-orchestrator","sourceUrl":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-orchestrator","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:56.437Z","lastSeenAt":"2026-05-01T07:01:07.102Z"}],"details":{"listingId":"fe58d7c3-d720-467b-9f48-29cc32665a7e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"xmm","slug":"bmad-orchestrator","github":{"repo":"xmm/codex-bmad-skills","stars":30,"topics":["agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis","bmad","code-reviews","codex","codex-cli","developer-tool","openai-codex","product-management","prompt-engineering","software-architecture","workflow"],"license":"other","html_url":"https://github.com/xmm/codex-bmad-skills","pushed_at":"2026-04-20T10:20:30Z","description":"BMAD skills and workflows for OpenAI Codex (App, CLI, Web): intent-based execution, YAML project state, and reusable skill packs for planning, architecture, sprint delivery, development, and code review.","skill_md_sha":"706b19296034bccd37aabe8b14585773d6627e04","skill_md_path":"skills/bmad-orchestrator/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-orchestrator"},"layout":"multi","source":"github","category":"codex-bmad-skills","frontmatter":{"name":"bmad-orchestrator","description":"Orchestrates Codex BMAD workflows. Use for bmad:init, bmad:status, and bmad:next to manage project setup, state tracking, and phase routing."},"skills_sh_url":"https://skills.sh/xmm/codex-bmad-skills/bmad-orchestrator"},"updatedAt":"2026-05-01T07:01:07.102Z"}}