Skip to content

Biswadipgoj/biswodip / .agents/skills/ui-ux-pro-max

ui-ux-pro-max

Unverified

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

FileKindSize
SKILL.mdskill md15.6 KB
data/app-interface.csvother10.8 KB
data/catalog-summary.jsonconfig2.3 KB
data/charts.csvother22.8 KB
data/colors.csvother37.1 KB
data/data-provenance.jsonconfig35.8 KB
data/google-font-licenses.jsonconfig423.0 KB
data/google-fonts.csvother729.7 KB
data/icons.csvother56.6 KB
data/landing.csvother24.9 KB
data/motion.csvother14.3 KB
data/phosphor-icons-upstream.jsonconfig804.6 KB
data/products.csvother73.9 KB
data/react-performance.csvother14.7 KB
data/stacks/angular.csvother19.4 KB
data/stacks/astro.csvother14.2 KB
data/stacks/avalonia.csvother26.7 KB
data/stacks/flutter.csvother13.9 KB
data/stacks/html-tailwind.csvother16.2 KB
data/stacks/javafx.csvother32.8 KB
data/stacks/jetpack-compose.csvother12.0 KB
data/stacks/laravel.csvother19.7 KB
data/stacks/nextjs.csvother18.2 KB
data/stacks/nuxt-ui.csvother23.5 KB
data/stacks/nuxtjs.csvother22.5 KB
data/stacks/react-native.csvother13.7 KB
data/stacks/react.csvother18.6 KB
data/stacks/shadcn.csvother22.6 KB
data/stacks/svelte.csvother14.7 KB
data/stacks/swiftui.csvother15.0 KB
data/stacks/threejs.csvother45.0 KB
data/stacks/uno.csvother29.4 KB
data/stacks/uwp.csvother24.1 KB
data/stacks/vue.csvother12.5 KB
data/stacks/winui.csvother27.2 KB
data/stacks/wpf.csvother23.6 KB
data/styles.csvother146.0 KB
data/typography.csvother48.8 KB
data/ui-reasoning.csvother75.5 KB
data/ux-guidelines.csvother26.9 KB
references/pro-rules.mdmarkdown10.7 KB
references/quick-reference.mdmarkdown24.0 KB
scripts/core.pyscript40.3 KB
scripts/design_system.pyscript69.3 KB
scripts/reasoning_contract.pyscript5.7 KB
scripts/search.pyscript9.2 KB
scripts/tests/fixtures/catalogs/google-api.jsonconfig1.1 KB
scripts/tests/fixtures/catalogs/google-catalog.jsonconfig1.7 KB
scripts/tests/fixtures/catalogs/google-existing.csvother480 B
scripts/tests/fixtures/catalogs/google-metadata.jsonconfig328 B
scripts/tests/fixtures/catalogs/google-overrides.jsonconfig97 B
scripts/tests/fixtures/catalogs/icons-curated.csvother495 B
scripts/tests/fixtures/catalogs/phosphor-core.jsonconfig571 B
scripts/tests/fixtures/catalogs/phosphor-package.jsonconfig370 B
scripts/tests/fixtures/catalogs/phosphor-react-exports.jsonconfig87 B
scripts/tests/fixtures/catalogs/phosphor-react-package.jsonconfig81 B
scripts/tests/fixtures/relevance-baseline.jsonconfig87.3 KB
scripts/tests/fixtures/relevance-cases.jsonconfig35.9 KB
scripts/tests/fixtures/relevance-thresholds.jsonconfig5.0 KB
scripts/tests/test_catalog_refresh.pyscript19.0 KB
scripts/tests/test_catalog_summary_line_endings.pyscript2.9 KB
scripts/tests/test_core.pyscript16.3 KB
scripts/tests/test_core_data_quality.pyscript8.7 KB
scripts/tests/test_data_contracts.pyscript19.1 KB
scripts/tests/test_design_system_mode.pyscript7.5 KB
scripts/tests/test_design_system_stack.pyscript2.2 KB
scripts/tests/test_native_desktop_stack_freshness.pyscript8.0 KB
scripts/tests/test_relevance_evaluator.pyscript8.2 KB
scripts/tests/test_skill_script_paths.pyscript4.2 KB
scripts/tests/test_style_taxonomy.pyscript7.3 KB
scripts/tests/test_text_layout_resilience.pyscript5.7 KB
scripts/tests/test_web_stack_freshness.pyscript7.5 KB
scripts/validate_data.pyscript51.0 KB

scripts/search.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
       python search.py "<query>" --design-system [-p "Project Name"]
       python search.py "<query>" --design-system --persist [-p "Project Name"] --output-dir "<project-root>" [--page "dashboard"]
       python search.py "<query>" --design-system --variance 8 --motion 9 --density 7

Domains: style, color, chart, landing, product, ux, typography, google-fonts, icons, gsap, react, web
Stacks: react, nextjs, vue, svelte, astro, swiftui, react-native, flutter, nuxtjs, nuxt-ui,
        html-tailwind, shadcn, jetpack-compose, threejs, angular, laravel

Design dials (1-10, only with --design-system):
  --variance   DESIGN_VARIANCE: 1=centered/minimal, 10=bold/asymmetric
  --motion     MOTION_INTENSITY: 1=subtle, 10=complex; attaches a GSAP snippet from motion.csv
  --density    VISUAL_DENSITY: 1=spacious, 10=dense/dashboard; overrides the spacing scale

Persistence (Master + Overrides pattern):
  --persist      Save design system to design-system/<project-slug>/MASTER.md
  --output-dir   Directory the design-system/ folder is created under (defaults to cwd --
                 always pass this explicitly, pointed at the project root)
  --page         Also create a page-specific override file in design-system/<project-slug>/pages/
  --force        Overwrite an existing MASTER.md (without this, persistence is skipped
                 if MASTER.md already exists, so prior design decisions aren't lost)
"""

import argparse
import json as json_module
import sys
import io
from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, UNTRUNCATED_COLS, search, search_stack
from design_system import generate_design_system

# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')

TRUNCATE_AT = 300


def format_output(result, full=False):
    """Format results for Claude consumption (token-optimized)"""
    if "error" in result:
        return f"Error: {result['error']}"

    output = []
    if result.get("stack"):
        output.append("## UI Pro Max Stack Guidelines")
        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
    else:
        output.append("## UI Pro Max Search Results")
        domain_note = result['domain']
        if result.get("auto_detected"):
            domain_note += " (auto-detected"
            if result.get("runner_up_domain"):
                domain_note += f", runner-up: {result['runner_up_domain']}"
            domain_note += ")"
        output.append(f"**Domain:** {domain_note} | **Query:** {result['query']}")
    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")

    if result['count'] == 0:
        redirect = result.get("redirect")
        if redirect:
            output.append(
                "This legacy style label is now modeled in the "
                f"`{redirect['domain']}` domain as `{redirect['id']}`. "
                "Search that domain instead of treating a page composition as a visual style."
            )
            return "\n".join(output)
        output.append(
            "No matches. This is not a match with an empty value -- the query "
            "did not hit the database. Retry with broader/different keywords "
            "before falling back to general defaults, and say explicitly that "
            "no database match was found if you do fall back."
        )
        suggestions = result.get("suggestions") or []
        if suggestions:
            output.append(f"**Closest known terms:** {', '.join(suggestions)}")
        return "\n".join(output)

    for i, row in enumerate(result['results'], 1):
        output.append(f"### Result {i}")
        for key, value in row.items():
            value_str = str(value)
            if not full and key not in UNTRUNCATED_COLS and len(value_str) > TRUNCATE_AT:
                value_str = value_str[:TRUNCATE_AT] + "..."
            output.append(f"- **{key}:** {value_str}")
        output.append("")

    return "\n".join(output)


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="UI Pro Max Search")
    parser.add_argument("query", help="Search query")
    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help=f"Stack-specific search. Available: {', '.join(AVAILABLE_STACKS)}")
    parser.add_argument("--max-results", "-n", type=int, choices=range(1, 21), default=MAX_RESULTS,
                        metavar="1-20", help="Max results (default: 3)")
    parser.add_argument("--json", action="store_true", help="Output as JSON")
    parser.add_argument("--full", action="store_true", help="Do not truncate long field values in text output")
    # Design system generation
    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system (ignored if --json)")
    # Persistence (Master + Overrides pattern)
    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/<project-slug>/MASTER.md (creates hierarchical structure)")
    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/<project-slug>/pages/")
    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory -- pass this explicitly, pointed at the project root)")
    parser.add_argument("--force", action="store_true", help="Overwrite an existing MASTER.md when persisting (default: skip if it already exists)")
    # Design dials (1-10), only applied with --design-system
    parser.add_argument("--variance", type=int, choices=range(1, 11), metavar="1-10", help="DESIGN_VARIANCE dial: 1=centered/minimal, 10=bold/asymmetric (only with --design-system)")
    parser.add_argument("--motion", type=int, choices=range(1, 11), metavar="1-10", help="MOTION_INTENSITY dial: 1=subtle, 10=complex; pulls a matching GSAP snippet from motion.csv (only with --design-system)")
    parser.add_argument("--density", type=int, choices=range(1, 11), metavar="1-10", help="VISUAL_DENSITY dial: 1=spacious, 10=dense/dashboard; overrides the spacing scale (only with --design-system)")

    args = parser.parse_args()

    # Design system takes priority
    if args.design_system:
        if args.stack:
            print(
                f"note: --stack {args.stack} is ignored in --design-system mode; "
                "run a separate --stack query for stack-specific guidelines",
                file=sys.stderr,
            )
        result = generate_design_system(
            args.query,
            args.project_name,
            args.format,
            persist=args.persist,
            page=args.page,
            output_dir=args.output_dir,
            variance=args.variance,
            motion=args.motion,
            density=args.density,
            force=args.force,
        )

        if args.json:
            print(json_module.dumps(
                {"design_system": result["design_system"], "persistence": result["persistence"]},
                indent=2, ensure_ascii=False,
            ))
        else:
            print(result["text"])

            if args.persist:
                persistence = result["persistence"] or {}
                print("\n" + "=" * 60)
                if persistence.get("status") == "skipped_exists":
                    print(f"⚠️  {persistence.get('message', 'MASTER.md already exists; not overwritten.')}")
                else:
                    ds_dir = persistence.get("design_system_dir", "design-system/<project>")
                    print(f"✅ Design system persisted to {ds_dir}/")
                    for f in persistence.get("created_files", []):
                        print(f"   📄 {f}")
                    print("")
                    print(f"📖 Usage: When building a page, check {ds_dir}/pages/[page].md first.")
                    print("   If it exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
                print("=" * 60)
    # Stack search
    elif args.stack:
        result = search_stack(args.query, args.stack, args.max_results)
        if args.json:
            print(json_module.dumps(result, indent=2, ensure_ascii=False))
        else:
            print(format_output(result, full=args.full))
    # Domain search
    else:
        result = search(args.query, args.domain, args.max_results)
        if args.json:
            print(json_module.dumps(result, indent=2, ensure_ascii=False))
        else:
            print(format_output(result, full=args.full))
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