component-architect

Design React component APIs and generate TypeScript interfaces from briefs.

7|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/kaelig/react-craft --skill component-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: component-architect
Source: https://github.com/kaelig/react-craft/tree/main/react-craft/skills/component-architect
Command: npx skills add https://github.com/kaelig/react-craft --skill component-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of translating design specifications into robust, well-structured React component architectures, ensuring API ergonomics, composability, and maintainability.

Core Features & Use Cases

  • API Design: Defines TypeScript prop interfaces, prioritizing discriminated unions and compound components.
  • File Structure: Outlines the optimal file organization for components.
  • Composition Strategy: Determines how components will be built and interact.
  • Library Recommendation: Suggests suitable third-party libraries for complex components, checking against banned dependencies.
  • Use Case: When a designer provides a brief for a new complex UI element like a date picker, this Skill generates the TypeScript interfaces, file structure, and composition strategy needed for development.

Quick Start

Generate the architecture for a new 'UserProfileCard' component based on the provided design brief.

Frequently Asked Questions about component-architect

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

FAQPage Schema
How do I design React component APIs from a design brief?

Designing React component APIs from a brief involves generating TypeScript prop interfaces, defining composition strategies, and outlining file structures. This process prioritizes API ergonomics, composability, and strict prop naming conventions for maintainability.

What is the best way to structure TypeScript interfaces for complex React components?

The best way to structure TypeScript interfaces for React components uses strict rules for discriminated unions, compound components, and readonly types. This approach ensures API ergonomics and safe composability for complex UI elements.

When do I need headless UI libraries for React component architecture?

You need headless UI libraries like Radix, React Aria, or Headless UI for complex React components like date pickers. They are recommended during architecture generation after checking your project requirements against banned dependencies.

Can I generate a file structure and composition strategy for a new React component?

Yes, you can generate an optimal file structure and composition strategy for a React component. The architecture output defines how components interact and are organized, written directly to a specific documentation path.

Does this React API design approach work without external dependencies?

This React API design approach works without external dependencies to define your core architecture. It only recommends libraries like Radix or React Aria for complex components after verifying none are banned in your environment.