NarixHine/uni-chem / .agents/skills/heroui-react
heroui-react
FlaggedHeroUI v3 React component library (Tailwind CSS v4 + React Aria). Use when building UIs with HeroUI — creating Buttons, Modals, Forms, Cards; installing @heroui/react; configuring dark/light themes with oklch variables; or fetching component docs. Keywords: HeroUI, Hero UI, heroui, @heroui/react, @heroui/styles.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.0 KB |
| SKILL.md | skill md | 6.4 KB |
| scripts/get_component_docs.mjs | script | 4.2 KB |
| scripts/get_docs.mjs | script | 4.2 KB |
| scripts/get_source.mjs | script | 4.4 KB |
| scripts/get_styles.mjs | script | 4.4 KB |
| scripts/get_theme.mjs | script | 5.4 KB |
| scripts/list_components.mjs | script | 3.9 KB |
scripts/list_components.mjs
View on GitHub#!/usr/bin/env node
/**
* List all available HeroUI v3 components.
*
* Usage:
* node list_components.mjs
*
* Output:
* JSON with components array, latestVersion, and count
*/
const API_BASE = process.env.HEROUI_API_BASE || 'https://mcp-api.heroui.com'
const APP_PARAM = 'app=react-skills'
const LLMS_TXT_URL = 'https://heroui.com/react/llms.txt'
/**
* Fetch data from HeroUI API with app parameter for analytics.
*/
async function fetchApi(endpoint) {
const separator = endpoint.includes('?') ? '&' : '?'
const url = `${API_BASE}${endpoint}${separator}${APP_PARAM}`
try {
const response = await fetch(url, {
headers: { 'User-Agent': 'HeroUI-Skill/1.0' },
signal: AbortSignal.timeout(30000),
})
if (!response.ok) {
console.error(`HTTP Error ${response.status}: ${response.statusText}`)
return null
}
return await response.json()
} catch (error) {
console.error(`API Error: ${error.message}`)
return null
}
}
/**
* Fetch component list from llms.txt fallback URL.
*/
async function fetchFallback() {
try {
const response = await fetch(LLMS_TXT_URL, {
headers: { 'User-Agent': 'HeroUI-Skill/1.0' },
signal: AbortSignal.timeout(30000),
})
if (!response.ok) {
return null
}
const content = await response.text()
// Parse markdown to extract component names from pattern: - [ComponentName](url)
// Look for links under the Components section (### Components)
const components = []
let inComponentsSection = false
for (const line of content.split('\n')) {
// Check if we're entering the Components section (uses ### header)
if (line.trim() === '### Components') {
inComponentsSection = true
continue
}
// Check if we're leaving the Components section (another ### header)
if (inComponentsSection && line.trim().startsWith('### ')) {
break
}
// Extract component name from markdown link pattern
// Match: - [ComponentName](https://www.heroui.com/docs/react/components/component-name)
// Skip "All Components" which links to /components without a specific component
if (inComponentsSection) {
const match = line.match(
/^\s*-\s*\[([^\]]+)\]\(https:\/\/www\.heroui\.com\/docs\/react\/components\/[a-z]/,
)
if (match) {
components.push(match[1])
}
}
}
if (components.length > 0) {
console.error(`# Using fallback: ${LLMS_TXT_URL}`)
return {
components: components.sort(),
count: components.length,
latestVersion: 'unknown',
}
}
return null
} catch (error) {
console.error(`Fallback Error: ${error.message}`)
return null
}
}
/**
* Main function to list all available HeroUI v3 components.
*/
async function main() {
let data = await fetchApi('/v1/components')
// Check if API returned valid data with components
if (!data || !data.components || data.components.length === 0) {
console.error('# API returned no components, trying fallback...')
data = await fetchFallback()
}
if (!data || !data.components || data.components.length === 0) {
console.error('Error: Failed to fetch component list from API and fallback')
process.exit(1)
}
// Output formatted JSON
console.log(JSON.stringify(data, null, 2))
// Print summary to stderr for human readability
console.error(
`\n# Found ${data.components.length} components (${data.latestVersion || 'unknown'})`,
)
}
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |