Skip to content

ericrisco/rsc-harness / skills/ux

Use when an app or SaaS must be easy to use: designing complete user flows, screens and every state, navigation, forms, onboarding, tables, dashboards, search or AI features, or auditing usability and accessibility. Anyone finishes the job without a manual; experts go fast. NOT the visual direction (design), NOT the words (landing-copy).

FileKindSize
SKILL.mdskill md9.3 KB
THIRD_PARTY.mdmarkdown1.6 KB
evals/cases.yamlconfig2.5 KB
references/flows.mdmarkdown7.3 KB
upstream/UPSTREAM.jsonconfig4.7 KB
upstream/ux-designer/GUIDE.mdmarkdown15.2 KB
upstream/ux-designer/LICENSEother1.0 KB
upstream/ux-designer/references/01-core-principles.mdmarkdown7.9 KB
upstream/ux-designer/references/02-laws-of-ux.mdmarkdown8.3 KB
upstream/ux-designer/references/03-accessibility.mdmarkdown10.7 KB
upstream/ux-designer/references/04-visual-design.mdmarkdown8.9 KB
upstream/ux-designer/references/05-information-architecture.mdmarkdown9.1 KB
upstream/ux-designer/references/06-interaction-design.mdmarkdown11.2 KB
upstream/ux-designer/references/07-forms-and-inputs.mdmarkdown11.4 KB
upstream/ux-designer/references/08-mobile-ux.mdmarkdown10.9 KB
upstream/ux-designer/references/09-ux-writing.mdmarkdown9.0 KB
upstream/ux-designer/references/10-user-research.mdmarkdown10.6 KB
upstream/ux-designer/references/11-design-systems.mdmarkdown13.2 KB
upstream/ux-designer/references/12a-presence-awareness.mdmarkdown10.2 KB
upstream/ux-designer/references/12b-conflict-resolution-sync.mdmarkdown15.8 KB
upstream/ux-designer/references/13a-canvas-navigation.mdmarkdown9.5 KB
upstream/ux-designer/references/13b-canvas-objects-performance.mdmarkdown14.2 KB
upstream/ux-designer/references/14-ai-ux-patterns.mdmarkdown20.9 KB
upstream/ux-designer/references/15-ethical-design.mdmarkdown13.9 KB
upstream/ux-designer/references/16-onboarding.mdmarkdown16.5 KB
upstream/ux-designer/references/17-notifications.mdmarkdown17.7 KB
upstream/ux-designer/references/18-data-visualization.mdmarkdown18.8 KB
upstream/ux-designer/references/19-search-ux.mdmarkdown19.0 KB
upstream/ux-designer/references/20-emotional-design.mdmarkdown14.5 KB
upstream/ux-designer/references/21-data-tables.mdmarkdown20.5 KB
upstream/ux-designer/references/22-performance-ux.mdmarkdown17.5 KB
upstream/ux-designer/references/23-internationalization.mdmarkdown15.4 KB
upstream/ux-designer/references/24-voice-and-multimodal.mdmarkdown15.9 KB
upstream/ux-designer/references/25a-barcode-camera-scanning.mdmarkdown21.3 KB
upstream/ux-designer/references/25b-barcode-scanner-workflows.mdmarkdown25.3 KB
upstream/ux-designer/references/25c-barcode-display.mdmarkdown17.3 KB
upstream/ux-usability-foundations/GUIDE.mdmarkdown16.0 KB
upstream/ux-usability-foundations/LICENSEother1.0 KB
upstream/ux-usability-foundations/references/anti-patterns.mdmarkdown8.3 KB
upstream/ux-usability-foundations/references/checklists.mdmarkdown6.2 KB
upstream/ux-usability-foundations/references/decision-prompts.mdmarkdown10.0 KB
upstream/ux-usability-foundations/references/principle-cards.mdmarkdown15.4 KB

upstream/ux-usability-foundations/references/checklists.md

View on GitHub
# Checklists — UX Usability Foundations

## Discovery/context checklist

- [ ] The primary user type is identified.
- [ ] The primary task and success condition are stated.
- [ ] Task frequency is known or reasonably assumed.
- [ ] The user’s likely knowledge level is known.
- [ ] Platform and input methods are known.
- [ ] High-risk actions are identified.
- [ ] Required domain, legal, compliance, or brand terms are identified.
- [ ] Business goals are separated from user goals.
- [ ] Technical constraints are separated from user-facing requirements.
- [ ] The agent has not asked for routine best-practice decisions.

## Core usability quality checklist

- [ ] The screen’s purpose is understandable at a glance.
- [ ] The primary action is easy to find and meaningful.
- [ ] Secondary actions are available but visually quieter.
- [ ] Destructive actions are separated from safe actions.
- [ ] Important controls look interactive without relying on hover.
- [ ] Noninteractive elements do not look clickable/editable.
- [ ] Labels use user language.
- [ ] Ambiguous icons have labels or accessible text.
- [ ] Related items are grouped by proximity, headings, or shared visual treatment.
- [ ] Users are not required to remember prior instructions or hidden state.
- [ ] Users can recognize options at the point of decision.
- [ ] Visible choices are appropriate for the task.
- [ ] Advanced/rare options are progressively disclosed.
- [ ] The system does not ask for information it can infer safely.
- [ ] Empty states explain what is missing and what to do next.
- [ ] Loading states indicate work is happening.
- [ ] Success states make completion clear when the result is not visible.

## Navigation and orientation checklist

- [ ] Users can tell where they are.
- [ ] Users can tell what object/account/context they are editing.
- [ ] The current section/view is visibly marked.
- [ ] Major navigation labels are descriptive and stable.
- [ ] Breadcrumbs or equivalent orientation exist for deep hierarchies.
- [ ] Back behavior preserves useful context.
- [ ] Tabs represent peer sections, not arbitrary actions.
- [ ] Drawers/menus do not hide frequently needed primary actions.
- [ ] Multi-step flows show progress and back/exit rules.
- [ ] Search and filters show active criteria and make clearing easy.

## Forms and data-entry checklist

- [ ] Every input has a persistent label.
- [ ] Placeholder text is not the only label.
- [ ] Required and optional fields are clear.
- [ ] The form asks only for information needed now.
- [ ] Field order follows task order.
- [ ] Input type, autocomplete, inputmode, and constraints match the data.
- [ ] Help text appears before or during entry.
- [ ] Validation is not too early or too late.
- [ ] Error messages are near affected fields.
- [ ] Error messages say what happened and how to fix it.
- [ ] Invalid input remains visible and editable.
- [ ] User-entered data is preserved across errors and interruptions.
- [ ] Submit actions prevent accidental duplicates.
- [ ] Confirmation/review is used for irreversible or consequential submissions.

## Feedback, status, and recovery checklist

- [ ] Every consequential action has immediate feedback.
- [ ] Feedback is proportionate to importance and risk.
- [ ] Routine feedback is quiet.
- [ ] Blocking problems are prominent and persistent.
- [ ] Long operations show progress or background status.
- [ ] Users know whether they can safely continue, retry, cancel, or close.
- [ ] Save/sync/offline states are visible when integrity matters.
- [ ] Undo exists for reversible actions.
- [ ] Confirmations are reserved for irreversible/high-risk actions.
- [ ] Confirmation copy names the object and consequence.
- [ ] Recovery does not require starting over.
- [ ] Support/error codes are secondary to recovery guidance.

## Accessibility checklist

- [ ] Semantic HTML or native controls are used where possible.
- [ ] Buttons are actions; links are navigation.
- [ ] All controls have accessible names.
- [ ] Labels, hints, and errors are associated with controls.
- [ ] Keyboard users can reach and operate all controls.
- [ ] Focus order matches visual/task order.
- [ ] Focus indicators are visible.
- [ ] Dialogs trap and restore focus.
- [ ] Expanded/collapsed/selected/current states are exposed.
- [ ] Async status, validation, and errors are announced appropriately.
- [ ] Color is not the only cue.
- [ ] Text has sufficient contrast and can zoom/reflow.
- [ ] Touch targets support motor variability.
- [ ] Motion respects reduced-motion preferences.
- [ ] Time limits can be paused, extended, or justified.

## Frontend implementation feasibility checklist

- [ ] All UI states are named.
- [ ] Async operations have pending, success, failure, retry, cancel, and offline behavior as relevant.
- [ ] Error handling covers client validation, server validation, permissions, and network failures.
- [ ] Component APIs include labels, descriptions, error text, disabled/read-only reasons, and loading states.
- [ ] Custom components include keyboard interaction specs.
- [ ] State changes update accessible names/roles/states.
- [ ] Routes preserve context where appropriate.
- [ ] Responsive behavior preserves task clarity.
- [ ] Performance supports quick feedback and low interaction latency.

## Critique checklist

- [ ] Issues are ranked by task impact, severity, frequency, and fix effort.
- [ ] Each issue includes evidence from the interface.
- [ ] Each fix explains how it reduces cognitive load, prevents error, or improves recovery.
- [ ] High-risk issues are separated from cosmetic issues.
- [ ] Accessibility issues are treated as product behavior issues.
- [ ] The critique includes quick wins and deeper structural fixes.
- [ ] The critique avoids shaming the original designer/team.

## Final response checklist

- [ ] The recommendation states the likely user goal.
- [ ] The answer gives a clear default.
- [ ] Tradeoffs are explicit.
- [ ] Any necessary user question is specific and includes a recommended default.
- [ ] Accessibility and edge states are covered when relevant.
- [ ] Frontend behavior is specified enough for implementation when relevant.
- [ ] Long copyrighted quotes are avoided.
- [ ] Recommendations are explained in terms of usability, not taste.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall