Skip to content

dvy1987/agent-loom / .agents/skills/design-review

design-review

Verified

Review a built frontend against its chosen direction, catch drift back to generic AI defaults, enforce state coverage, ethical patterns, UX heuristics, and polish, and check contrast with APCA (not the legacy WCAG ratio). Produces specific, prioritized fixes — never vibes-based feedback. Works with pasted screenshots or Playwright MCP automated capture. Load when the user asks to review a UI, audit a design, check if a frontend looks generic or vibecoded, evaluate visual quality or polish, says "review this UI", "is this design good", "audit my frontend", "does this feel like [product]", "design QA", or when frontend-design routes here. Sub-skill of frontend-design.

references/ethical-patterns.md

View on GitHub
# Ethical Patterns Gate

Hard gate for deceptive UI. Based on established dark-pattern taxonomy.
Any single hit = **Ethical patterns FAIL**. Fix before SHIP.

## Checklist (scan every interactive surface)

| Pattern | What to look for | FAIL example |
|---|---|---|
| **Confirm shaming** | Opt-out or decline uses guilt/shame language | "No thanks, I hate saving money" |
| **Mislabeled action** | Button/link label does not match the action it triggers | "Continue" that signs up for paid plan |
| **Hidden cost** | Price, subscription, or commitment revealed only after investment | Free trial → card required with no upfront mention |
| **Forced continuity** | Cancel/unsubscribe is buried, multi-step, or harder than sign-up | Account settings → 4 pages to cancel |
| **Fake urgency** | Countdown, "only X left", or pressure with no verifiable basis | Timer resets on refresh; stock never changes |
| **Privacy zuckering** | Default-opt-in to sharing/data collection; unclear consent | Pre-checked marketing + analytics boxes |
| **Roach motel** | Easy to enter, hard to exit (accounts, subscriptions, data export) | One-click signup, email-only cancellation |

## Agent scan method

1. Read every CTA, modal, banner, checkout step, settings screen, and empty/error state.
2. Trace each primary button to its actual outcome (not its label).
3. Compare sign-up vs cancel flows — exit must not be materially harder than entry.
4. Flag copy that manipulates emotion to override informed consent.

## Fix guidance (in findings)

Name the pattern, cite `file:line`, quote the offending copy, and give the honest replacement.
Example: `PricingModal.tsx:84` — mislabeled action: "Get started" submits payment → rename to "Start paid plan — $29/mo".
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