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/detect-shape.py

View on GitHub
#!/usr/bin/env python3
"""Deterministic shape classifier for html-artifact skill.

Analyzes a user request string and returns the best artifact shape
from eight categories: spec, code-review, prototype, report, editor, data-viz,
diagram, deck.

Classification is purely signal-word based — same input always produces same output.

Usage:
    python3 skills/frontend/frontend/scripts-html-artifact/detect-shape.py --request "explore 3 auth approaches"
    python3 skills/frontend/frontend/scripts-html-artifact/detect-shape.py --request "visualize metrics" --json-compact
"""

from __future__ import annotations

import argparse
import json
import sys
from dataclasses import dataclass, field

# --- Shape definitions ---
# Each shape has primary signals (2 points) and secondary signals (1 point).
# Priority order for tie-breaking: editor > spec > code-review > prototype > report > data-viz

SHAPES: dict[str, dict[str, list[str]]] = {
    "editor": {
        "primary": [
            "reorder",
            "triage",
            "edit config",
            "tune prompt",
            "pick",
            "drag",
            "bucket",
            "prioritize",
            "flag",
        ],
        "secondary": [
            "sort tickets",
            "manage",
            "organize",
            "configuration",
            "feature flags",
        ],
    },
    "spec": {
        "primary": [
            "plan",
            "explore",
            "compare",
            "brainstorm",
            "approach",
            "option",
            "tradeoff",
            "direction",
        ],
        "secondary": [
            "implementation plan",
            "design options",
            "side by side",
            "pros and cons",
        ],
    },
    "code-review": {
        "primary": [
            "review pr",
            "review this pr",
            "review my pr",
            "diff",
            "annotate",
            "code review",
            "explain code",
            "understand module",
            "pr writeup",
        ],
        "secondary": [
            "pull request",
            "code walkthrough",
            "what changed",
            "review the pr",
            "pr review",
        ],
    },
    "prototype": {
        "primary": [
            "prototype",
            "animation",
            "tune",
            "slider",
            "knob",
            "try options",
            "component",
            "variant",
            "tweak",
        ],
        "secondary": [
            "design system",
            "mockup",
            "interaction",
            "adjust",
            "playground",
        ],
    },
    "report": {
        "primary": [
            "report",
            "summarize",
            "status",
            "explain how",
            "incident",
            "timeline",
            "weekly",
            "research",
            "learning",
        ],
        "secondary": [
            "post-mortem",
            "overview",
            "digest",
            "briefing",
            "explainer",
        ],
    },
    "data-viz": {
        "primary": [
            "visualize",
            "chart",
            "dashboard",
            "graph",
            "trend",
            "metric",
            "plot",
            "data",
            "analytics",
        ],
        "secondary": [
            "show me the numbers",
            "performance over time",
            "distribution",
        ],
    },
    "diagram": {
        "primary": [
            "diagram",
            "flowchart",
            "architecture",
            "sequence",
            "svg",
            "illustrate",
            "figure",
            "data flow",
            "dependency map",
            "node graph",
        ],
        "secondary": [
            "draw a diagram",
            "system diagram",
            "service mesh",
            "topology",
        ],
    },
    "deck": {
        "primary": [
            "slides",
            "presentation",
            "deck",
            "talk",
            "pitch",
            "keynote",
            "slideshow",
        ],
        "secondary": [
            "slide deck",
            "lightning talk",
            "conference talk",
            "pitch deck",
        ],
    },
}

# Priority order for tie-breaking (index 0 = highest priority)
PRIORITY_ORDER: list[str] = ["editor", "spec", "code-review", "diagram", "deck", "prototype", "report", "data-viz"]

DEFAULT_SHAPE = "report"


@dataclass
class ShapeResult:
    """Classification result for a single shape."""

    shape: str
    score: int
    matched_signals: list[str] = field(default_factory=list)


def classify_request(request: str) -> dict[str, object]:
    """Classify a user request into an artifact shape.

    Args:
        request: The user's natural language request string.

    Returns:
        Dict with keys: shape, confidence, signals.
    """
    lowered = request.lower().strip()

    if not lowered:
        return {"shape": DEFAULT_SHAPE, "confidence": "low", "signals": []}

    results: list[ShapeResult] = []

    for shape_name in PRIORITY_ORDER:
        signals = SHAPES[shape_name]
        score = 0
        matched: list[str] = []

        for signal in signals["primary"]:
            if signal in lowered:
                score += 2
                matched.append(signal)

        for signal in signals["secondary"]:
            if signal in lowered:
                score += 1
                matched.append(signal)

        results.append(ShapeResult(shape=shape_name, score=score, matched_signals=matched))

    # Sort by score descending; ties broken by priority order (already iteration order)
    best = max(results, key=lambda r: (r.score, -PRIORITY_ORDER.index(r.shape)))

    if best.score == 0:
        return {"shape": DEFAULT_SHAPE, "confidence": "low", "signals": []}

    if best.score >= 4:
        confidence = "high"
    elif best.score >= 2:
        confidence = "medium"
    else:
        confidence = "low"

    # Find secondary shape (second-highest scorer with meaningful signal match)
    remaining = [r for r in results if r.shape != best.shape and r.score >= 2]
    secondary = max(remaining, key=lambda r: r.score) if remaining else None

    return {
        "shape": best.shape,
        "confidence": confidence,
        "signals": best.matched_signals,
        "secondary_shape": secondary.shape if secondary else None,
        "secondary_signals": secondary.matched_signals if secondary else [],
    }


def main() -> None:
    """CLI entry point."""
    parser = argparse.ArgumentParser(description="Classify a user request into an artifact shape.")
    parser.add_argument("--request", required=True, help="User request string to classify.")
    parser.add_argument("--json-compact", action="store_true", help="Output compact JSON (no indentation).")
    args = parser.parse_args()

    result = classify_request(args.request)

    indent = None if args.json_compact else 2
    json.dump(result, sys.stdout, indent=indent)
    sys.stdout.write("\n")


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