# Design screen

> Have your agent design a screen in your Figma file from the kit, built from kit blocks and components, bound to your variables and brand mode, with a dark version next to it.

## Before you start

This skill changes your Figma file. It needs Figma's remote MCP server, edit access to the file and a Figma plan that lets agents write to files. The file has to contain the [Figma kit](https://pro.shadcn.co/docs/figma-kit) or use it as a library. See [Skills that write to Figma](https://pro.shadcn.co/docs/agent-skills/setup#skills-that-write-to-figma).

## Usage

### Save a version

In Figma, choose **File → Save to version history**. The agent can't do this for you, and it's your way back.

### Copy a link to the file

Copy the link to your copy of the kit, or to a file that uses the kit as a library. To choose the page the screen goes on, open that page first, or right-click a frame on it and choose **Copy link to selection**.

### Run the skill

Describe the screen and give the agent your real content: the product, the copy, the plans and prices.

```text title="Prompt"
/shadcnpro-design-screen https://figma.com/design/abc123/Kit

A pricing page for Acme, a time tracker for agencies. Three plans: Free, Team at $12 per seat and Business at $29 per seat. Use the Acme mode, and add a dark version.
```

### Approve the plan

The agent lists the sections with the kit block or components it will use for each, and waits for your yes before it changes the file.

### Review the frames

The agent reports links to the frames it built, the text it wrote itself and the placeholders that are still in.

## What the skill does

1. Finds the kit in the file or among its libraries, and reads the pages and the variable collections.
2. Plans the screen with you: the sections, the frame width, the brand mode, and where it goes.
3. Finds the blocks and components for each section, and looks at the finalists before it chooses.
4. Builds the screen in a new frame next to what is already there.
5. Fills in your content through the components' text properties.
6. Reads the result back to find any layer that isn't bound to a variable or a text style, and fixes it.
7. Takes a screenshot, corrects what's off, and adds the dark version if you asked for one.

## What you get

An ordinary frame you can keep editing:

- **Blocks and components are instances** of the kit, so the frame follows the kit and your library updates.
- **Colors, radius and text are bound** to the kit's variables and text styles. There are no loose hex values.
- **The frame is set to your brand mode**, and switches between light and dark.
- **The content is yours.** No "Title" or lorem ipsum stays. Text the agent had to write itself is listed in its report.

Screens are 1440 wide by default. Ask for another width, or for a mobile frame at 390.

## What it leaves alone

The skill only adds. It never moves, edits or deletes what is in the file, and it never changes a component, a variable or a style of the kit.

When a block needs a structure its properties don't offer, such as a fourth plan, the agent detaches that one instance and edits the copy. The report says so, because a detached block stops following the kit.

## Images

An agent can't bring new images into a Figma file on its own. Give it the image files, and it uploads them. Otherwise the kit's placeholders stay, and the report lists them. Icons come from the kit's icon components.

## From the design to code

The blocks in the kit are the blocks in the registry, so the screen is close to code already:

- [`/shadcnpro-create-page`](https://pro.shadcn.co/docs/agent-skills/create-page) builds the same page in your project from the same blocks.
- [`/shadcnpro-generate-code`](https://pro.shadcn.co/docs/agent-skills/generate-code) turns a frame into code, section by section.

## Tips for better results

- **Bring the content.** The more real copy, plans and numbers you give, the less the agent has to write for you.
- **Add your brand first.** [`/shadcnpro-create-brand-mode`](https://pro.shadcn.co/docs/agent-skills/create-brand-mode) makes your brand a mode the screen can use.
- **Name the blocks you like.** Mention a block from the [Blocks](https://pro.shadcn.co/pro-blocks) page, such as `pricing-01`, and the agent starts from it.
- **Go one screen at a time.** A flow of five screens works best as five runs in the same chat.
