- Home
- Skills
- Frontend & Web Apps
- UI Design System & A11y Auditor
Works with the AI tools you already use
UI Design System & A11y Auditor
Autonomous design system & A11y engineer. Normalizes arbitrary Tailwind values, enforces design token scales, and fixes WCAG 2.1 AA contrast and interactive states in React/Vue/HTML.
$14
UI Design System & A11y Auditor
Example session with this skill installed
Audit my DashboardCard.tsx. Eliminate arbitrary Tailwind brackets, align to theme tokens, and fix WCAG 2.1 AA contrast for the 'Status' badge and 'Delete' button.
- Read your context and instructions
- Compiled the ui design system
- Generated the UI component
I have audited DashboardCard.tsx. I replaced 4 arbitrary spacing values with standard Tailwind tokens, updated the badge colors to meet 4.5:1 contrast requirements, and refactored the delete action from a div to a semantic button with proper focus states.
Design System & A11y Audit Report
| Category | Issue Found | Resolution |
|---|---|---|
| Tokens | p-[19px], rounded-[11px] | Mapped to p-5 and rounded-xl |
| Contrast | Status badge (2.8:1) | Updated to bg-emerald-100 text-emerald-900 (5.2:1) |
| A11y | Non-semantic Delete trigger | Refactored to <button> with aria-label |
| States | Missing focus rings | Added focus-visible:ring-2 focus-visible:ring-red-500 |
import React from 'react';
export const DashboardCard = ({ title, status, onDelete }) => {
return (
<div className="p-5 bg-white border border-slate-200 rounded-xl shadow-sm">
<div className="flex items-center justify-between mb-4">
<h3 className="text-lg font-semibold text-slate-900">{title}</h3>
<span className="px-2.5 py-0.5 text-xs font-medium rounded-full bg-emerald-100 text-emerald-900">
{status}
</span>
</div>
<div className="flex justify-end gap-3">
<button
type="button"
onClick={onDelete}
aria-label={`Delete ${title}`}
className="inline-flex items-center justify-center p-2 text-slate-500 hover:text-red-600 hover:bg-red-50 rounded-lg transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-red-500 focus-visible:ring-offset-2 disabled:opacity-50"
>
<TrashIcon className="w-5 h-5" aria-hidden="true" />
</button>
</div>
</div>
);
};
Next steps
- Verify the
emerald-900text color aligns with your brand's specific green token. - Run a keyboard tab-through test to ensure the focus ring contrast is visible against your site background.
- Confirm if the delete action requires an
aria-haspopupfor a confirmation modal.
ui-design-system-a11y-auditor.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
The problem
AI-generated code frequently relies on messy arbitrary values like w-[342px] and text-[#1a2b3c]. These hardcoded styles ignore your design system and often lack critical WCAG 2.1 accessibility attributes, focus states, and keyboard navigation.
What it does
- Identifies and maps arbitrary Tailwind or CSS values to your project's nearest design tokens.
- Enforces WCAG 2.1 AA compliance for text contrast, UI component borders, and focus indicators.
- Refactors non-semantic interactive elements into accessible, ARIA-aware components.
- Generates full interactive states including hover, active, focus-visible, and disabled variants.
- Audits responsive consistency using mobile-first breakpoints.
Frameworks & tools
React, Next.js, Vue, Svelte, Tailwind CSS, styled-components, and standard HTML/CSS.
Why this beats prompting it yourself
Standard LLMs often overlook the nuance of WCAG contrast math or the specific ARIA attributes needed for state changes like aria-busy. This skill enforces a structured 5-phase audit that guarantees design token alignment and production-grade accessibility without manual oversight.
Use cases
- Refactoring legacy CSS or arbitrary utility classes into a clean Tailwind design system.
- Patching accessibility debt in existing React or Vue component libraries.
- Ensuring all interactive UI elements meet legal WCAG 2.1 AA requirements.
- Standardizing spacing and typography across a multi-framework frontend repo.
Known limitations
Does not perform runtime testing for complex screen reader compatibility. Requires a tailwind.config.js or CSS theme file for optimal token mapping.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 23 days ago
- Passed all security checks, Safe to install
Needs access to