kitchen-sink-design-system
Script-First design system workflow. Uses a deterministic auditor script to detect frameworks, inventory components, and detect design drift (hardcoded hex, arbitrary Tailwind). Provides a clear report for the agent to judge and implement a Kitchen Sink page.
How do I install this agent skill?
npx skills add https://github.com/genericservice/claude-skills --skill kitchen-sink-design-systemIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a deterministic workflow and automated scripts for auditing design systems, identifying UI component inventory, and detecting styling inconsistencies. It promotes best practices such as semantic tokens, accessibility auditing, and consistent documentation. No security risks or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Kitchen Sink Design System
Build every component for real, wire it into a single sink page, and let the page prove the design system works.
This workflow uses a Script-First approach: an auditor script handles the "labor" of crawling the codebase and identifying drift, leaving the agent to handle the "judgment" of fixing components and assembling the sink.
Usage
When asked for a Kitchen Sink page, Design System Audit, or Component Inventory:
-
Run the auditor script:
python3 ~/.agents/skills/kitchen-sink-design-system/scripts/audit_design_system.py \ --root "." \ --out "design_audit.json" -
Read the report: Load
design_audit.jsonto see:- Detected framework (Next.js, Astro, etc.).
- Inventory of existing components.
- Design Drift Report: Hardcoded hex values and arbitrary Tailwind values (
-[...]) found in component files. - Checklist Gap: Tier 1 primitives (Button, Card, etc.) missing from the codebase.
-
Establish/Adopt:
- If a guide exists: Map discovered tokens to the guide.
- If no guide exists: Propose a
design-tokens.mdbased on de-facto tokens found in the drift report.
Phase 1: Build & Fix Components
For every MISSING item or file with DRIFT:
- Refactor to use semantic design tokens.
- Apply the base + variant pattern (CVA for React, Props for Astro).
- Wire into the sink page immediately.
Phase 2: Assemble Sink Page
Create the sink route (e.g., app/sink/page.tsx or src/pages/sink.astro) following the standard section order:
- Header & Franchise declaration
- Design Tokens visualization
- Voice & Tone
- Illustration Gallery (via omni-image)
- Component categories (Typography, Buttons, Forms, etc.)
Phase 3: Verify
pnpm build
pnpm lint
pnpm dlx @axe-core/cli http://localhost:3000/sink
Anti-patterns (The "Hot Take" List)
- Agent labor: Don't manually
grepfor hex codes; use the script. - Draft placeholders: Build real components or nothing.
- Arbitrary values:
w-[37px]is a failure of the design system. - Count drift: Deriving counts from collections, not hardcoding strings.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/genericservice/claude-skills/kitchen-sink-design-system">View kitchen-sink-design-system on skillZs</a>