ui-potion-discovery

name	ui-potion-discovery
description	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.
license	MIT
metadata	{"author":"ui-potion","version":"1.0"}
compatibility	Requires network access to fetch https://uipotion.com indexes when local files are unavailable.

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

1. Prefer the local index if available: src/statics/potions-index.json
2. Otherwise load https://uipotion.com/potions-index.json
3. Filter by category and tags that match the intent
4. Rank by tag overlap and relevance to the request
5. 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