Skip to content

NarixHine/uni-chem / .agents/skills/heroui-react

heroui-react

Flagged

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

FileKindSize
LICENSE.txtmarkdown11.0 KB
SKILL.mdskill md6.4 KB
scripts/get_component_docs.mjsscript4.2 KB
scripts/get_docs.mjsscript4.2 KB
scripts/get_source.mjsscript4.4 KB
scripts/get_styles.mjsscript4.4 KB
scripts/get_theme.mjsscript5.4 KB
scripts/list_components.mjsscript3.9 KB

scripts/get_component_docs.mjs

View on GitHub
#!/usr/bin/env node
/**
 * Get complete component documentation (MDX) for HeroUI v3 components.
 *
 * Usage:
 *   node get_component_docs.mjs Button
 *   node get_component_docs.mjs Button Card TextField
 *
 * Output:
 *   MDX documentation including imports, usage, variants, props, examples
 */

const API_BASE = process.env.HEROUI_API_BASE || 'https://mcp-api.heroui.com'
const FALLBACK_BASE = 'https://heroui.com'
const APP_PARAM = 'app=react-skills'

/**
 * Convert PascalCase to kebab-case.
 */
function toKebabCase(name) {
    return name
        .replace(/([a-z])([A-Z])/g, '$1-$2')
        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
        .toLowerCase()
}

/**
 * Fetch data from HeroUI API with app parameter for analytics.
 */
async function fetchApi(endpoint, method = 'GET', body = null) {
    const separator = endpoint.includes('?') ? '&' : '?'
    const url = `${API_BASE}${endpoint}${separator}${APP_PARAM}`

    try {
        const options = {
            headers: {
                'Content-Type': 'application/json',
                'User-Agent': 'HeroUI-Skill/1.0',
            },
            method,
            signal: AbortSignal.timeout(30000),
        }

        if (body) {
            options.body = JSON.stringify(body)
        }

        const response = await fetch(url, options)

        if (!response.ok) {
            return null
        }

        return await response.json()
    } catch {
        return null
    }
}

/**
 * Fetch MDX directly from v3.heroui.com as fallback.
 */
async function fetchFallback(component) {
    const kebabName = toKebabCase(component)
    const url = `${FALLBACK_BASE}/docs/react/components/${kebabName}.mdx`

    try {
        const response = await fetch(url, {
            headers: { 'User-Agent': 'HeroUI-Skill/1.0' },
            signal: AbortSignal.timeout(30000),
        })

        if (!response.ok) {
            return { component, error: `Failed to fetch docs for ${component}` }
        }

        const content = await response.text()

        return {
            component,
            content,
            contentType: 'mdx',
            source: 'fallback',
            url,
        }
    } catch {
        return { component, error: `Failed to fetch docs for ${component}` }
    }
}

/**
 * Main function to get component documentation.
 */
async function main() {
    const args = process.argv.slice(2)

    if (args.length === 0) {
        console.error('Usage: node get_component_docs.mjs <Component1> [Component2] ...')
        console.error('Example: node get_component_docs.mjs Button Card')
        process.exit(1)
    }

    const components = args

    // Try API first - use POST /v1/components/docs for batch requests
    console.error(`# Fetching docs for: ${components.join(', ')}...`)
    const data = await fetchApi('/v1/components/docs', 'POST', { components })

    if (data && data.results) {
        // Output results
        if (data.results.length === 1) {
            // Single component - output content directly for easier reading
            const result = data.results[0]

            if (result.content) {
                console.log(result.content)
            } else if (result.error) {
                console.error(`# Error for ${result.component}: ${result.error}`)
                console.log(JSON.stringify(result, null, 2))
            } else {
                console.log(JSON.stringify(result, null, 2))
            }
        } else {
            // Multiple components - output as JSON array
            console.log(JSON.stringify(data, null, 2))
        }

        return
    }

    // Fallback to individual component fetches
    console.error('# API failed, using fallback...')
    const results = []

    for (const component of components) {
        const result = await fetchFallback(component)

        results.push(result)
    }

    // Output results
    if (results.length === 1) {
        // Single component - output content directly for easier reading
        const result = results[0]

        if (result.content) {
            console.log(result.content)
        } else {
            console.log(JSON.stringify(result, null, 2))
        }
    } else {
        // Multiple components - output as JSON array
        console.log(JSON.stringify(results, null, 2))
    }
}

main()
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall