mcpField
U
ux-quality-perspective

ux-quality-perspective

github.com/naodengTesting & quality28542 installsUpdated today
Repository

About ux-quality-perspective

ux-quality-perspective is a skill for assessing user experience evidence across product quality stages. It emphasizes evidence-based findings, applicability checks, and clear boundaries against unsupported implementation or release claims.

Key features

  1. 01Eight supported quality stages
  2. 02Stage-specific prompt selection
  3. 03Conditional applicability checks
  4. 04Evidence-based UX reporting
  5. 05Finding provenance and action links

Use cases

  1. 01Reviewing requirements for UX evidence gaps
  2. 02Assessing UI-related test strategies or reviews
  3. 03Turning prototype or test evidence into UX risks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill ux-quality-perspective

After installing, type/ux-quality-perspectivein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-code-review.yaml
basic-requirements-analysis.yaml
basic-test-case-review.yaml
basic-test-case-writing.yaml
basic-test-strategy-review.yaml
basic-test-strategy.yaml
edge-no-prototype.yaml
edge-not-applicable.yaml
edge-role-boundary.yaml
edge-role-conflict.yaml
edge-unsupported-stage.yaml
review-test-report-review-experience.yaml
review-test-reporting-experience.yaml
prompts/
code-review.md
requirements-analysis.md
test-case-review.md
test-case-writing.md
test-report-review.md
test-reporting.md
test-strategy-review.md
test-strategy.md

Details

From the project README

UX Quality Perspective (English)

Chinese version: See the corresponding Chinese skill.

When to Use

  • A quality stage needs a UX perspective on information architecture, interaction states, consistency, responsive behavior, or accessibility.
  • Product, design, engineering, and QA need to turn UI, prototype, user-flow, or UI-test evidence into actionable experience risk decisions.

Inputs

  • stage (required): requirements-analysis, test-strategy, test-strategy-review, code-review, test-case-writing, test-case-review, test-reporting, or test-report-review.
  • Supplied evidence such as prototypes, screenshots, UI descriptions, design specifications, user flows, change materials, test assets, or reports.
  • Optional context: target users, devices/breakpoints, assistive technology, design system, release scope, and known constraints.

Workflow

  1. Validate stage. If missing or unsupported, return Not applicable, name the supported stages, and request a valid value; do not generate filler findings.
  2. Load and follow exactly one prompt from the table for the valid stage; never combine prompts from multiple stages.
  3. Decide applicability from the supplied material first. test-strategy, test-strategy-review, code-review, test-case-writing, and test-reporting are conditional participation: analyze only when traceable UI/UX impact or relevant experience evidence exists. Otherwise return Not applicable with the reason, known facts, gaps, and material required to reassess; do not write filler findings.
  4. requirements-analysis remains applicable without a prototype: report only confirmed requirement facts, UX evidence gaps, questions, and needed prototype/flow/state material; never invent screens, states, copy, or cross-device behavior.
  5. Produce a standalone UX quality report that separates facts, evidence, inferences, and unverified items.
stageOnly prompt to load
requirements-analysisprompts/requirements-analysis.md
test-strategyprompts/test-strategy.md
test-strategy-reviewprompts/test-strategy-review.md
code-reviewprompts/code-review.md
test-case-writingprompts/test-case-writing.md
test-case-reviewprompts/test-case-review.md
test-reportingprompts/test-reporting.md
test-report-reviewprompts/test-report-review.md

UX Responsibilities and Boundaries

  • Focus on information architecture, navigation, discoverability, interaction feedback and states, consistency, responsive behavior, and accessibility, using only supplied UX/UI evidence.
  • When prototypes, flows, states, breakpoints, or assistive-technology evidence are absent, mark them unknown or needing confirmation; never invent screens, controls, copy, error states, device behavior, or test results.
  • Do not replace frontend/backend implementation review, API reliability or security assessment, test execution, or release approval. Without their evidence, do not assert implementation correctness, API reliability, security, passed tests, or release readiness.

Report Contract

Unless returning Not applicable, every report contains, in order: Summary, Facts, Evidence, Findings, Risks, Information gaps, Questions, Actions, Confidence. Prioritize findings, risks, and actions by impact; state each conclusion's evidence basis and accountable role.

Pre-delivery Checklist

  • The stage is valid and exactly one matching prompt was loaded
  • Applicability was assessed first; non-applicable conditional stages contain no filler findings
  • Requirements analysis without a prototype reports evidence gaps only and does not invent UI
  • The report separates facts, evidence, inferences, and gaps and includes every contract field
  • It does not exceed UX boundaries with implementation, API, security, test, or release claims

Progressive Disclosure

  • Only after validating stage, read the one corresponding file in prompts/.
  • For evaluation or regression, use evals/ and run skill-up validation; do not treat eval cases as project evidence.

Common Pitfalls

  • Do not present a generic UX checklist as a proven defect in this product.
  • Do not compensate for an absent prototype by inventing screens, states, or mobile behavior.
  • Do not turn UX review into unsupported implementation-correctness, API-reliability, or release conclusions.

Report provenance

Keep the selected stage, a stable source_id, and supplied version in the report header. If a source ID is absent, declare a temporary local locator; if version is absent, write unknown rather than inventing it. Each finding has a stable finding_id, its source/evidence locator and status. Each action links its finding and specifies the evidence that would close it; owner, date and action status stay unknown unless supplied. These are standalone report fields, not a dependency on another Skill.

Optional experience evidence matrix

When project material selects these dimensions, record input method × device/breakpoint × assistive technology × UI state, with source/version and observed result or NOT_RUN/unknown per cell. Do not assume every combination applies, prescribe unsupplied devices, or mark an unobserved cell passed. A screenshot supports its visible cell; keyboard, screen-reader, mobile and recovery claims require their own evidence.

Comments

Markdown supported