{"id":"11cc27d1-186e-433c-b453-fb6ea317e564","shortId":"CRMW7t","kind":"skill","title":"bmad-shared","tagline":"Shared state and template helper skill for BMAD. Provides reusable YAML contracts and deterministic scripts used by orchestrator and phase skills.","description":"# BMAD Shared\n\n## Purpose\n\nProvide shared workflow state contracts and helper scripts for all BMAD skills.\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 shared helper workflows, read `REFERENCE.md` first.\nTreat `REFERENCE.md` as required context for state semantics and update rules.\n\n## Workflow Variants\n\n1. `config-read`\n- Read project or global configuration safely.\n\n2. `status-update`\n- Update workflow state after completion.\n\n3. `next-recommendation`\n- Compute next intent from workflow state.\n\n## YAML Contract Files\n\n- `workflows.registry.yaml`\n- `REFERENCE.md`\n- Shared script semantics and state rules.\n\n- `helpers.md`\n- Shared implementation conventions and migration notes.\n\n## Script Selection\n\nCurrent scripts:\n\n- Read project config:\n  ```bash\n  bash scripts/load-project-config.sh bmad/project.yaml\n  ```\n- Read global config:\n  ```bash\n  bash scripts/load-global-config.sh\n  ```\n- Update workflow state:\n  ```bash\n  bash scripts/update-workflow-status.sh --workflow product_brief --status-file bmad/workflow-status.yaml\n  ```\n- Recommend next workflow:\n  ```bash\n  bash scripts/next-workflow.sh bmad/workflow-status.yaml\n  ```\n\nCompatibility wrappers:\n\n- `scripts/load-config.sh` -> wrapper to `load-project-config.sh`\n- `scripts/update-status.sh` -> wrapper to `update-workflow-status.sh`\n- `scripts/check-phase.sh` -> wrapper to `next-workflow.sh`\n\n## Usage Rules\n\n- prefer `yq` v4+ for all YAML reads and writes\n- keep updates deterministic and idempotent where possible\n- avoid ad-hoc parsing for nested YAML values\n\n## Quality Gates\n\n- YAML contract files remain backward-compatible within this branch\n- scripts return explicit errors for missing files or tools\n- state transitions update metrics and phase status consistently","tags":["bmad","shared","codex","skills","xmm","agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis"],"capabilities":["skill","source-xmm","skill-bmad-shared","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-shared","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 (2,934 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.335Z","embedding":null,"createdAt":"2026-04-18T22:22:58.729Z","updatedAt":"2026-05-01T07:01:07.335Z","lastSeenAt":"2026-05-01T07:01:07.335Z","tsv":"'1':59,110,218 '2':64,116,228 '3':237 'acronyms/abbreviations':167 'ad':336 'ad-hoc':335 'allow':165 'api':175 'artifact':52,103,121,125,134 'assist':77 'avoid':145,334 'backward':350 'backward-compat':349 'bash':272,273,279,280,285,286,298,299 'bmad':2,11,25,38,130 'bmad-shar':1 'bmad/project.yaml':63,115,275 'bmad/workflow-status.yaml':294,301 'branch':354 'brief':290 'chat':48,53,68,73,89 'claus':150 'cli':183 'code':181 'command':184 'communic':55 'compat':302,351 'complet':236 'comput':241 'config':220,271,278 'config-read':219 'configur':226 'consist':371 'context':209 'contract':15,32,248,346 'convent':261 'current':101,267 'determinist':17,329 'differ':97 'document':105,131,143 'enforc':43 'english':65,117,152,163,166,171 'error':358 'exampl':156,174 'execut':198 'explicit':94,357 'fallback':57,108 'field':138 'file':185,249,293,347,361 'first':204 'follow':159 'form':193 'gate':344 'generat':51,120,129 'global':225,277 'guard':41 'handoff':84 'helper':8,34,200 'helpers.md':258 'hoc':337 'idempot':331 'identifi':188 'implement':260 'intent':243 'keep':180,327 'kpi':177 'languag':40,44,54,56,61,74,90,98,104,107,113,126,144,148 'language.communication':60 'language.document':111 'load':196 'load-project-config.sh':307 'mandatori':42,194 'metric':367 'migrat':263 'miss':360 'mix':147 'mixed-languag':146 'modal':153 'nest':340 'next':239,242,296 'next-recommend':238 'next-workflow.sh':315 'non':162,170 'non-english':161,169 'note':85,264 'oauth':178 'orchestr':21 'order':58,109 'origin':191 'output':106,112 'pars':338 'path':186 'phase':23,369 'possibl':333 'prefer':318 'product':289 'project':223,270 'prose':136 'provid':12,28 'purpos':27 'qualiti':343 'question':79 'read':202,221,222,269,276,324 'recommend':240,295 'refer':195 'reference.md':203,206,251 'remain':348 'request':95 'requir':149,208 'resolv':72,124,142 'respons':49,69,78 'return':356 'reusabl':13 'rule':66,118,215,257,317 'safe':227 'script':18,35,253,265,268,355 'scripts/check-phase.sh':312 'scripts/load-config.sh':304 'scripts/load-global-config.sh':281 'scripts/load-project-config.sh':274 'scripts/next-workflow.sh':300 'scripts/update-status.sh':308 'scripts/update-workflow-status.sh':287 'select':45,266 'semant':212,254 'sentenc':172 'separ':46 'shall':158 'share':3,4,26,29,199,252,259 'skill':9,24,39 'skill-bmad-shared' 'sla':176 'snippet':182 'source-xmm' 'state':5,31,211,234,246,256,284,364 'status':80,230,292,370 'status-fil':291 'status-upd':229 'structur':133 'summari':82 'switch':88 'system':157 'technic':192 'templat':7 'text':164 'thread':102 'tool':363 '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' 'transit':365 'treat':205 'unless':91 'updat':81,214,231,232,282,328,366 'update-workflow-status.sh':311 'usag':316 'use':19,70,122 'user':93 'v4':320 'valu':139,342 'variant':217 'verb':154 'wcag':179 'within':352 'workflow':30,201,216,233,245,283,288,297 'workflows.registry.yaml':250 'wrapper':303,305,309,313 'write':135,326 'yaml':14,247,323,341,345 'yq':319","prices":[{"id":"5ce1eb9c-a1cc-49ad-b883-14722e3ed8ec","listingId":"11cc27d1-186e-433c-b453-fb6ea317e564","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:58.729Z"}],"sources":[{"listingId":"11cc27d1-186e-433c-b453-fb6ea317e564","source":"github","sourceId":"xmm/codex-bmad-skills/bmad-shared","sourceUrl":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-shared","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:58.729Z","lastSeenAt":"2026-05-01T07:01:07.335Z"}],"details":{"listingId":"11cc27d1-186e-433c-b453-fb6ea317e564","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"xmm","slug":"bmad-shared","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":"1576a9caf59582d812e9da457d5800d6f7b1de7c","skill_md_path":"skills/bmad-shared/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-shared"},"layout":"multi","source":"github","category":"codex-bmad-skills","frontmatter":{"name":"bmad-shared","description":"Shared state and template helper skill for BMAD. Provides reusable YAML contracts and deterministic scripts used by orchestrator and phase skills."},"skills_sh_url":"https://skills.sh/xmm/codex-bmad-skills/bmad-shared"},"updatedAt":"2026-05-01T07:01:07.335Z"}}