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/tests/test_css_slop_emission.py

View on GitHub
"""Tests for the vendored slop scan wired into validate-artifact.py and the
self-describing stamp emitted by assemble-template.py."""

from __future__ import annotations

import re
import sys
import tempfile
from importlib import import_module
from pathlib import Path

sys.path.insert(0, str(Path(__file__).parent.parent))

validate_mod = import_module("validate-artifact")
validate_artifact = validate_mod.validate_artifact

assemble_mod = import_module("assemble-template")
assemble_template = assemble_mod.assemble_template

slop = import_module("css_slop_rules")
scan_css = slop.scan_css

STAMP_RE = re.compile(r"/\* vexjoy-artifact: shape=(\S+) theme=(\S+) contrast=(pass|fail|n/a) \*/")

# Minimal stand-in for templates/fonts/archivo-black.css: embedded face plus a heading rule.
HEADING_FONT_CSS = (
    '@font-face { font-family: "Archivo Black"; src: url(data:font/woff2;base64,AAAA) format("woff2"); }'
    " h1, h2, h3 { font-family: var(--font-heading); }"
)

# Clean CSS: no slop patterns.
CLEAN_HTML = (
    """<!DOCTYPE html>
<html lang="en">
<head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Clean</title>
    <style>
    body { color: #111111; background-color: #ffffff; }
    .card { transition: opacity 150ms, transform 150ms; }
    h1 { color: #222222; }
    </style>
</head>
<body><h1>Hello</h1><p>content</p></body>
</html>"""
).replace("<style>", "<style>" + HEADING_FONT_CSS)

# Slop CSS: transition-all + gradient-text-headline on h1.
SLOP_HTML = (
    """<!DOCTYPE html>
<html lang="en">
<head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Slop</title>
    <style>
    .card { transition: all 200ms ease; }
    h1 { background-clip: text; -webkit-background-clip: text; }
    </style>
</head>
<body><h1>Headline</h1><p>content</p></body>
</html>"""
).replace("<style>", "<style>" + HEADING_FONT_CSS)


def _write_tmp(content: str) -> Path:
    f = tempfile.NamedTemporaryFile(mode="w", suffix=".html", delete=False, encoding="utf-8")
    f.write(content)
    f.close()
    return Path(f.name)


class TestSlopScanWiring:
    """The vendored scan_css fires on slop and stays silent on clean CSS."""

    def test_clean_css_no_slop_warnings(self) -> None:
        path = _write_tmp(CLEAN_HTML)
        try:
            result = validate_artifact(path)
            assert result.checks["css_slop_clean"] is True
            assert not any(w.startswith("CSS slop") for w in result.warnings)
            # Slop warnings are non-blocking — clean file is still valid.
            assert result.valid
        finally:
            path.unlink()

    def test_slop_css_emits_warnings(self) -> None:
        path = _write_tmp(SLOP_HTML)
        try:
            result = validate_artifact(path)
            assert result.checks["css_slop_clean"] is False
            slop_warnings = [w for w in result.warnings if w.startswith("CSS slop")]
            assert any("transition-all" in w for w in slop_warnings)
            assert any("gradient-text-headline" in w for w in slop_warnings)
        finally:
            path.unlink()

    def test_slop_is_non_blocking(self) -> None:
        # Structurally valid file with slop: warnings only, exit-equivalent valid.
        path = _write_tmp(SLOP_HTML)
        try:
            result = validate_artifact(path)
            assert result.valid
        finally:
            path.unlink()

    def test_invisible_text_blocks_build(self) -> None:
        # Contrast below 1.2:1 is an error, so the artifact is invalid.
        path = _write_tmp(
            CLEAN_HTML.replace("h1 { color: #222222; }", "h1 { color: #1a1a1a; background-color: #1e1e1e; }")
        )
        try:
            result = validate_artifact(path)
            assert not result.valid
            assert any("contrast-canary" in e for e in result.errors)
            assert not any("contrast-canary" in w for w in result.warnings)
        finally:
            path.unlink()

    def test_low_but_visible_contrast_only_warns(self) -> None:
        # 1.21:1 sits between the 1.2 error floor and the canary threshold: warning only.
        css = "h1 { color: oklch(0.30 0.02 250); background-color: oklch(0.35 0.02 250); }"
        path = _write_tmp(CLEAN_HTML.replace("h1 { color: #222222; }", css))
        try:
            result = validate_artifact(path)
            assert result.valid
            assert any("contrast-canary" in w for w in result.warnings)
        finally:
            path.unlink()

    def test_scan_shape_agnostic(self) -> None:
        # Same slop CSS flagged regardless of declared shape (report has no hero).
        path = _write_tmp(SLOP_HTML)
        try:
            for shape in ("report", "data-viz", "spec", "deck"):
                result = validate_artifact(path, shape=shape)
                assert result.checks["css_slop_clean"] is False
        finally:
            path.unlink()

    def test_oversized_file_still_scanned_fast(self) -> None:
        # The slop scanner is linear, so oversized files are scanned, not skipped.
        # Slop in an oversized file is still flagged; the size check fires
        # independently. Must complete quickly, not hang.
        import time

        path = _write_tmp(SLOP_HTML + ("x" * (501 * 1024)))
        try:
            start = time.perf_counter()
            result = validate_artifact(path)
            assert time.perf_counter() - start < 1.0
            assert result.checks["css_slop_clean"] is False
            assert not result.checks["reasonable_size"]
        finally:
            path.unlink()

    def test_oversized_single_line_does_not_hang(self) -> None:
        # Adversarial ~1MB minified single line: the old O(n^2) block regex hung.
        import time

        unit = '<div class="btn cta" style="color:#111;background:#222">x</div>'
        path = _write_tmp("<html><body>" + unit * 16000 + "</body></html>")
        try:
            start = time.perf_counter()
            validate_artifact(path)
            assert time.perf_counter() - start < 1.0
        finally:
            path.unlink()


class TestVendoredModuleParity:
    """The vendored scan_css is the same engine as the source module."""

    def test_findings_match_direct_scan(self) -> None:
        findings = scan_css(SLOP_HTML)
        rule_ids = {f.rule_id for f in findings}
        assert "transition-all" in rule_ids
        assert "gradient-text-headline" in rule_ids

    def test_clean_css_no_findings(self) -> None:
        assert scan_css(CLEAN_HTML) == []


class TestStampEmission:
    """assemble-template.py emits a parseable vexjoy-artifact stamp."""

    def test_stamp_present_and_parseable(self) -> None:
        html = assemble_template("spec", "Test")
        m = STAMP_RE.search(html)
        assert m is not None
        assert m.group(1) == "spec"
        assert m.group(2) == "birchline"
        assert m.group(3) == "n/a"

    def test_stamp_is_first_css_comment(self) -> None:
        html = assemble_template("report", "Test")
        style_open = html.index("<style>")
        first_comment = html.index("/*", style_open)
        assert html[first_comment:].startswith("/* vexjoy-artifact:")

    def test_stamp_reflects_theme_override(self) -> None:
        html = assemble_template("spec", "Test", theme="dark-focus")
        m = STAMP_RE.search(html)
        assert m is not None
        assert m.group(2) == "dark-focus"

    def test_stamp_per_shape_default_theme(self) -> None:
        html = assemble_template("code-review", "Test")
        m = STAMP_RE.search(html)
        assert m is not None
        assert m.group(1) == "code-review"
        assert m.group(2) == "dark-focus"

    def test_stamp_survives_validation_as_clean(self) -> None:
        # The stamp itself must not trip any slop rule.
        html = assemble_template("report", "Stamped")
        path = _write_tmp(html)
        try:
            result = validate_artifact(path)
            stamp_warnings = [w for w in result.warnings if "vexjoy-artifact" in w]
            assert stamp_warnings == []
        finally:
            path.unlink()
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