mockup-graduate

Transforms approved sandbox mockups into production components matching the main app's conventions.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/AmirEmad11/instabot --skill mockup-graduate-amiremad11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mockup-graduate
Source: https://github.com/AmirEmad11/instabot/tree/main/.local/skills/mockup-graduate
Command: npx skills add https://github.com/AmirEmad11/instabot --skill mockup-graduate-amiremad11

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Approved design mockups live in an isolated sandbox with hardcoded data and stubbed interactions, and manually porting them into the main app risks losing visual fidelity or breaking existing functionality. This Skill automates the graduation process so the approved design ships exactly as reviewed. ## Core Features & Use Cases - Pattern Analysis and Transformation: Reads the approved mockup component, analyzes the main app's routing, state management, styling, and component conventions, then maps mock data to real API calls and app state. - Dependency and Asset Migration: Compares mockup imports against the target package's package.json, installs missing dependencies into the correct workspace package, and copies assets from the sandbox to the app's asset directory. - Routing and Verification: Adds routes for new pages, updates imports for replaced components, runs the linter, and restarts the workflow to confirm correct rendering. - Use Case: A user approves variant B of a dashboard mockup on the canvas and says "use this one" — the Skill graduates it into the main app with real data fetching, loading states, and error handling while preserving the exact visual design. ## Quick Start Tell the assistant to graduate the approved mockup from the sandbox into your main app, for example by saying "I like variant B, integrate it into my app".

Frequently Asked Questions about mockup-graduate

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

FAQPage Schema
How do I move an approved mockup into my main app?

Approve a mockup variant and ask to integrate it, for example by saying "use this one" or "graduate this mockup". The Skill reads the mockup, analyzes your app's patterns, transforms the code, installs dependencies, and verifies the integration.

What parts of a mockup change during production integration?

Static mock data becomes real API calls or state, no-op handlers become router navigation, and stubbed auth becomes real auth context. Visual design, typography, layout, animations, and icons transfer exactly as approved.

Does mockup graduation work in a pnpm monorepo workspace?

Yes. Dependencies are installed into the target app's package directly using pnpm --filter, not at the repo root, so each workspace package's package.json stays correct. Font links are added to the target app's index.html when needed.

What if my app uses a different UI component library than the mockup?

The mockup's shadcn/ui imports are translated to your app's actual component library rather than copied directly. If the design systems differ fundamentally, the Skill pauses to confirm the visual translation approach with you first.

Why does a graduated component need loading and error states?

Mockups only show the happy path with hardcoded data. Production components need skeletons, error messages, empty states, and accessibility attributes like ARIA labels and keyboard navigation to handle real usage.