new-component

Guides creation of design-system components through a six-phase workflow with checkpoints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a new design-system component from scratch often means assembling scattered rules from documentation, which leads to missed conventions, wrong layout-family choices, and inconsistencies discovered only at review time. This Skill provides a create-phase workflow that applies all design-system discipline while the component is being built, not after. ## Core Features & Use Cases - Six-phase guided workflow: sibling spec reading, Layout Family classification, 7-dimension spec.md authoring, tsx implementation with cva and tokens, three story files, and a self quality-gate exit check. - Checkpoints and receipts: positioning receipts and conditional P2H decisions prevent ambiguous naming or scope from proceeding silently. - Automatic chaining: hands off to the component-quality-gate skill for a 35-item review and visual audit before merge. - Use Case: When you say "create a new StatusChip component", the workflow walks through reading sibling specs like Tag and Badge, declaring its Layout Family, writing the spec, implementing the tsx, and producing showcase, anatomy, and principles stories. ## Quick Start Ask the assistant to create a new design-system component, for example by saying "create a new StatusChip component", and it will walk through the six-phase workflow.

Frequently Asked Questions about new-component

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

FAQPage Schema
How do I create a new design-system component from scratch?

Invoke this workflow with the component name and purpose. It walks through six phases: reading 2-3 sibling component specs, classifying the Layout Family, writing a 7-dimension spec.md, implementing the tsx with cva and tokens, writing three story files, and running a self quality-gate.

What is the difference between new-component and component-quality-gate?

new-component is a create-phase workflow that guides you while building a component from scratch. component-quality-gate is a review-phase gate that validates a finished component against a 35-item checklist. new-component chains into the quality-gate as its final phase.

When should I not use the new-component workflow?

Do not use it for modifying existing components, adding small variants or size props, refactoring existing components, or prototype exploration UI. Those cases go through the quality-gate review or the prototype skill instead.

What stories are required for a new React component?

Three story files are required: a showcase stories file with real business scenarios, an anatomy stories file with Overview, SizeMatrix, ColorMatrix, StateBehavior, and Inspector, and a principles stories file with usage guidance. Traits declared in the spec frontmatter determine the required core stories.

Why does the workflow require reading sibling component specs first?

Reading 2-3 sibling specs prevents inventing patterns that conflict with existing conventions. It surfaces the Layout Family declaration, API surface, forbidden patterns, and SSOT anchors, and produces a primitive coverage table mapping each anatomy section to an existing primitive.