Skip to content

notque/vexjoy-agent / skills/frontend/frontend

frontend

Unverified

Frontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.

FileKindSize
SKILL.mdskill md22.5 KB
SPEC.mdmarkdown4.3 KB
agents/html-builder.mdmarkdown5.9 KB
assets/base-template.htmlother495 B
references/design-refs/accessibility-review.mdmarkdown13.0 KB
references/design-refs/design-critique.mdmarkdown10.4 KB
references/design-refs/design-handoff.mdmarkdown9.9 KB
references/design-refs/design-systems.mdmarkdown9.3 KB
references/design-refs/llm-design-failure-modes.mdmarkdown9.1 KB
references/design-refs/ux-copy.mdmarkdown9.5 KB
references/distinctive-frontend-design-refs/animation-patterns.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/background-techniques.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/balatro-shader-breakdown.mdmarkdown14.9 KB
references/distinctive-frontend-design-refs/card-shader-patterns.mdmarkdown10.9 KB
references/distinctive-frontend-design-refs/color-inspirations.jsonconfig9.4 KB
references/distinctive-frontend-design-refs/css-audit-patterns.mdmarkdown4.7 KB
references/distinctive-frontend-design-refs/font-catalog.jsonconfig9.7 KB
references/distinctive-frontend-design-refs/game-ui-polish.mdmarkdown6.3 KB
references/distinctive-frontend-design-refs/honest-placeholders.mdmarkdown3.2 KB
references/distinctive-frontend-design-refs/implementation-examples.mdmarkdown7.7 KB
references/distinctive-frontend-design-refs/macrostructure-catalog.mdmarkdown9.3 KB
references/distinctive-frontend-design-refs/oklch-color-harmony.mdmarkdown7.3 KB
references/distinctive-frontend-design-refs/performance-budgets.mdmarkdown10.6 KB
references/distinctive-frontend-design-refs/phase-details.mdmarkdown4.8 KB
references/distinctive-frontend-design-refs/pptx-conversion.mdmarkdown9.7 KB
references/distinctive-frontend-design-refs/roll-text.mdmarkdown7.2 KB
references/distinctive-frontend-design-refs/shader-integration-react.mdmarkdown16.7 KB
references/distinctive-frontend-design-refs/slide-controller.mdmarkdown9.4 KB
references/distinctive-frontend-design-refs/text-animation-patterns.mdmarkdown4.3 KB
references/html-artifact-refs/design-system.mdmarkdown10.2 KB
references/html-artifact-refs/diagram-layering.mdmarkdown3.9 KB
references/html-artifact-refs/infographic-layouts.mdmarkdown4.9 KB
references/html-artifact-refs/pdf-export.mdmarkdown6.0 KB
references/html-artifact-refs/pptx-export.mdmarkdown10.2 KB
references/html-artifact-refs/shape-diagram-illustration.mdmarkdown4.3 KB
references/nextjs-ecommerce.mdmarkdown3.4 KB
references/nextjs-ecommerce/admin-dashboard.mdmarkdown9.8 KB
references/nextjs-ecommerce/error-catalog.mdmarkdown7.9 KB
references/nextjs-ecommerce/expertise.mdmarkdown5.1 KB
references/nextjs-ecommerce/patterns-and-errors.mdmarkdown4.6 KB
references/nextjs-ecommerce/preferred-patterns.mdmarkdown8.0 KB
references/nextjs-ecommerce/shopping-cart-patterns.mdmarkdown7.7 KB
references/nextjs-ecommerce/stripe-integration.mdmarkdown9.5 KB
references/performance-optimization.mdmarkdown9.9 KB
references/performance-optimization/browser-dom-optimizations.mdmarkdown6.0 KB
references/performance-optimization/bundle-optimization.mdmarkdown7.9 KB
references/performance-optimization/core-web-vitals.mdmarkdown9.6 KB
references/performance-optimization/js-algorithm-optimizations.mdmarkdown9.6 KB
references/performance-optimization/metrics-and-monitoring.mdmarkdown8.8 KB
references/performance-optimization/nextjs-optimization.mdmarkdown10.6 KB
references/performance-optimization/performance-testing.mdmarkdown9.6 KB
references/performance-optimization/preferred-patterns.mdmarkdown7.4 KB
references/performance-optimization/react-async-patterns.mdmarkdown7.0 KB
references/performance-optimization/react-bundle-optimization.mdmarkdown6.3 KB
references/performance-optimization/react-rendering-performance.mdmarkdown12.0 KB
references/react-native.mdmarkdown4.4 KB
references/react-native/animation-patterns.mdmarkdown3.9 KB
references/react-native/error-handling.mdmarkdown7.7 KB
references/react-native/list-performance.mdmarkdown5.4 KB
references/react-native/monorepo-config.mdmarkdown2.3 KB
references/react-native/navigation-patterns.mdmarkdown2.0 KB
references/react-native/rendering-patterns.mdmarkdown3.2 KB
references/react-native/state-management.mdmarkdown3.3 KB
references/react-native/testing.mdmarkdown6.2 KB
references/react-native/ui-patterns.mdmarkdown5.0 KB
references/react-portfolio.mdmarkdown7.7 KB
references/react-portfolio/gallery-patterns.mdmarkdown2.5 KB
references/react-portfolio/image-optimization.mdmarkdown3.4 KB
references/react-portfolio/lightbox-patterns.mdmarkdown6.1 KB
references/react-portfolio/nextjs-app-router.mdmarkdown4.9 KB
references/react-portfolio/performance.mdmarkdown3.9 KB
references/react-portfolio/portfolio-seo.mdmarkdown4.8 KB
references/react-portfolio/responsive-design.mdmarkdown3.3 KB
references/threejs-builder-refs/advanced-animation.mdmarkdown12.1 KB
references/threejs-builder-refs/advanced-topics.mdmarkdown11.0 KB
references/threejs-builder-refs/build-recipes.mdmarkdown7.4 KB
references/threejs-builder-refs/game-architecture.mdmarkdown10.4 KB
references/threejs-builder-refs/game-patterns.mdmarkdown12.5 KB
references/threejs-builder-refs/gltf-loading.mdmarkdown8.6 KB
references/threejs-builder-refs/performance-patterns.mdmarkdown11.8 KB
references/threejs-builder-refs/react-three-fiber.mdmarkdown17.8 KB
references/threejs-builder-refs/shader-patterns.mdmarkdown15.0 KB
references/threejs-builder-refs/visual-polish.mdmarkdown16.3 KB
references/threejs-builder-refs/webgpu.mdmarkdown20.4 KB
references/typescript-frontend.mdmarkdown5.3 KB
references/typescript-frontend/engineering-rules.mdmarkdown7.8 KB
references/typescript-frontend/nextjs-security.mdmarkdown2.6 KB
references/typescript-frontend/react-view-transitions.mdmarkdown5.4 KB
references/ui-design.mdmarkdown10.2 KB
references/ui-design/ai-slop-detection.mdmarkdown8.5 KB
references/ui-design/design-conventions.mdmarkdown2.8 KB
references/ui-design/motion-and-interaction.mdmarkdown5.6 KB
scripts-distinctive-frontend-design/css_slop_rules.pyscript15.3 KB
scripts-distinctive-frontend-design/tests/test_css_slop_rules.pyscript6.9 KB
scripts-distinctive-frontend-design/tests/test_validate_design_advisory.pyscript3.3 KB
scripts-distinctive-frontend-design/tests/test_validate_design_macro.pyscript4.3 KB
scripts-distinctive-frontend-design/validate_design.pyscript22.2 KB
scripts-html-artifact/assemble-template.pyscript7.5 KB
scripts-html-artifact/css_slop_rules.pyscript15.4 KB
scripts-html-artifact/detect-shape.pyscript7.0 KB
scripts-html-artifact/fill-template.pyscript5.5 KB
scripts-html-artifact/pptx-bridge/__init__.pyscript490 B
scripts-html-artifact/pptx-bridge/_pptx_engine.pyscript26.4 KB
scripts-html-artifact/pptx-bridge/extract_slides.pyscript13.5 KB
scripts-html-artifact/pptx-bridge/render_pptx.pyscript6.9 KB
scripts-html-artifact/pptx-bridge/run-unified.pyscript11.6 KB
scripts-html-artifact/render-github-issues.pyscript7.5 KB
scripts-html-artifact/tests/test_assemble_template.pyscript29.5 KB
scripts-html-artifact/tests/test_css_slop_emission.pyscript7.9 KB
scripts-html-artifact/tests/test_detect_shape.pyscript5.3 KB
scripts-html-artifact/tests/test_fill_template.pyscript5.2 KB
scripts-html-artifact/tests/test_to_pdf.pyscript13.3 KB
scripts-html-artifact/tests/test_validate_artifact.pyscript13.6 KB
scripts-html-artifact/to-pdf.pyscript12.5 KB
scripts-html-artifact/validate-artifact.pyscript11.0 KB
templates/base-reset.cssother1.2 KB
templates/components/collapsible.cssother1.1 KB
templates/components/collapsible.jsscript516 B
templates/components/copy-button.cssother534 B
templates/components/copy-button.jsscript334 B
templates/components/drag-drop.cssother612 B
templates/components/drag-drop.jsscript1.1 KB
templates/components/filter.cssother1.1 KB
templates/components/filter.jsscript987 B
templates/components/keyboard-nav.cssother249 B
templates/components/keyboard-nav.jsscript900 B
templates/components/scrollytelling.cssother1.5 KB
templates/components/scrollytelling.jsscript2.0 KB
templates/components/slider.cssother848 B
templates/components/tabs.cssother770 B
templates/components/tabs.jsscript508 B
templates/components/theme-toggle.cssother1.2 KB
templates/components/theme-toggle.jsscript178 B
templates/fonts/ArchivoBlack-OFL.txtmarkdown4.4 KB
templates/fonts/archivo-black.cssother13.7 KB
templates/print/code-review-print.cssother1.9 KB
templates/print/data-viz-print.cssother1.5 KB
templates/print/deck-print.cssother1.5 KB
templates/print/default-print.cssother1.6 KB
templates/print/diagram-print.cssother1.6 KB
templates/print/editor-print.cssother2.1 KB
templates/print/prototype-print.cssother1.4 KB
templates/print/report-print.cssother1.8 KB
templates/print/spec-print.cssother1.4 KB
templates/saved/README.mdmarkdown1.8 KB
templates/saved/business-review.htmlother17.1 KB
templates/saved/business-review.slots.jsonconfig1.5 KB
templates/saved/github-issues.htmlother34.0 KB
templates/saved/project-kickoff.htmlother17.3 KB
templates/saved/project-kickoff.slots.jsonconfig1.7 KB
templates/saved/system-design.htmlother16.9 KB
templates/saved/system-design.slots.jsonconfig1.6 KB
templates/shapes/code-review.cssother2.7 KB
templates/shapes/data-viz.cssother2.3 KB
templates/shapes/deck.cssother1.9 KB
templates/shapes/diagram.cssother2.7 KB
templates/shapes/editor.cssother2.8 KB
templates/shapes/prototype.cssother2.7 KB
templates/shapes/report.cssother2.9 KB
templates/shapes/spec.cssother3.0 KB
templates/themes/birchline.cssother2.4 KB
templates/themes/dark-focus.cssother2.6 KB
templates/themes/interactive-warm.cssother4.5 KB
templates/themes/minimal-document.cssother2.6 KB

scripts-html-artifact/assemble-template.py

View on GitHub
#!/usr/bin/env python3
"""Deterministic HTML template assembler for html-artifact skill.

Given a shape, title, and optional components, reads CSS/JS template files
from the templates/ directory and injects them into the base HTML template.

Exit codes:
    0: template assembled successfully
    1: invalid shape, theme, or component
    2: base template not found

Usage:
    python3 skills/frontend/frontend/scripts-html-artifact/assemble-template.py --shape spec --title "Auth Comparison"
    python3 skills/frontend/frontend/scripts-html-artifact/assemble-template.py --shape spec --title "Test" --components tabs,collapsible
    python3 skills/frontend/frontend/scripts-html-artifact/assemble-template.py --shape code-review --title "PR #42" --theme dark-focus
"""

from __future__ import annotations

import argparse
import sys
from pathlib import Path

VALID_SHAPES = ("spec", "code-review", "prototype", "report", "editor", "data-viz", "diagram", "deck")
VALID_THEMES = ("birchline", "dark-focus", "interactive-warm", "minimal-document")
VALID_COMPONENTS = (
    "tabs",
    "collapsible",
    "drag-drop",
    "copy-button",
    "keyboard-nav",
    "theme-toggle",
    "filter",
    "slider",
    "scrollytelling",
)

SHAPE_DEFAULT_THEME: dict[str, str] = {
    "spec": "birchline",
    "code-review": "dark-focus",
    "prototype": "interactive-warm",
    "report": "birchline",
    "editor": "interactive-warm",
    "data-viz": "dark-focus",
    "diagram": "dark-focus",
    "deck": "dark-focus",
}

TEMPLATES_DIR = Path(__file__).parent.parent / "templates"
BASE_TEMPLATE_PATH = Path(__file__).parent.parent / "assets" / "base-template.html"


def _read_template(relpath: str) -> str:
    """Read a template file, returning empty string if not found."""
    p = TEMPLATES_DIR / relpath
    if p.exists():
        return p.read_text(encoding="utf-8")
    return ""


def assemble_template(
    shape: str,
    title: str,
    theme: str | None = None,
    components: list[str] | None = None,
) -> str:
    """Assemble an HTML template with theme, shape, and component CSS/JS.

    Args:
        shape: One of the valid artifact shapes.
        title: The title to inject into the template.
        theme: Optional theme override. Defaults to shape-specific theme.
        components: Optional list of component names to inject.

    Returns:
        The assembled HTML string.

    Raises:
        ValueError: If shape, theme, or component is invalid.
        FileNotFoundError: If base template is missing.
    """
    if shape not in VALID_SHAPES:
        raise ValueError(f"Invalid shape '{shape}'. Valid shapes: {', '.join(VALID_SHAPES)}")

    resolved_theme = theme if theme is not None else SHAPE_DEFAULT_THEME[shape]
    if resolved_theme not in VALID_THEMES:
        raise ValueError(f"Invalid theme '{resolved_theme}'. Valid themes: {', '.join(VALID_THEMES)}")

    if components:
        invalid = [c for c in components if c not in VALID_COMPONENTS]
        if invalid:
            raise ValueError(
                f"Invalid component(s): {', '.join(invalid)}. Valid components: {', '.join(VALID_COMPONENTS)}"
            )

    template = BASE_TEMPLATE_PATH.read_text(encoding="utf-8")

    # Inject title
    html = template.replace("<!-- TITLE -->", title)

    # Tag the body with the shape so downstream tools (e.g. to-pdf.py) can
    # detect it without re-running shape classification.
    html = html.replace("<body>", f'<body data-shape="{shape}">', 1)

    # Build CSS injection: stamp + reset + theme + shape + components
    css_parts: list[str] = []

    # 0. Self-describing stamp — first CSS comment in the output. Lets a later run
    #    re-audit the build statelessly (shape/theme recovery). contrast=n/a because
    #    the assembler runs no WCAG check; a contrast-aware caller may overwrite it.
    css_parts.append(f"/* vexjoy-artifact: shape={shape} theme={resolved_theme} contrast=n/a */")

    # 1. Base reset
    reset_css = _read_template("base-reset.css")
    if reset_css:
        css_parts.append(reset_css)

    # 1b. Heading font (embedded Archivo Black; defines --font-heading used by theme type tokens)
    font_css = _read_template("fonts/archivo-black.css")
    if font_css:
        css_parts.append(font_css)

    # 2. Theme CSS (replaces the base template's Birchline tokens)
    theme_css = _read_template(f"themes/{resolved_theme}.css")
    if theme_css:
        css_parts.append(theme_css)

    # 3. Shape-specific CSS
    shape_css = _read_template(f"shapes/{shape}.css")
    if shape_css:
        css_parts.append(shape_css)

    # 4. Print CSS — per-shape, with default-print.css fallback. Files self-declare
    #    @page and @media print rules; injected as-is (no double-wrapping).
    print_css = _read_template(f"print/{shape}-print.css")
    if not print_css:
        print_css = _read_template("print/default-print.css")
    if print_css:
        css_parts.append(print_css)

    # 5. Component CSS
    if components:
        for comp in components:
            comp_css = _read_template(f"components/{comp}.css")
            if comp_css:
                css_parts.append(comp_css)

    # Build JS injection: components only
    js_parts: list[str] = []
    if components:
        for comp in components:
            comp_js = _read_template(f"components/{comp}.js")
            if comp_js:
                js_parts.append(comp_js)

    # Inject CSS after the STYLES placeholder
    if css_parts:
        css_block = "\n".join(css_parts)
        html = html.replace(
            "/* <!-- STYLES --> */",
            css_block + "\n    /* <!-- STYLES --> */",
        )

    # Inject JS after the SCRIPTS placeholder
    if js_parts:
        js_block = "\n".join(js_parts)
        html = html.replace(
            "/* <!-- SCRIPTS --> */",
            js_block + "\n    /* <!-- SCRIPTS --> */",
        )

    return html


def main() -> None:
    """CLI entry point."""
    parser = argparse.ArgumentParser(description="Assemble an HTML artifact template.")
    parser.add_argument("--shape", required=True, help="Artifact shape.")
    parser.add_argument("--title", required=True, help="Title for the artifact.")
    parser.add_argument(
        "--theme",
        default=None,
        help="Theme override (birchline, dark-focus, interactive-warm, minimal-document).",
    )
    parser.add_argument(
        "--components",
        default=None,
        help="Comma-separated component names to inject (tabs, collapsible, drag-drop, etc.).",
    )
    args = parser.parse_args()

    if args.shape not in VALID_SHAPES:
        sys.stderr.write(f"Error: Invalid shape '{args.shape}'. Valid shapes: {', '.join(VALID_SHAPES)}\n")
        sys.exit(1)

    if args.theme is not None and args.theme not in VALID_THEMES:
        sys.stderr.write(f"Error: Invalid theme '{args.theme}'. Valid themes: {', '.join(VALID_THEMES)}\n")
        sys.exit(1)

    comp_list: list[str] | None = None
    if args.components:
        comp_list = [c.strip() for c in args.components.split(",") if c.strip()]
        invalid = [c for c in comp_list if c not in VALID_COMPONENTS]
        if invalid:
            sys.stderr.write(
                f"Error: Invalid component(s): {', '.join(invalid)}. Valid: {', '.join(VALID_COMPONENTS)}\n"
            )
            sys.exit(1)

    try:
        html = assemble_template(args.shape, args.title, args.theme, comp_list)
    except FileNotFoundError:
        sys.stderr.write(f"Error: Base template not found at {BASE_TEMPLATE_PATH}\n")
        sys.exit(2)

    sys.stdout.write(html)


if __name__ == "__main__":
    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