Adobe express spectrum ui ux
Skill Sandgrouse/adobe-express-dev-skill/skills/adobe-express-spectrum-ui-ux
Agent Skill for AI coding assistants (Cursor, Copilot, Windsurf, Claude) - Adobe Express add-on development with OAuth patterns and code samples
npx -y skills add Sandgrouse/adobe-express-dev-skill --skill adobe-express-spectrum-ui-uxAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Build or review Adobe Express add-on panel UI with Spectrum patterns, stack selection guidance (raw SWC, swc-react, React Spectrum), Express theme setup, state and navigation design, and actionable UX quality checks. Use when implementing or auditing panel layouts, interaction states, multi-screen flows, and accessibility.
SKILL.md
5.0 KB, as published. Nobody here has run it
Adobe Express Spectrum UI and UX Skill
Build or review panel UI with Adobe Express-native Spectrum patterns, predictable state handling, and clear user feedback.
When to Use This Skill
- Choosing between raw Spectrum Web Components, swc-react, and React Spectrum
- Setting up or fixing Express theme usage (
theme,scale,color) - Designing or refactoring multi-screen panel flows and UI state transitions
- Reviewing loading, empty, disabled, error, and success states
- Auditing UI consistency and accessibility before release
What to Inspect First
- Current UI stack in the repo (raw SWC, swc-react, or React Spectrum)
- Theme imports and panel wrapper (
sp-themeorThemefrom swc-react) - Existing navigation model (single
locationstate, step state, router, or conditional rendering) - Existing feedback patterns (toasts, progress, inline validation, disabled explanations)
Decision Guide
- Prefer raw Spectrum Web Components for non-React or minimal panel surfaces.
- Prefer swc-react for React repos using Spectrum Web Components through React wrappers.
- Use React Spectrum only when the repo already depends on it or there is a strong reason.
- Do not mix multiple Spectrum approaches in one panel unless migration is intentional and scoped.
Workflow
- Confirm the active UI stack and keep consistency with the existing codebase.
- Verify Express theming is applied correctly before changing components.
- Map screen flow and transitions first (home/import/map/apply/settings/status, or equivalent).
- Implement or refine state handling for
idle,loading,empty,error,disabled, andsuccess. - Ensure each long-running action provides clear feedback (progress, busy state, completion, error path).
- Query MCP for component APIs and accessibility behavior before introducing new primitives.
MCP Prompt Patterns
Use explicit prompts so agents fetch official guidance before coding:
- "Use
mcp_adobe-express_get_relevant_documentationsto retrieve Adobe Express UX and implementation guidance for panel UI." - "Use
mcp_adobe-express_get_relevant_documentationsto find Spectrum accessibility guidance for dropdown and keyboard interactions." - "Use
mcp_adobe-express_get_typedefinitionswithapi_type=iframe-uibefore generating panel-side TypeScript code."
If your host supports tagged tool invocation:
#mcp_adobe-express_get_relevant_documentations Spectrum Web Components theme and panel UX guidance#mcp_adobe-express_get_typedefinitions api_type=iframe-ui
Checks
- Do not change UI stack unless there is a clear migration plan.
- Do not ship screens without loading, empty, and failure feedback.
- Do not hide blocked actions without explaining why users cannot proceed.
- Do not couple navigation state to unrelated side effects.
Common Pitfalls
- Mixing React Spectrum and swc-react in the same panel with no clear boundary.
- Missing Express theme imports, resulting in inconsistent typography and component appearance.
- Building multi-step flows without explicit transition rules, causing stale or broken state.
- Showing only toast-level errors for field-level validation problems.
Validation Checklist
- Does the panel follow one clear Spectrum stack strategy?
- Is Express theme configured and visible across screens?
- Are navigation transitions deterministic and reversible where needed?
- Are loading, empty, disabled, and error states visible and actionable?
- Is keyboard and focus behavior acceptable for core actions?
Progressive References
- UI Stack Guide - Raw SWC vs swc-react vs React Spectrum, plus theme rules.
- State and Navigation Patterns - Multi-screen flow and state design patterns (including Bulk Designer style).
- Sample Walkthroughs - Official sample patterns to copy for real panel implementations.
Expected Output
- stack choice rationale
- theme verification notes
- state and navigation plan
- feedback/accessibility checklist
- minimal implementation change plan
Skill Handoffs
Pass to other skills when:
- Architecture questions → adobe-express-core
- Document manipulation triggered from button click → adobe-express-document-manipulation
- OAuth login flow → adobe-express-oauth-authentication
- Paywall or checkout UI → adobe-express-monetization