design-audit

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

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Jatinkrmahato993203/crime --skill design-audit-jatinkrmahato993203
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-audit
Source: https://github.com/Jatinkrmahato993203/crime/tree/main/skills/_jutsu/design-audit
Command: npx skills add https://github.com/Jatinkrmahato993203/crime --skill design-audit-jatinkrmahato993203

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Frontend projects accumulate animation, accessibility, and performance defects that are hard to spot manually. This Skill provides a systematic, grep-driven audit checklist that scans a codebase for missing animations, WCAG violations, layout thrashing, and inconsistent motion tokens before shipping. ## Core Features & Use Cases - Motion Gap Analysis: Detects conditional renders without AnimatePresence, hover states without transitions, lists without stagger, and entries without exit animations using targeted grep patterns. - Accessibility Audit: Verifies prefers-reduced-motion handling across Web, SwiftUI, and Compose, checks contrast ratios, focus-visible styles, clickable divs, and aria-hidden on decorative animations. - Performance & Consistency Audit: Flags layout-property animations, excessive will-change, oversized animation libraries, setTimeout-based animation loops, and scattered duration/easing values. - Use Case: Before releasing a React dashboard, run the audit to find that several modals lack exit animations, two buttons use outline:none without focus replacements, and 14 unique duration values need consolidation into motion tokens. ## Quick Start Run the design audit skill against my src directory and report all critical accessibility and motion issues found.

Frequently Asked Questions about design-audit

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

FAQPage Schema
How do I audit a React project 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 remediation.

How to check accessibility compliance in an animated web app?▼

Verify prefers-reduced-motion handling exists somewhere in the codebase, ensure outline:none is paired with :focus-visible styles, and confirm decorative animations use aria-hidden. Tools like pa11y or Lighthouse complement the grep-based checks for contrast ratios.

Does this audit support SwiftUI and Jetpack Compose projects?▼

Yes, the audit includes stack-specific grep patterns for SwiftUI (accessibilityReduceMotion, spring easings) and Compose (isReduceTransitions, FastOutSlowInEasing). It also lists platform tooling like Instruments Hitches and Macrobenchmark for frame-level performance verification.

Why is animating width or height a performance problem?▼

Animating layout properties like width, height, top, or margin triggers browser reflow on every frame, causing jank. Replace them with transform: translate/scale and opacity, which run on the compositor thread without layout recalculation.

When is framer-motion too heavy for a project?▼

Framer Motion adds roughly 30KB gzipped, which is excessive if the project only uses simple fades and slides. In those cases CSS transitions or a smaller library like popmotion (~5KB) achieve the same result at lower bundle cost.