mockup-graduate

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/SaberAloui/agri-hub --skill mockup-graduate-saberaloui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mockup-graduate
Source: https://github.com/SaberAloui/agri-hub/tree/main/.local/skills/mockup-graduate
Command: npx skills add https://github.com/SaberAloui/agri-hub --skill mockup-graduate-saberaloui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Approved design mockups live in an isolated sandbox with hardcoded data and stubbed behavior, 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 sandbox UI imports to the app's component library. - 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. - Verification and Cleanup: Adds routes, runs the linter, restarts the workflow, and optionally removes the graduated mockup from the sandbox after user confirmation. - Use Case: A user approves variant B of a dashboard mockup on the canvas and says "put this in my app" — the Skill graduates it into the main app with real data fetching, loading states, and routing wired up. ## Quick Start Tell the assistant to graduate the approved mockup variant into your main app and wire it up with real data and routing.

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 the mockup variant and ask to integrate it. The Skill reads the mockup component, analyzes your app's routing, state, and styling patterns, transforms mock data into real data fetching, installs missing dependencies, and verifies the result renders correctly.

How to convert mockup hardcoded data to real API calls?▼

The transformation step maps each hardcoded mock data structure to an API call or data hook matching your app's data-fetching conventions. It also adds loading states, error handling, and empty states that mockups typically omit.

Does mockup graduation work with pnpm workspaces?▼

Yes. Dependencies are installed directly into the target app's package using pnpm --filter, not at the repo root. This ensures the target package's package.json declares its own dependencies correctly.

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

The Skill translates sandbox shadcn/ui imports to your app's actual component library rather than copying imports blindly. If the design systems differ fundamentally, it pauses to confirm the visual translation approach with you first.

Why does my graduated component lose styling compared to the mockup?▼

Visual fidelity loss usually comes from unmapped fonts, missing asset copies, or untranslated styling conventions. The Skill preserves colors, typography, layout, animations, and icons exactly, and copies assets from the sandbox to the app's asset directory.