design-audit

Audits codebases for motion gaps, accessibility violations, performance issues, and design inconsistencies.

1|Updated Jul 19, 2026
One-click install
npx skills add https://github.com/leobbaroni/maestro --skill design-audit-leobbaroni
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-audit
Source: https://github.com/leobbaroni/maestro/tree/main/skills/maestro/library/genjutsu/_jutsu/design-audit
Command: npx skills add https://github.com/leobbaroni/maestro --skill design-audit-leobbaroni

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Animated interfaces often ship with missing exit animations, broken reduced-motion support, inconsistent durations, and layout-thrashing transitions. This Skill provides a systematic, grep-driven audit checklist that detects these issues across web, SwiftUI, and Compose codebases before release. ## Core Features & Use Cases - Motion Gap Detection: Runs targeted grep patterns to find conditional renders without AnimatePresence, hover states without transitions, lists without stagger, and entries without exits. - Accessibility & Performance Audits: Verifies prefers-reduced-motion handlers, focus-visible styles, semantic HTML, aria-hidden on decorative animations, and flags layout-property animations and excessive will-change usage. - Consistency & Stack-Specific Checks: Inventories durations and easings across CSS, SwiftUI, and Compose, then applies platform-specific checklists (Instruments, Macrobenchmark, Lighthouse) and outputs findings grouped by severity. - Use Case: Before shipping a React app with Framer Motion animations, run the audit to catch a missing exit prop, an outline:none without focus replacement, and 14 scattered duration values that should be centralized into motion tokens. ## Quick Start Audit this project's codebase for motion gaps, accessibility violations, and animation performance issues, then report findings grouped by severity.

Frequently Asked Questions about design-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my codebase for missing animations?▼

Run grep patterns that detect conditional renders without AnimatePresence, hover rules without transitions, and .map() lists without stagger delays. Each pattern targets a specific motion gap, and findings are grouped by severity for prioritization.

How to check prefers-reduced-motion support in a project?▼

Grep for prefers-reduced-motion in CSS and JS for web, accessibilityReduceMotion in Swift, and animator scale checks in Kotlin. Zero matches across all three in an animated project is a critical violation requiring a global handler.

Does this audit work with SwiftUI and Jetpack Compose?▼

Yes, the audit includes stack-specific sections for SwiftUI and Compose alongside web. SwiftUI checks use Instruments Time Profiler and Hitches, while Compose checks use Layout Inspector, Macrobenchmark, and Baseline Profiles.

Why is animating width or height a performance problem?▼

Animating layout properties like width, height, top, or margin triggers browser reflow every frame, causing jank. Replace them with transform translate or scale plus opacity, which composite on the GPU without layout recalculation.

When should I use Lottie or Rive instead of native animations?▼

Native APIs like Compose animate*AsState or SwiftUI withAnimation suffice for fades, slides, and springs at zero bundle cost. Justify Lottie (~600-900KB) or Rive (~1.5-2MB) only for complex pre-designed animations like onboarding illustrations.