component-quality-gate

Validates design-system components against a 35-item spec, code, stories, and ship checklist before merge.

5|9|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/ajenchen/design-system --skill component-quality-gate-ajenchen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: component-quality-gate
Source: https://github.com/ajenchen/design-system/tree/main/.agents/skills/component-quality-gate
Command: npx skills add https://github.com/ajenchen/design-system --skill component-quality-gate-ajenchen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? New or refactored components often enter a design system with drifted specs, inconsistent token usage, incomplete stories, or unverified visual and UX behavior. This Skill enforces a pre-merge quality gate so no half-finished component reaches packages/design-system/src/components/. ## Core Features & Use Cases - Four-phase checklist review: Walks a 35-item checklist covering Spec (12 items), Code (13 items), Stories (6 items), and Ship (4 items), with fail-closed routing when any item fails. - Mandatory six-dimension audit: Chains visual, performance, UX, and design-principle audits (including npm run visual-audit, tsc -b, and story canonical-drift checks) before sign-off. - Use Case: Before merging a new DatePicker component into the design system, run the gate to verify its spec rationale, cva variants, token discipline, Storybook stories, TypeScript build, and visual audit all pass, then receive a signed receipt summarizing each phase. ## Quick Start Ask the assistant to run the component quality gate on your finished component, for example by saying "this component is done, check if it is ready to merge into the design system".

Frequently Asked Questions about component-quality-gate

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

FAQPage Schema
How do I check if a design system component is ready to merge?

Run the component quality gate, which walks a 35-item checklist across four phases: Spec, Code, Stories, and Ship. Every item must pass, including visual, performance, and UX audits, before the component receives a signed receipt for merge.

What does a design system component review checklist cover?

It covers spec quality (positioning, prop rationale, edge cases), code conventions (cva variants, design tokens, ARIA, data attributes), Storybook story completeness, and ship gates like TypeScript compilation and visual audits.

When should I skip the component quality gate?

Skip it only for minor changes like typo fixes or single bug fixes, which are handled by spec sync hooks. Pure spec text edits with no tsx, token, cva, or style changes can also skip the six-dimension audit phase.

Why does the quality gate fail on TypeScript checks?

The gate requires `npx tsc -b` to pass without errors and forbids `--noEmit`, because the root tsconfig uses `files: []` which silently passes. Type surface changes also require running the library build.

Can the quality gate pass with visual audit violations?

No. The visual audit layer is fail-closed: any contrast or geometry violation blocks the merge until fixed. The gate never silently releases a component with unresolved visual findings.