# Choose blocks

> The knowledge your agent uses whenever it picks blocks. It knows which sections a page needs, which blocks fit your content and which go well together.

## Usage

You rarely run this skill yourself. The agent loads it whenever it is about to pick, suggest or install blocks, also in the middle of another task. To ask for a plan directly:

```text title="Prompt"
/shadcnpro-choose-blocks A landing page for Acme, a time tracker for agencies. We have product screenshots, six customer logos and three plans.
```

The agent answers with a plan and waits for your yes before it installs anything:

| # | Section | Block | Why this one | Access |
|---|---|---|---|---|
| 1 | Navbar | `navbar-02` | Dropdown menus for the product areas | With a plan |
| 2 | Logos | `logos-01` | One quiet row, which suits six logos | Free |
| 3 | Features | `features-03` | Large rows with room for the product screenshots | With a plan |
| 4 | Plans | `pricing-01` | Three columns for three plans, with a billing toggle | With a plan |

The real plan covers every section of the page and links each block to its page, so you can look before you agree. Below the table, the agent names an alternative for each close call, the content it still needs from you, and one command that installs everything.

## What the skill knows

### Which sections a page needs

Recipes for marketing pages (landing, pricing, about, careers, contact, blog, changelog, customers, comparison, integrations, waitlist), app screens (dashboard, lists, settings, the sign-in flow, onboarding, AI chat) and store pages (home, category, product, cart, checkout, order tracking). Each recipe lists the sections in page order and marks the ones that only make sense with real content.

### What fits your content

The agent starts from the content you have, not from the blocks it likes:

- **It counts.** Three plans want a three-column pricing block. One strong quote wants a featured testimonial, twelve want a wall.
- **It checks the media.** Blocks built around photos or product screenshots need real ones. With neither, it picks blocks made of icons, text and numbers.
- **It cuts.** No logo cloud without logos, and no testimonials for a product without customers. A section without real content is left out, and the agent says what would unlock it.

### What goes well together

- One navbar and one footer for the whole site, picked as a pair.
- A change of layout from one section to the next. Three card grids in a row read as one long grid.
- Colored bands as accents: two per page at most, never back to back.
- One primary action per page. The hero and the closing section ask for the same thing.
- One moving section per page.
- Sign-in, sign-up and the screens around them from one family.

### Which category is which

Some categories sound alike. `stats-section` holds big numbers for marketing pages, and `stats` holds KPI cards for dashboards. `team` introduces people, and `team-members` manages them in an app. `testimonials` are customer quotes, and `reviews` are star ratings for a product. The skill keeps them apart.

### Every block id

The skill ends with an index of all 61 categories: the block ids, the free blocks and what each category covers. Ids don't always follow the category name. Sign-in blocks, for example, are `login-01` to `login-06`. The agent never has to guess one.

## Keep the index current

The index is generated on the day you install the skills, and the catalog keeps growing. To refresh it, install the skills again with `--overwrite`, as shown in [Update the skills](https://pro.shadcn.co/docs/agent-skills/setup#update-the-skills).

With the [MCP server](https://pro.shadcn.co/docs/mcp/setup) connected, the agent searches the live catalog instead, by what a section does, and gets a page plan with alternatives in one call. Without it, the agent uses the index and the search of the shadcn CLI.

## Free blocks and blocks that need a plan

The plan marks every block. When the project has no license key, the agent says so before it plans, and offers a plan from free blocks only or the full plan once a key is set up. See [`/shadcnpro-setup-blocks`](https://pro.shadcn.co/docs/agent-skills/setup-blocks).
