Skip to content
Skill

audit

by pbakaus

AI Summary

An audit skill that systematically evaluates interface quality across accessibility, performance, theming, and responsive design, generating prioritized reports with severity ratings and actionable recommendations. Ideal for developers and QA teams seeking to identify and document UI/UX issues before fixes are implemented.

Install

# Install all 18 skills from impeccable
mkdir -p .cursor/skills/adapt
&& curl --retry 3 --retry-delay 2 --retry-all-errors -fsSL -o .cursor/skills/adapt/SKILL.md "https://raw.githubusercontent.com/pbakaus/impeccable/main/.claude/skills/adapt/SKILL.md"
&& \

Run in your IDE terminal (bash). On Windows, use Git Bash, WSL, or your IDE's built-in terminal. If curl fails with an SSL error, your network may block raw.githubusercontent.com — try using a VPN or download the files directly from the source repo.

Description

Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations.

Diagnostic Scan

Run comprehensive checks across multiple dimensions: • Accessibility (A11y) - Check for: • Contrast issues: Text contrast ratios < 4.5:1 (or 7:1 for AAA) • Missing ARIA: Interactive elements without proper roles, labels, or states • Keyboard navigation: Missing focus indicators, illogical tab order, keyboard traps • Semantic HTML: Improper heading hierarchy, missing landmarks, divs instead of buttons • Alt text: Missing or poor image descriptions • Form issues: Inputs without labels, poor error messaging, missing required indicators • Performance - Check for: • Layout thrashing: Reading/writing layout properties in loops • Expensive animations: Animating layout properties (width, height, top, left) instead of transform/opacity • Missing optimization: Images without lazy loading, unoptimized assets, missing will-change • Bundle size: Unnecessary imports, unused dependencies • Render performance: Unnecessary re-renders, missing memoization • Theming - Check for: • Hard-coded colors: Colors not using design tokens • Broken dark mode: Missing dark mode variants, poor contrast in dark theme • Inconsistent tokens: Using wrong tokens, mixing token types • Theme switching issues: Values that don't update on theme change • Responsive Design - Check for: • Fixed widths: Hard-coded widths that break on mobile • Touch targets: Interactive elements < 44x44px • Horizontal scroll: Content overflow on narrow viewports • Text scaling: Layouts that break when text size increases • Missing breakpoints: No mobile/tablet variants • Anti-Patterns (CRITICAL) - Check against ALL the DON'T guidelines in the frontend-design skill. Look for AI slop tells (AI color palette, gradient text, glassmorphism, hero metrics, card grids, generic fonts) and general design anti-patterns (gray on color, nested cards, bounce easing, redundant copy). CRITICAL: This is an audit, not a fix. Document issues thoroughly with clear explanations of impact. Use other commands (normalize, optimize, harden, etc.) to fix issues after audit.

Generate Comprehensive Report

Create a detailed audit report with the following structure:

Anti-Patterns Verdict

Start here. Pass/fail: Does this look AI-generated? List specific tells from the skill's Anti-Patterns section. Be brutally honest.

Executive Summary

• Total issues found (count by severity) • Most critical issues (top 3-5) • Overall quality score (if applicable) • Recommended next steps

Quality Score

B

Good

84/100

Standard Compliance75
Documentation Quality72
Usefulness85
Maintenance Signal100
Community Signal100
Scored Today

GitHub Signals

Stars8.4k
Forks328
Issues5
UpdatedToday
View on GitHub

Trust & Transparency

Open Source — Apache-2.0

Source code publicly auditable

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit Today

8.4k stars — Strong Community

328 forks

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code