ui-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.
SKILL.md
Full skill instructions
UI Potion Discovery
Purpose
Help agents find the most relevant UI Potion guides for a user request.
When to use
- The user asks for a UI component/layout/feature but does not name a specific potion
- The user asks for recommendations or alternatives
- You need to map intent to available UI Potion guides
Inputs
- User intent keywords (e.g., "dashboard", "navbar", "modal")
- Optional category preference (layouts, components, features, patterns, tooling)
Steps
- Prefer the local index if available:
src/statics/potions-index.json - Otherwise load
https://uipotion.com/potions-index.json - Filter by category and tags that match the intent
- Rank by tag overlap and relevance to the request
- Return the top 1-3 matches with both URLs
Output format
- Name
- Category
- JSON guide URL
- Human-readable page URL
Constraints
- Prefer JSON guide URLs for implementation
- Provide the human page for review and context
- If no strong match exists, say so and propose the closest option