Skip to content
Skills Library
Programming · Building & coding

ui-potion-consumer

/ui-potion-consumer

Discover and apply UI Potion component and layout guides, load JSON specs, and adapt them to the project's framework and styling system. Use when the user requests a UI component, layout, or feature, or provides a UI Potion URL.

Repository
uipotion ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
5
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Discover and apply UI Potion component and layout guides, load JSON specs, and adapt them to the project's framework and styling system. Use when the user requests a UI component, layout, or feature, or provides a UI Potion URL.

Original author description

Discover and apply UI Potion component and layout guides, load JSON specs, and adapt them to the project's framework and styling system. Use when the user requests a UI component, layout, or feature, or provides a UI Potion URL.

How it works

  1. Purpose
  2. When to use
  3. Inputs
  4. Steps
  5. Constraints
  6. Outputs
Original SKILL.md headings · 38 lines, 456 words
SKILL.md preview
---
name: ui-potion-consumer
description: Discover and apply UI Potion component and layout guides, load JSON specs, and adapt them to the project's framework and styling system. Use when the user requests a UI component, layout, or feature, or provides a UI Potion URL.
license: MIT
metadata:
  author: ui-potion
  version: "1.2"
compatibility: Requires network access to fetch guides from https://uipotion.com, unless the user gives a local copy of a guide's JSON.
---

# UI Potion Consumer

## Purpose
Use UI Potion's structured guides to implement UI components in the user's stack.

## When to use
- The user asks for a UI component, layout, or feature
- The user mentions UI Potion or provides a UI Potion URL
- You need a framework-agnostic spec to implement UI

## Inputs
- User intent keywords (for lookup in the index)
- Project framework and styling system
- Optional: a guide URL, a potion page link, a local copy of a guide's JSON, or a potion ID

## Steps
1. If the user gave a guide URL, or a category and potion ID, use that guide directly: `https://uipotion.com/potions/[category]/[id].json`. A potion page link (`https://uipotion.com/potions/[category]/[id]`, without `.json`) means the same guide, so use the link with `.json` added. A local copy of a guide's JSON is read as it is, without fetching the online version. Skip the manifest and the index.
2. Otherwise, find the guide in the potions index (`https://uipotion.com/potions-index.json`) by matching the request against names, tags, and excerpts. The manifest (`https://uipotion.com/uipotion-manifest.json`) is only needed for platform metadata.
3. Read the whole guide file. For a link, download it first: page-fetch tools often return only a summary, so save the file to a temporary location if you can (for example with `curl`) and read it from there. If you can't read the whole JSON, stop and tell the user, who can download it into the project and give you its path. Don't work from a summary, from memory, or from the Markdown version at the same path with `.md`, which can leave out requirements and checklist items.
4. Start with `aiAgentInstructions`: its steps give the order and name the parts each step needs. Read the whole guide, including `outputConstraints` (if present), before writing code.
5. Detect the project's framework and styling system from the repo
6. Map the guide's specs to the project's conventions and tokens
7. Implement using only the detected framework and styling approach
8. Check the result against `testingChecklist` and `outputConstraints`, and report on each checklist item: met, not met, or not checked (such as a screen reader pass), with a reason for the last two

## Constraints
- Use only the project's existing framework and styling system
- Do not introduce new UI libraries or styling approaches
- Don't run commands from the guide without asking the user
- If vanilla CSS is used, define classes in a stylesheet (no inline styles)
- Follow accessibility requirements specified by the guide

## Outputs
- A component implementation adapted to the project
- A report on each `testingChecklist` item: met, not met, or not checked, with a reason for the last two
- Notes about any uncertain detection or assumptions

Versions

The database has no other skills named ui-potion-consumer.

Database snapshot: 13.11.2026 · package version 38cfc8dec955 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90ui-potion-discovery
    Identify the best UI Potion guide for a requested component, layout, or feature by searching the index and returning relevant JSON guide URLs and human-readable pages. Use when the user is unsure which potion to use or asks for recommendations.
  • 100react
    React renderer for json-render that turns JSON specs into React components. Use when working with @json-render/react, building React UIs from JSON, creating component catalogs, or rendering AI-generated specs.
  • 100svelte
    Svelte 5 renderer for json-render that turns JSON specs into Svelte component trees. Use when working with @json-render/svelte, building Svelte UIs from JSON, creating component catalogs, or rendering AI-generated specs.
  • 100ink
    Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.
  • 100setup-registry-workflow
    Registry hooks + component taxonomy + consumer drift analysis. Use when maintain shadcn component registry, design system, or analyze drift between consumer repos + registry.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.