From 5707012c52d3bc63640a3502a02d0931610e202a Mon Sep 17 00:00:00 2001 From: nicolethoen Date: Fri, 11 Sep 2026 10:35:41 -0400 Subject: [PATCH 1/2] refactor: move mature UXD skills out of workshop --- .claude-plugin/marketplace.json | 10 ++++++ .cursor-plugin/marketplace.json | 10 ++++++ CONTRIBUTING-SKILLS.md | 6 +++- PLUGINS.md | 32 ++++++++++++++++--- README.md | 4 ++- plugins/uxd-assist/agents/eval/eval.yaml | 2 +- plugins/uxd-assist/agents/uxd-assist.md | 9 ++++++ plugins/uxd-design/.claude-plugin/plugin.json | 7 ++++ plugins/uxd-design/.cursor-plugin/plugin.json | 7 ++++ plugins/uxd-design/README.md | 11 +++++++ .../skills/uxd-design-handoff/SKILL.md | 0 .../cases/asks-for-design/annotations.yaml | 0 .../eval/cases/asks-for-design/answers.yaml | 0 .../eval/cases/asks-for-design/input.yaml | 0 .../annotations.yaml | 0 .../answers.yaml | 0 .../fixture-design.md | 0 .../generates-acceptance-criteria/input.yaml | 0 .../cases/prototype-input/annotations.yaml | 0 .../eval/cases/prototype-input/answers.yaml | 0 .../cases/prototype-input/fixture-design.md | 0 .../eval/cases/prototype-input/input.yaml | 0 .../cases/state-enumeration/annotations.yaml | 0 .../eval/cases/state-enumeration/answers.yaml | 0 .../cases/state-enumeration/fixture-design.md | 0 .../eval/cases/state-enumeration/input.yaml | 0 .../skills/uxd-design-handoff/eval/eval.yaml | 2 +- plugins/uxd-research/README.md | 6 +++- .../skills/uxd-discovery/SKILL.md | 0 .../cases/asks-for-input/annotations.yaml | 0 .../eval/cases/asks-for-input/answers.yaml | 0 .../eval/cases/asks-for-input/input.yaml | 0 .../feature-description/annotations.yaml | 0 .../cases/feature-description/answers.yaml | 0 .../eval/cases/feature-description/input.yaml | 0 .../identifies-user-groups/annotations.yaml | 0 .../cases/identifies-user-groups/answers.yaml | 0 .../identifies-user-groups/fixture-jira.md | 0 .../cases/identifies-user-groups/input.yaml | 0 .../eval/cases/jira-input/annotations.yaml | 0 .../eval/cases/jira-input/answers.yaml | 0 .../eval/cases/jira-input/fixture-jira.md | 0 .../eval/cases/jira-input/input.yaml | 0 .../skills/uxd-discovery/eval/eval.yaml | 2 +- plugins/uxd-workshop/README.md | 2 -- 45 files changed, 98 insertions(+), 12 deletions(-) create mode 100644 plugins/uxd-design/.claude-plugin/plugin.json create mode 100644 plugins/uxd-design/.cursor-plugin/plugin.json create mode 100644 plugins/uxd-design/README.md rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/SKILL.md (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/asks-for-design/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/asks-for-design/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/asks-for-design/input.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/fixture-design.md (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/input.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/prototype-input/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/prototype-input/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/prototype-input/fixture-design.md (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/prototype-input/input.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/state-enumeration/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/state-enumeration/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/state-enumeration/fixture-design.md (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/cases/state-enumeration/input.yaml (100%) rename plugins/{uxd-workshop => uxd-design}/skills/uxd-design-handoff/eval/eval.yaml (99%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/SKILL.md (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/asks-for-input/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/asks-for-input/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/asks-for-input/input.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/feature-description/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/feature-description/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/feature-description/input.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/identifies-user-groups/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/identifies-user-groups/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/identifies-user-groups/fixture-jira.md (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/identifies-user-groups/input.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/jira-input/annotations.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/jira-input/answers.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/jira-input/fixture-jira.md (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/cases/jira-input/input.yaml (100%) rename plugins/{uxd-workshop => uxd-research}/skills/uxd-discovery/eval/eval.yaml (99%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 6d0e4ea7..18a44763 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -19,6 +19,16 @@ "source": "./plugins/uxd-assist", "description": "UXD skill routing — discover the right skills for research, design review, and prototyping workflows" }, + { + "name": "uxd-design", + "source": "./plugins/uxd-design", + "description": "UX design workflow — Figma context, design evaluation, and implementation handoff" + }, + { + "name": "uxd-research", + "source": "./plugins/uxd-research", + "description": "UX research pipeline — heuristic evaluation, usability testing, research methodology" + }, { "name": "uxd-workshop", "source": "./plugins/uxd-workshop", diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 084c455f..5ae9d34c 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -14,6 +14,16 @@ "source": "./plugins/uxd-assist", "description": "UXD skill routing — discover the right skills for research, design review, and prototyping workflows" }, + { + "name": "uxd-design", + "source": "./plugins/uxd-design", + "description": "UX design workflow — Figma context, design evaluation, and implementation handoff" + }, + { + "name": "uxd-research", + "source": "./plugins/uxd-research", + "description": "UX research pipeline — heuristic evaluation, usability testing, research methodology" + }, { "name": "uxd-workshop", "source": "./plugins/uxd-workshop", diff --git a/CONTRIBUTING-SKILLS.md b/CONTRIBUTING-SKILLS.md index 09fdf69f..35c65ee7 100644 --- a/CONTRIBUTING-SKILLS.md +++ b/CONTRIBUTING-SKILLS.md @@ -72,8 +72,10 @@ Every skill or agent must live in a plugin. Pick the one that matches your skill patternflyEverything you need for PatternFly development — React components, design guidance, migration, and MCP docs pf-assistPatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits uxd-assistUXD skill routing — discover the right skills for research, design review, and prototyping workflows +uxd-designUX design workflow — Figma context, design evaluation, and implementation handoff`uxd-design-handoff` uxd-prototypeCreate UX prototypes from Jira tickets, Figma designs, or feature descriptions`uxd-prototype-create` -uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows`uxd-design-handoff`, `uxd-discovery`, `uxd-evaluate-design-heuristics` +uxd-researchUX research pipeline — heuristic evaluation, usability testing, research methodology`uxd-discovery` +uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows`uxd-evaluate-design-heuristics`, `uxd-figma-read`, `uxd-prototype-evaluate` pf-a11yAccessibility auditing, reporting, and documentation`pf-a11y-audit`, `pf-a11y-keyboard`, `pf-a11y-test-gen` pf-code-reviewCode review and quality — adversarial review, security patterns`pf-review`, `pf-security-scan` pf-design-auditDesign audit — validate existing code and designs against PatternFly standards`pf-ai-audit`, `pf-color-scan`, `pf-css-token-check` @@ -98,7 +100,9 @@ Plugin names must tell a user exactly what the plugin helps them do. A user brow - `patternfly` — Everything you need for PatternFly development — React components, design guidance, migration, and MCP docs - `pf-assist` — PatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits - `uxd-assist` — UXD skill routing — discover the right skills for research, design review, and prototyping workflows +- `uxd-design` — UX design workflow — Figma context, design evaluation, and implementation handoff - `uxd-prototype` — Create UX prototypes from Jira tickets, Figma designs, or feature descriptions +- `uxd-research` — UX research pipeline — heuristic evaluation, usability testing, research methodology - `pf-a11y` — Accessibility auditing, reporting, and documentation - `pf-code-review` — Code review and quality — adversarial review, security patterns - `pf-design-audit` — Design audit — validate existing code and designs against PatternFly standards diff --git a/PLUGINS.md b/PLUGINS.md index 515b6bfc..d9bcda40 100644 --- a/PLUGINS.md +++ b/PLUGINS.md @@ -7,7 +7,9 @@ Quick reference of all plugins and what they contain. This file is auto-generate - [patternfly](#patternfly) — Everything you need for PatternFly development — React components, design guidance, migration, and MCP docs - [pf-assist](#pf-assist) — PatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits - [uxd-assist](#uxd-assist) — UXD skill routing — discover the right skills for research, design review, and prototyping workflows +- [uxd-design](#uxd-design) — UX design workflow — Figma context, design evaluation, and implementation handoff - [uxd-prototype](#uxd-prototype) — Create UX prototypes from Jira tickets, Figma designs, or feature descriptions +- [uxd-research](#uxd-research) — UX research pipeline — heuristic evaluation, usability testing, research methodology - [uxd-workshop](#uxd-workshop) — UXD team tools and skill incubator — prototyping, research, design review, team workflows - [pf-a11y](#pf-a11y) — Accessibility auditing, reporting, and documentation - [pf-code-review](#pf-code-review) — Code review and quality — adversarial review, security patterns @@ -51,6 +53,18 @@ UXD skill routing — discover the right skills for research, design review, and +
+ +### uxd-design + +UX design workflow — Figma context, design evaluation, and implementation handoff + + + + +
SkillDescriptionEval
uxd-design-handoffProduce an implementation-ready design handoff spec from a validated design.stable
+ +
### uxd-prototype @@ -63,6 +77,18 @@ Create UX prototypes from Jira tickets, Figma designs, or feature descriptions +
+ +### uxd-research + +UX research pipeline — heuristic evaluation, usability testing, research methodology + + + + +
SkillDescriptionEval
uxd-discoveryProduce a structured UX discovery brief from a feature request, Jira issue, or problem statement.stable
+ +
### uxd-workshop @@ -71,8 +97,6 @@ UXD team tools and skill incubator — prototyping, research, design review, tea - - @@ -231,5 +255,5 @@ PatternFly team tools and skill incubation — issue triage, release management, **Eval coverage** -- Consumer: 27/27 (100%) -- Workshop: 5/25 (20%) +- Consumer: 29/29 (100%) +- Workshop: 3/23 (13%) diff --git a/README.md b/README.md index b050afa7..d62cacf2 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![License](https://img.shields.io/github/license/rh-uxd/ai-helpers)](./LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md) -[![Plugins](https://img.shields.io/badge/plugins-12-blueviolet)](./PLUGINS.md) +[![Plugins](https://img.shields.io/badge/plugins-14-blueviolet)](./PLUGINS.md) [![Skills](https://img.shields.io/badge/skills-52-blue)](./PLUGINS.md) [![Agents](https://img.shields.io/badge/agents-7-teal)](./PLUGINS.md) [![skillsaw grade](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Frh-uxd%2Fai-helpers%2Fmain%2F.skillsaw-badge.json)](https://github.com/rh-uxd/ai-helpers/blob/main/.skillsaw-baseline.json) @@ -80,7 +80,9 @@ For MCP server access (component docs and design tokens), also install `pf-mcp`. + + diff --git a/plugins/uxd-assist/agents/eval/eval.yaml b/plugins/uxd-assist/agents/eval/eval.yaml index c131551e..aaa13133 100644 --- a/plugins/uxd-assist/agents/eval/eval.yaml +++ b/plugins/uxd-assist/agents/eval/eval.yaml @@ -68,7 +68,7 @@ judges: return False, f"Non-UXD task got UXD skill invocations: {uxd_skills}" text = outputs.get("conversation", "").lower() uxd_subskills = [ - "uxd-research-heuristic-eval", "uxd-figma-read", + "uxd-research-heuristic-eval", "uxd-discovery", "uxd-design-handoff", "uxd-figma-read", "uxd-evaluate-design-heuristics", "uxd-prototype-create", "uxd-prototype-evaluate", "uxd-prototype-export", "uxd-prototype-publish" diff --git a/plugins/uxd-assist/agents/uxd-assist.md b/plugins/uxd-assist/agents/uxd-assist.md index c6f7f628..38bd4a26 100644 --- a/plugins/uxd-assist/agents/uxd-assist.md +++ b/plugins/uxd-assist/agents/uxd-assist.md @@ -14,6 +14,15 @@ When the user asks about heuristic evaluation, usability assessment, or structur | Skill | What it does | |-------|-------------| | `/uxd-research-heuristic-eval` | Conduct a structured heuristic evaluation grounded in research methodology | +| `/uxd-research:uxd-discovery` | Frame a design problem, user groups, strategic decisions, and constraints | + +## Design — handoff and design artifacts + +When the user is moving from a validated design into implementation, these skills are available: + +| Skill | What it does | +|-------|-------------| +| `/uxd-design:uxd-design-handoff` | Produce an implementation-ready handoff with component mappings, states, interactions, and acceptance criteria | ## Design Review — evaluating designs or Figma artifacts diff --git a/plugins/uxd-design/.claude-plugin/plugin.json b/plugins/uxd-design/.claude-plugin/plugin.json new file mode 100644 index 00000000..dc9338a5 --- /dev/null +++ b/plugins/uxd-design/.claude-plugin/plugin.json @@ -0,0 +1,7 @@ +{ + "name": "uxd-design", + "description": "UX design workflow — Figma context, design evaluation, and implementation handoff", + "author": { "name": "UXD Team" }, + "repository": "https://github.com/rh-uxd/ai-helpers", + "license": "Apache-2.0" +} diff --git a/plugins/uxd-design/.cursor-plugin/plugin.json b/plugins/uxd-design/.cursor-plugin/plugin.json new file mode 100644 index 00000000..dc9338a5 --- /dev/null +++ b/plugins/uxd-design/.cursor-plugin/plugin.json @@ -0,0 +1,7 @@ +{ + "name": "uxd-design", + "description": "UX design workflow — Figma context, design evaluation, and implementation handoff", + "author": { "name": "UXD Team" }, + "repository": "https://github.com/rh-uxd/ai-helpers", + "license": "Apache-2.0" +} diff --git a/plugins/uxd-design/README.md b/plugins/uxd-design/README.md new file mode 100644 index 00000000..70654fd9 --- /dev/null +++ b/plugins/uxd-design/README.md @@ -0,0 +1,11 @@ + + +# UXD Design Plugin + +UX design workflow — Figma context, design evaluation, and implementation handoff. + +## What's Included + +### Skills + +- **UXD Design Handoff** (`/uxd-design:uxd-design-handoff`) — Produce an implementation-ready design handoff spec from a validated design. diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/SKILL.md b/plugins/uxd-design/skills/uxd-design-handoff/SKILL.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/SKILL.md rename to plugins/uxd-design/skills/uxd-design-handoff/SKILL.md diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/annotations.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/annotations.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/answers.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/answers.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/input.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/asks-for-design/input.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/asks-for-design/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/annotations.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/annotations.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/answers.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/answers.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/fixture-design.md b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/fixture-design.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/fixture-design.md rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/fixture-design.md diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/input.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/input.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/generates-acceptance-criteria/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/annotations.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/annotations.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/answers.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/answers.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/fixture-design.md b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/fixture-design.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/fixture-design.md rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/fixture-design.md diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/input.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/prototype-input/input.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/prototype-input/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/annotations.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/annotations.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/answers.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/answers.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/fixture-design.md b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/fixture-design.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/fixture-design.md rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/fixture-design.md diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/input.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/cases/state-enumeration/input.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/cases/state-enumeration/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/eval.yaml b/plugins/uxd-design/skills/uxd-design-handoff/eval/eval.yaml similarity index 99% rename from plugins/uxd-workshop/skills/uxd-design-handoff/eval/eval.yaml rename to plugins/uxd-design/skills/uxd-design-handoff/eval/eval.yaml index de49fcb8..0394b6a7 100644 --- a/plugins/uxd-workshop/skills/uxd-design-handoff/eval/eval.yaml +++ b/plugins/uxd-design/skills/uxd-design-handoff/eval/eval.yaml @@ -3,7 +3,7 @@ description: >- Evaluate uxd-design-handoff component mapping, state enumeration, acceptance criteria traceability, and output structure -skill: uxd-workshop:uxd-design-handoff +skill: uxd-design:uxd-design-handoff execution: mode: case diff --git a/plugins/uxd-research/README.md b/plugins/uxd-research/README.md index ce5694f9..8d566564 100644 --- a/plugins/uxd-research/README.md +++ b/plugins/uxd-research/README.md @@ -4,4 +4,8 @@ UX research pipeline — heuristic evaluation, usability testing, research methodology. -No skills or agents yet. +## What's Included + +### Skills + +- **UXD Discovery** (`/uxd-research:uxd-discovery`) — Produce a structured UX discovery brief from a feature request, Jira issue, or problem statement. diff --git a/plugins/uxd-workshop/skills/uxd-discovery/SKILL.md b/plugins/uxd-research/skills/uxd-discovery/SKILL.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/SKILL.md rename to plugins/uxd-research/skills/uxd-discovery/SKILL.md diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/annotations.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/annotations.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/answers.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/answers.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/input.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/asks-for-input/input.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/asks-for-input/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/annotations.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/annotations.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/answers.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/answers.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/input.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/feature-description/input.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/feature-description/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/annotations.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/annotations.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/answers.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/answers.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/fixture-jira.md b/plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/fixture-jira.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/fixture-jira.md rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/fixture-jira.md diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/input.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/identifies-user-groups/input.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/identifies-user-groups/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/annotations.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/annotations.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/annotations.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/annotations.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/answers.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/answers.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/answers.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/answers.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/fixture-jira.md b/plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/fixture-jira.md similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/fixture-jira.md rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/fixture-jira.md diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/input.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/input.yaml similarity index 100% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/cases/jira-input/input.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/cases/jira-input/input.yaml diff --git a/plugins/uxd-workshop/skills/uxd-discovery/eval/eval.yaml b/plugins/uxd-research/skills/uxd-discovery/eval/eval.yaml similarity index 99% rename from plugins/uxd-workshop/skills/uxd-discovery/eval/eval.yaml rename to plugins/uxd-research/skills/uxd-discovery/eval/eval.yaml index 2c52ab66..a9152480 100644 --- a/plugins/uxd-workshop/skills/uxd-discovery/eval/eval.yaml +++ b/plugins/uxd-research/skills/uxd-discovery/eval/eval.yaml @@ -2,7 +2,7 @@ name: uxd-discovery-eval description: >- Evaluate uxd-discovery brief generation, input handling, and output structure -skill: uxd-workshop:uxd-discovery +skill: uxd-research:uxd-discovery execution: mode: case diff --git a/plugins/uxd-workshop/README.md b/plugins/uxd-workshop/README.md index ba6d8ed4..3463c46b 100644 --- a/plugins/uxd-workshop/README.md +++ b/plugins/uxd-workshop/README.md @@ -8,8 +8,6 @@ UXD team tools and skill incubator — prototyping, research, design review, tea ### Skills -- **UXD Design Handoff** (`/uxd-workshop:uxd-design-handoff`) — Produce an implementation-ready design handoff spec from a validated design. -- **UXD Discovery** (`/uxd-workshop:uxd-discovery`) — Produce a structured UX discovery brief from a feature request, Jira issue, or problem statement. - **UXD Evaluate Design Heuristics** (`/uxd-workshop:uxd-evaluate-design-heuristics`) — Score a design against accessibility, visual hierarchy, content, and state coverage heuristics. - **UXD Figma Read** (`/uxd-workshop:uxd-figma-read`) — Retrieve design context from a Figma file. - **UXD Prototype Evaluate** (`/uxd-workshop:uxd-prototype-evaluate`) — Evaluate a running prototype against a Jira ticket's acceptance criteria, automatically fix what fails, then run persona-based usability walkthroughs. From 92b1b14869394356892476522ddd45b0e9d08e96 Mon Sep 17 00:00:00 2001 From: nicolethoen Date: Mon, 14 Sep 2026 09:00:15 -0400 Subject: [PATCH 2/2] rebase and clean up generated files --- CONTRIBUTING-SKILLS.md | 6 +----- PLUGINS.md | 32 ++++---------------------------- README.md | 4 +--- plugins/uxd-design/README.md | 11 ----------- plugins/uxd-research/README.md | 6 +----- plugins/uxd-workshop/README.md | 2 ++ 6 files changed, 9 insertions(+), 52 deletions(-) delete mode 100644 plugins/uxd-design/README.md diff --git a/CONTRIBUTING-SKILLS.md b/CONTRIBUTING-SKILLS.md index 35c65ee7..09fdf69f 100644 --- a/CONTRIBUTING-SKILLS.md +++ b/CONTRIBUTING-SKILLS.md @@ -72,10 +72,8 @@ Every skill or agent must live in a plugin. Pick the one that matches your skill - - - + @@ -100,9 +98,7 @@ Plugin names must tell a user exactly what the plugin helps them do. A user brow - `patternfly` — Everything you need for PatternFly development — React components, design guidance, migration, and MCP docs - `pf-assist` — PatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits - `uxd-assist` — UXD skill routing — discover the right skills for research, design review, and prototyping workflows -- `uxd-design` — UX design workflow — Figma context, design evaluation, and implementation handoff - `uxd-prototype` — Create UX prototypes from Jira tickets, Figma designs, or feature descriptions -- `uxd-research` — UX research pipeline — heuristic evaluation, usability testing, research methodology - `pf-a11y` — Accessibility auditing, reporting, and documentation - `pf-code-review` — Code review and quality — adversarial review, security patterns - `pf-design-audit` — Design audit — validate existing code and designs against PatternFly standards diff --git a/PLUGINS.md b/PLUGINS.md index d9bcda40..515b6bfc 100644 --- a/PLUGINS.md +++ b/PLUGINS.md @@ -7,9 +7,7 @@ Quick reference of all plugins and what they contain. This file is auto-generate - [patternfly](#patternfly) — Everything you need for PatternFly development — React components, design guidance, migration, and MCP docs - [pf-assist](#pf-assist) — PatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits - [uxd-assist](#uxd-assist) — UXD skill routing — discover the right skills for research, design review, and prototyping workflows -- [uxd-design](#uxd-design) — UX design workflow — Figma context, design evaluation, and implementation handoff - [uxd-prototype](#uxd-prototype) — Create UX prototypes from Jira tickets, Figma designs, or feature descriptions -- [uxd-research](#uxd-research) — UX research pipeline — heuristic evaluation, usability testing, research methodology - [uxd-workshop](#uxd-workshop) — UXD team tools and skill incubator — prototyping, research, design review, team workflows - [pf-a11y](#pf-a11y) — Accessibility auditing, reporting, and documentation - [pf-code-review](#pf-code-review) — Code review and quality — adversarial review, security patterns @@ -53,18 +51,6 @@ UXD skill routing — discover the right skills for research, design review, and
SkillDescriptionEval
uxd-design-handoffProduce an implementation-ready design handoff spec from a validated design.stable
uxd-discoveryProduce a structured UX discovery brief from a feature request, Jira issue, or problem statement.stable
uxd-evaluate-design-heuristicsScore a design against accessibility, visual hierarchy, content, and state coverage heuristics.—
uxd-figma-readRetrieve design context from a Figma file.—
uxd-prototype-evaluateEvaluate a running prototype against a Jira ticket's acceptance criteria, automatically fix what fails, then run persona-based usability walkthroughs.stable
patternflyEverything you need for PatternFly development — React components, design guidance, migration, and MCP docs
pf-assistPatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits
uxd-assistUXD skill routing — discover the right skills for research, design review, and prototyping workflows
uxd-designUX design workflow — Figma context, design evaluation, and implementation handoff
uxd-prototypeCreate UX prototypes from Jira tickets, Figma designs, or feature descriptions
uxd-researchUX research pipeline — heuristic evaluation, usability testing, research methodology
uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows
pf-a11yAccessibility auditing, reporting, and documentation
pf-code-reviewCode review and quality — adversarial review, security patterns
patternflyEverything you need for PatternFly development — React components, design guidance, migration, and MCP docs
pf-assistPatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits
uxd-assistUXD skill routing — discover the right skills for research, design review, and prototyping workflows
uxd-designUX design workflow — Figma context, design evaluation, and implementation handoff`uxd-design-handoff`
uxd-prototypeCreate UX prototypes from Jira tickets, Figma designs, or feature descriptions`uxd-prototype-create`
uxd-researchUX research pipeline — heuristic evaluation, usability testing, research methodology`uxd-discovery`
uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows`uxd-evaluate-design-heuristics`, `uxd-figma-read`, `uxd-prototype-evaluate`
uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows`uxd-design-handoff`, `uxd-discovery`, `uxd-evaluate-design-heuristics`
pf-a11yAccessibility auditing, reporting, and documentation`pf-a11y-audit`, `pf-a11y-keyboard`, `pf-a11y-test-gen`
pf-code-reviewCode review and quality — adversarial review, security patterns`pf-review`, `pf-security-scan`
pf-design-auditDesign audit — validate existing code and designs against PatternFly standards`pf-ai-audit`, `pf-color-scan`, `pf-css-token-check`
-
- -### uxd-design - -UX design workflow — Figma context, design evaluation, and implementation handoff - - - - -
SkillDescriptionEval
uxd-design-handoffProduce an implementation-ready design handoff spec from a validated design.stable
- -
### uxd-prototype @@ -77,18 +63,6 @@ Create UX prototypes from Jira tickets, Figma designs, or feature descriptions -
- -### uxd-research - -UX research pipeline — heuristic evaluation, usability testing, research methodology - - - - -
SkillDescriptionEval
uxd-discoveryProduce a structured UX discovery brief from a feature request, Jira issue, or problem statement.stable
- -
### uxd-workshop @@ -97,6 +71,8 @@ UXD team tools and skill incubator — prototyping, research, design review, tea + + @@ -255,5 +231,5 @@ PatternFly team tools and skill incubation — issue triage, release management, **Eval coverage** -- Consumer: 29/29 (100%) -- Workshop: 3/23 (13%) +- Consumer: 27/27 (100%) +- Workshop: 5/25 (20%) diff --git a/README.md b/README.md index d62cacf2..b050afa7 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![License](https://img.shields.io/github/license/rh-uxd/ai-helpers)](./LICENSE) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md) -[![Plugins](https://img.shields.io/badge/plugins-14-blueviolet)](./PLUGINS.md) +[![Plugins](https://img.shields.io/badge/plugins-12-blueviolet)](./PLUGINS.md) [![Skills](https://img.shields.io/badge/skills-52-blue)](./PLUGINS.md) [![Agents](https://img.shields.io/badge/agents-7-teal)](./PLUGINS.md) [![skillsaw grade](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Frh-uxd%2Fai-helpers%2Fmain%2F.skillsaw-badge.json)](https://github.com/rh-uxd/ai-helpers/blob/main/.skillsaw-baseline.json) @@ -80,9 +80,7 @@ For MCP server access (component docs and design tokens), also install `pf-mcp`. - - diff --git a/plugins/uxd-design/README.md b/plugins/uxd-design/README.md deleted file mode 100644 index 70654fd9..00000000 --- a/plugins/uxd-design/README.md +++ /dev/null @@ -1,11 +0,0 @@ - - -# UXD Design Plugin - -UX design workflow — Figma context, design evaluation, and implementation handoff. - -## What's Included - -### Skills - -- **UXD Design Handoff** (`/uxd-design:uxd-design-handoff`) — Produce an implementation-ready design handoff spec from a validated design. diff --git a/plugins/uxd-research/README.md b/plugins/uxd-research/README.md index 8d566564..ce5694f9 100644 --- a/plugins/uxd-research/README.md +++ b/plugins/uxd-research/README.md @@ -4,8 +4,4 @@ UX research pipeline — heuristic evaluation, usability testing, research methodology. -## What's Included - -### Skills - -- **UXD Discovery** (`/uxd-research:uxd-discovery`) — Produce a structured UX discovery brief from a feature request, Jira issue, or problem statement. +No skills or agents yet. diff --git a/plugins/uxd-workshop/README.md b/plugins/uxd-workshop/README.md index 3463c46b..ba6d8ed4 100644 --- a/plugins/uxd-workshop/README.md +++ b/plugins/uxd-workshop/README.md @@ -8,6 +8,8 @@ UXD team tools and skill incubator — prototyping, research, design review, tea ### Skills +- **UXD Design Handoff** (`/uxd-workshop:uxd-design-handoff`) — Produce an implementation-ready design handoff spec from a validated design. +- **UXD Discovery** (`/uxd-workshop:uxd-discovery`) — Produce a structured UX discovery brief from a feature request, Jira issue, or problem statement. - **UXD Evaluate Design Heuristics** (`/uxd-workshop:uxd-evaluate-design-heuristics`) — Score a design against accessibility, visual hierarchy, content, and state coverage heuristics. - **UXD Figma Read** (`/uxd-workshop:uxd-figma-read`) — Retrieve design context from a Figma file. - **UXD Prototype Evaluate** (`/uxd-workshop:uxd-prototype-evaluate`) — Evaluate a running prototype against a Jira ticket's acceptance criteria, automatically fix what fails, then run persona-based usability walkthroughs.
SkillDescriptionEval
uxd-design-handoffProduce an implementation-ready design handoff spec from a validated design.stable
uxd-discoveryProduce a structured UX discovery brief from a feature request, Jira issue, or problem statement.stable
uxd-evaluate-design-heuristicsScore a design against accessibility, visual hierarchy, content, and state coverage heuristics.—
uxd-figma-readRetrieve design context from a Figma file.—
uxd-prototype-evaluateEvaluate a running prototype against a Jira ticket's acceptance criteria, automatically fix what fails, then run persona-based usability walkthroughs.stable
patternflyEverything you need for PatternFly development — React components, design guidance, migration, and MCP docs
pf-assistPatternFly skill routing — maps project signals to the right PF sub-skills for compliance, migration, and design audits
uxd-assistUXD skill routing — discover the right skills for research, design review, and prototyping workflows
uxd-designUX design workflow — Figma context, design evaluation, and implementation handoff
uxd-prototypeCreate UX prototypes from Jira tickets, Figma designs, or feature descriptions
uxd-researchUX research pipeline — heuristic evaluation, usability testing, research methodology
uxd-workshopUXD team tools and skill incubator — prototyping, research, design review, team workflows
pf-a11yAccessibility auditing, reporting, and documentation
pf-code-reviewCode review and quality — adversarial review, security patterns