{"id":"4a504ee9-d3a3-4b19-986b-d7fecf8686ec","shortId":"Fz7kC3","kind":"skill","title":"bmad-ux-designer","tagline":"UX design skill for BMAD. Use for bmad:ux-design and bmad:user-flow to define interaction design and accessibility-ready UX artifacts.","description":"# BMAD UX Designer\n\n## Trigger Intents\n\n- `bmad:ux-design`\n- `bmad:user-flow`\n\n## Workflow Variants\n\n1. `ux-design`\n- Create UX specification with states, constraints, and accessibility requirements.\n\n2. `user-flow`\n- Create end-to-end user flow for primary tasks and edge states.\n\n## Inputs\n\n- planning artifacts (`docs/bmad/prd.md` or `docs/bmad/tech-spec.md`)\n- user roles, journeys, and platform constraints\n- accessibility target (WCAG level)\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 `ux-design` or `user-flow`, read `REFERENCE.md` first.\nTreat `REFERENCE.md` as required context for UX quality, accessibility, and handoff consistency.\n\n## Output Contract\n\n- UX spec -> `docs/bmad/ux-design.md`\n- flow definition -> `docs/bmad/user-flow.md`\n\n## Core Workflow\n\n1. Define user goals and key journeys.\n2. Map states, transitions, and interaction rules.\n3. Document responsive behavior and failure states.\n4. Validate accessibility and readability constraints.\n5. Provide implementation handoff constraints.\n\n## Script Selection\n\n- Accessibility checklist:\n  ```bash\n  bash scripts/wcag-checklist.sh\n  ```\n- Responsive breakpoint reference:\n  ```bash\n  bash scripts/responsive-breakpoints.sh\n  ```\n- Color contrast check:\n  ```bash\n  python3 scripts/contrast-check.py '#000000' '#FFFFFF'\n  ```\n\n## Template Map\n\n- `templates/ux-design.template.md`\n- Why: complete UX artifact for implementation handoff.\n\n- `templates/user-flow.template.md`\n- Why: structured user path and decision states.\n\n## Reference Map\n\n- `REFERENCE.md`\n- Must read first for UX workflow guidance and delivery quality.\n\n- `resources/accessibility-guide.md`\n- Use when validating accessibility and semantic behavior.\n\n- `resources/design-patterns.md`\n- Use for common interaction patterns and consistency.\n\n- `resources/design-tokens.md`\n- Use for spacing, typography, and component-level design constraints.\n\n## Quality Gates\n\n- key journeys and edge cases are captured\n- accessibility constraints are explicit and testable\n- responsive behavior is documented\n- design output is directly implementable","tags":["bmad","designer","codex","skills","xmm","agent-skills","agentic-ai","agentic-workflow","agile","ai-coding-agent","ai-skills","analysis"],"capabilities":["skill","source-xmm","skill-bmad-ux-designer","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-ux-designer","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,263 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.431Z","embedding":null,"createdAt":"2026-04-18T22:22:59.484Z","updatedAt":"2026-05-01T07:01:07.431Z","lastSeenAt":"2026-05-01T07:01:07.431Z","tsv":"'000000':334 '1':46,111,162,283 '2':59,116,168,290 '3':297 '4':304 '5':310 'access':27,57,88,269,306,317,371,403 'accessibility-readi':26 'acronyms/abbreviations':219 'allow':217 'api':227 'artifact':30,78,104,155,173,177,186,342 'assist':129 'avoid':197 'bash':319,320,325,326,331 'behavior':300,374,410 'bmad':2,9,12,17,31,36,40,182 'bmad-ux-design':1 'bmad/project.yaml':115,167 'breakpoint':323 'captur':402 'case':400 'chat':100,105,120,125,141 'check':330 'checklist':318 'claus':202 'cli':235 'code':233 'color':328 'command':236 'common':378 'communic':107 'complet':340 'compon':390 'component-level':389 'consist':272,382 'constraint':55,87,309,314,393,404 'context':265 'contract':274 'contrast':329 'core':281 'creat':50,63 'current':153 'decis':352 'defin':22,284 'definit':279 'deliveri':365 'design':4,6,15,24,33,39,49,253,392,413 'differ':149 'direct':416 'docs/bmad/prd.md':79 'docs/bmad/tech-spec.md':81 'docs/bmad/user-flow.md':280 'docs/bmad/ux-design.md':277 'document':157,183,195,298,412 'edg':74,399 'end':65,67 'end-to-end':64 'enforc':95 'english':117,169,204,215,218,223 'exampl':208,226 'execut':250 'explicit':146,406 'failur':302 'fallback':109,160 'ffffff':335 'field':190 'file':237 'first':260,359 'flow':20,43,62,69,257,278 'follow':211 'form':245 'gate':395 'generat':103,172,181 'goal':286 'guard':93 'guidanc':363 'handoff':136,271,313,345 'identifi':240 'implement':312,344,417 'input':76 'intent':35 'interact':23,295,379 'journey':84,289,397 'keep':232 'key':288,396 'kpi':229 'languag':92,96,106,108,113,126,142,150,156,159,165,178,196,200 'language.communication':112 'language.document':163 'level':91,391 'load':248 'mandatori':94,246 'map':291,337,355 'mix':199 'mixed-languag':198 'modal':205 'must':357 'non':214,222 'non-english':213,221 'note':137 'oauth':230 'order':110,161 'origin':243 'output':158,164,273,414 'path':238,350 'pattern':380 'plan':77 'platform':86 'primari':71 'prose':188 'provid':311 'python3':332 'qualiti':268,366,394 'question':131 'read':258,358 'readabl':308 'readi':28 'refer':247,324,354 'reference.md':259,262,356 'request':147 'requir':58,201,264 'resolv':124,176,194 'resources/accessibility-guide.md':367 'resources/design-patterns.md':375 'resources/design-tokens.md':383 'respons':101,121,130,299,322,409 'role':83 'rule':118,170,296 'script':315 'scripts/contrast-check.py':333 'scripts/responsive-breakpoints.sh':327 'scripts/wcag-checklist.sh':321 'select':97,316 'semant':373 'sentenc':224 'separ':98 'shall':210 'skill':7 'skill-bmad-ux-designer' 'sla':228 'snippet':234 'source-xmm' 'space':386 'spec':276 'specif':52 'state':54,75,292,303,353 'status':132 'structur':185,348 'summari':134 'switch':140 'system':209 'target':89 'task':72 'technic':244 'templat':336 'templates/user-flow.template.md':346 'templates/ux-design.template.md':338 'testabl':408 'text':216 'thread':154 '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':293 'treat':261 'trigger':34 'typographi':387 'unless':143 'updat':133 'use':10,122,174,368,376,384 'user':19,42,61,68,82,145,256,285,349 'user-flow':18,41,60,255 'ux':3,5,14,29,32,38,48,51,252,267,275,341,361 'ux-design':13,37,47,251 'valid':305,370 'valu':191 'variant':45 'verb':206 'wcag':90,231 'workflow':44,282,362 'write':187","prices":[{"id":"3d2d844b-67cb-43bb-b0f0-f77538bdcece","listingId":"4a504ee9-d3a3-4b19-986b-d7fecf8686ec","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:59.484Z"}],"sources":[{"listingId":"4a504ee9-d3a3-4b19-986b-d7fecf8686ec","source":"github","sourceId":"xmm/codex-bmad-skills/bmad-ux-designer","sourceUrl":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-ux-designer","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:59.484Z","lastSeenAt":"2026-05-01T07:01:07.431Z"}],"details":{"listingId":"4a504ee9-d3a3-4b19-986b-d7fecf8686ec","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"xmm","slug":"bmad-ux-designer","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":"b85c5b1d37125df17670b819a7c43ee663fee7fd","skill_md_path":"skills/bmad-ux-designer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/xmm/codex-bmad-skills/tree/main/skills/bmad-ux-designer"},"layout":"multi","source":"github","category":"codex-bmad-skills","frontmatter":{"name":"bmad-ux-designer","description":"UX design skill for BMAD. Use for bmad:ux-design and bmad:user-flow to define interaction design and accessibility-ready UX artifacts."},"skills_sh_url":"https://skills.sh/xmm/codex-bmad-skills/bmad-ux-designer"},"updatedAt":"2026-05-01T07:01:07.431Z"}}