How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/21st-dev/skill --skill 21st-ui-exploreBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Explore grounded UI directions
Create real choices without abandoning the project's visual identity.
Workflow
- Read
.21st/design.jsonand the relevant product UI. If context is missing,
run 21st init --design-context.
- Search 21st for multiple relevant references before generating:
21st search "<interface and product context>" --context auto- Define three named directions. Each direction must differ on at least two
meaningful axes such as hierarchy, information density, navigation model, content emphasis, interaction pattern, or composition. Color-only variants do not count.
- Keep shared constraints fixed: real stack, tokens, brand assets, required
content, accessibility, and responsive behavior.
- Create comparable previews. Check MCP
get_usage.aiGenerationEnabledor
run 21st usage and read the 21st AI generation line. CLI 1.17.1+ also supports 21st usage --json. Only when AI is explicitly enabled, use hosted generation with available AI credits:
21st generate "<goal plus fixed constraints>" --context auto --variants 3Otherwise, implement the previews with your own coding agent, grounded in 21st search and 21st get (MCP: search and get_component). Do not call or suggest hosted generate or iterate_generation without AI access.
- Present the options together when the host supports a picker. Otherwise give
each option a preview/deep link and a compact comparison.
- Recommend one direction with concrete tradeoffs, but let the user choose.
- After selection, remove abandoned local variants and record the decision in
.21st/design.json.
Direction contract
For every direction provide:
- a short, descriptive name;
- the core idea and intended user effect;
- the 21st/project references used;
- what stays consistent with the project;
- two or more meaningful differences;
- accessibility or responsive risks;
- the best-fit scenario.
Do not generate random style mutations. Every difference must support a product or usability hypothesis that a user can evaluate.




