component-quality-gate

Audits React and Next.js components against accessibility, performance, testing, and TypeScript quality dimensions.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/Scardubu/SwarmXQ --skill component-quality-gate-scardubu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: component-quality-gate
Source: https://github.com/Scardubu/SwarmXQ/tree/main/.ai/skills/component-quality-gate
Command: npx skills add https://github.com/Scardubu/SwarmXQ --skill component-quality-gate-scardubu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? React components often ship with hidden accessibility violations, missing tests, weak TypeScript contracts, and performance anti-patterns that general code review overlooks. This Skill runs a structured six-dimension audit so every component meets production-readiness criteria before release. ## Core Features & Use Cases - Six-Dimension Audit: Checks TypeScript prop contracts, WCAG AA accessibility, render performance, test coverage, Storybook stories, and error/loading state handling. - Corrected Code Output: Produces a fixed version of the component with annotated changes, plus a Vitest/Testing Library test file and a Storybook story file. - Use Case: Paste a TSX button or form component and ask for a production-readiness review; receive an issue-by-issue report with fixes, an axe-based accessibility test, and ready-to-use stories. ## Quick Start Paste your React or TSX component and ask the assistant to audit it for production readiness with corrected code, tests, and Storybook stories.

Frequently Asked Questions about component-quality-gate

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

FAQPage Schema
How do I audit a React component for production readiness?

Paste the TSX or JSX component and request a quality gate review. The audit checks TypeScript props, WCAG AA accessibility, performance patterns, tests, Storybook stories, and error/loading states, then returns issues with fixes and corrected code.

How to write accessibility tests for React components?

Use Vitest with Testing Library and jest-axe to run an axe scan on the rendered component and assert zero violations. The generated test template also covers rendering, user interactions via userEvent, and keyboard navigation checks.

Does the audit support Next.js components?

Yes, the audit covers both React and Next.js components. It checks Next.js-specific patterns such as next/image usage with width, height, and priority attributes, plus lazy loading and avoiding synchronous data fetching in render.

What accessibility issues does a WCAG AA component audit catch?

It catches missing accessible names on interactive elements, color-only information conveyance, suppressed focus rings, incorrect ARIA patterns for dialogs and comboboxes, missing image alt text, and touch targets smaller than 44x44 pixels.

When should I not use a component-level quality gate?

The gate targets individual component review, not full-page or application-level audits. For architecture-wide concerns like routing, state management, or end-to-end flows, use broader design or testing strategy reviews instead.