Index of every page on this site: llms.txt
All skills
21st-dev avatar

/21st-ui-explore

@15c7436
by 21st Labs21st-dev/skill43 stars
11
Run it yourself

Explore and compare multiple meaningfully different UI directions grounded in the current project's design system and 21st inspiration. Use when the user wants options, variants, concepts, a redesign direction, visual experimentation, or is unsure how a new interface should look. Trigger for requests such as "show me three directions", "explore alternatives", "what could this page look like", or "generate variants". Do not use for a straightforward implementation with an already-selected direction.

Use this Skill: https://skilld.dev/gh/21st-dev/skill/21st-ui-explore

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈130 tokens for metadata: the name and description. ≈531 when used: this file. ≈53 more on demand in 1 file.

Description uses 6.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈521 characters, or 6.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Explore grounded UI directions

Create real choices without abandoning the project's visual identity.

Workflow

  1. Read .21st/design.json and the relevant product UI. If context is missing, run 21st init --design-context.

  2. Search 21st for multiple relevant references before generating:

    21st search "<interface and product context>" --context auto
  3. 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.

  4. Keep shared constraints fixed: real stack, tokens, brand assets, required content, accessibility, and responsive behavior.

  5. Create comparable previews. Check MCP get_usage.aiGenerationEnabled or 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 3

    Otherwise, 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.

  6. Present the options together when the host supports a picker. Otherwise give each option a preview/deep link and a compact comparison.

  7. Recommend one direction with concrete tradeoffs, but let the user choose.

  8. 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.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill facilitates UI exploration and variant generation using the 21st development toolset. It manages project-specific design context and retrieves external references without exhibiting malicious behavior.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 15c7436. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 2 months ago

README badge

README badge for 21st-dev/skill/21st-ui-explore