cerramos-component-builder

Builds shared design-system components with Storybook coverage and page integration for Cerramos interfaces.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Ssrrb/cerramos-codebase --skill cerramos-component-builder-ssrrb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cerramos-component-builder
Source: https://github.com/Ssrrb/cerramos-codebase/tree/main/skills/cerramos-component-builder
Command: npx skills add https://github.com/Ssrrb/cerramos-codebase --skill cerramos-component-builder-ssrrb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a requested page, form, modal, or dashboard section into production UI often leads to duplicated app-local components, missing Storybook coverage, and schemas that drift from the interface. This Skill enforces a repeatable workflow that keeps shared components, stories, page composition, and API contracts aligned. ## Core Features & Use Cases - Atomic Interface Breakdown: Decomposes any UI request into field shells, controls, labels, validation states, empty states, and async states before writing code. - Three-Layer Delivery: Places reusable primitives in packages/design-system/components, composed sections where fields travel together, and thin page wiring in apps/app. - Storybook and Schema Alignment: Adds stories for every new shared component plus a composed happy-path story, and updates Zod schemas and API routes before wiring submission. - Use Case: When asked to build a merchant onboarding form, the Skill inspects the existing route, creates shared field components, adds Storybook stories, aligns the Zod schema and API route, then composes the page in apps/app. ## Quick Start Ask the agent to use the cerramos-component-builder workflow to turn a requested settings form into shared design-system components with Storybook stories and a wired page in apps/app.

Frequently Asked Questions about cerramos-component-builder

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

FAQPage Schema
How do I turn a UI request into shared design-system components?▼

Break the interface into atomic elements such as field shells, controls, labels, validation states, and empty states first. Then build shared primitives in packages/design-system/components, add Storybook stories, and compose the page in apps/app with thin data wiring.

How should Storybook stories be structured for new shared components?▼

Add one story per new shared field component plus at least one composed happy-path story for the integrated section or form. Stories live in apps/storybook and serve as the visual workshop for the design system.

When should a component live in the design system versus the app?▼

Reusable fields and composed sections that travel together belong in packages/design-system/components. The app layer in apps/app should stay thin, handling only data loading, form wiring, submission, server error mapping, and navigation refresh.

Does this workflow handle schema and API contract changes?▼

Yes, the workflow reviews or updates the page-level Zod schema and API route before wiring submission whenever the interface changes persisted data shape. This keeps the UI contract aligned with stored data.

What are the limitations of this component-building workflow?▼

It assumes the Cerramos monorepo structure with apps and packages boundaries and App Router conventions. It prefers incremental refactors over parallel systems, so it is not suited for greenfield redesigns outside this workspace.