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/validate-artifact.py

View on GitHub
#!/usr/bin/env python3
"""Post-generation HTML artifact validator.

Deterministic quality checker for generated .html files. Validates structure,
self-containment, and minimum quality requirements.

Exit codes:
    0: all checks pass (warnings OK)
    1: one or more errors
    2: file not found or not readable

Usage:
    python3 skills/frontend/frontend/scripts-html-artifact/validate-artifact.py path/to/artifact.html
    python3 skills/frontend/frontend/scripts-html-artifact/validate-artifact.py artifact.html --json-compact
    python3 skills/frontend/frontend/scripts-html-artifact/validate-artifact.py artifact.html --shape editor
"""

from __future__ import annotations

import argparse
import json
import re
import sys
from dataclasses import dataclass, field
from importlib import import_module
from pathlib import Path

MAX_FILE_SIZE_BYTES = 500 * 1024  # 500KB


@dataclass
class ValidationResult:
    """Aggregate validation result."""

    checks: dict[str, bool] = field(default_factory=dict)
    warnings: list[str] = field(default_factory=list)
    errors: list[str] = field(default_factory=list)

    @property
    def valid(self) -> bool:
        """True if no errors (warnings are acceptable)."""
        return len(self.errors) == 0

    def to_dict(self) -> dict[str, object]:
        """Serialize to output dict."""
        return {
            "valid": self.valid,
            "checks": self.checks,
            "warnings": self.warnings,
            "errors": self.errors,
        }


def _check_doctype(content: str, result: ValidationResult) -> None:
    """File must start with <!DOCTYPE html> (case-insensitive)."""
    stripped = content.lstrip()
    passed = stripped.lower().startswith("<!doctype html>")
    result.checks["has_doctype"] = passed
    if not passed:
        result.errors.append("Missing <!DOCTYPE html> at start of file.")


def _check_title(content: str, result: ValidationResult) -> None:
    """Must contain <title> tag with non-empty content."""
    match = re.search(r"<title[^>]*>(.*?)</title>", content, re.IGNORECASE | re.DOTALL)
    passed = match is not None and match.group(1).strip() != ""
    result.checks["has_title"] = passed
    if not passed:
        result.errors.append("Missing or empty <title> tag.")


def _check_self_contained(content: str, result: ValidationResult) -> None:
    """No external stylesheet links or script sources via http(s)."""
    has_external_css = bool(
        re.search(r'<link[^>]+rel=["\']stylesheet["\'][^>]+href=["\']https?://', content, re.IGNORECASE)
    )
    has_external_js = bool(re.search(r'<script[^>]+src=["\']https?://', content, re.IGNORECASE))
    passed = not has_external_css and not has_external_js
    result.checks["self_contained"] = passed
    if not passed:
        externals = []
        if has_external_css:
            externals.append("external CSS")
        if has_external_js:
            externals.append("external JS")
        result.errors.append(f"Not self-contained: found {', '.join(externals)}.")


_HEADING_TAG_RE = re.compile(r"<h[1-3][\s>]", re.IGNORECASE)
_FONT_FACE_RE = re.compile(r"@font-face\s*\{[^}]*\}", re.IGNORECASE)
_HEADING_FACE_RE = re.compile(r"""font-family\s*:\s*["']?Archivo Black["']?""", re.IGNORECASE)
_HEADING_USE_RE = re.compile(
    r"""(?:font-family|font)\s*:[^;}]*(?:["']Archivo Black["']|var\(--font-heading\))""", re.IGNORECASE
)


def _check_heading_font(content: str, result: ValidationResult) -> None:
    """Pages with h1-h3 must embed Archivo Black as a data: URL and apply it to headings."""
    if not _HEADING_TAG_RE.search(content):
        result.checks["heading_font"] = True
        return
    faces = [f for f in _FONT_FACE_RE.findall(content) if _HEADING_FACE_RE.search(f)]
    embedded = any("url(data:" in f.replace(" ", "") for f in faces)
    applied = bool(_HEADING_USE_RE.search(_FONT_FACE_RE.sub("", content)))
    result.checks["heading_font"] = embedded and applied
    if not embedded:
        result.errors.append(
            "Headings need an embedded Archivo Black @font-face with a data: URL; inline templates/fonts/archivo-black.css."
        )
    elif not applied:
        result.errors.append("Archivo Black is embedded but no rule applies it; use font-family: var(--font-heading).")


def _check_has_style(content: str, result: ValidationResult) -> None:
    """Must contain <style> tag (inline CSS required)."""
    passed = bool(re.search(r"<style[\s>]", content, re.IGNORECASE))
    result.checks["has_style"] = passed
    if not passed:
        result.warnings.append("No <style> tag found. Inline CSS is recommended.")


def _check_meta_viewport(content: str, result: ValidationResult) -> None:
    """Should contain <meta name="viewport" ...>."""
    passed = bool(re.search(r'<meta\s+name=["\']viewport["\']', content, re.IGNORECASE))
    result.checks["has_meta_viewport"] = passed
    if not passed:
        result.warnings.append('Missing <meta name="viewport"> tag.')


def _check_reasonable_size(file_path: Path, result: ValidationResult) -> None:
    """File size must be under 500KB."""
    size = file_path.stat().st_size
    passed = size < MAX_FILE_SIZE_BYTES
    result.checks["reasonable_size"] = passed
    if not passed:
        size_kb = size / 1024
        result.warnings.append(f"File size {size_kb:.0f}KB exceeds 500KB limit.")


def _check_no_empty_body(content: str, result: ValidationResult) -> None:
    """<body> must contain more than whitespace."""
    match = re.search(r"<body[^>]*>(.*?)</body>", content, re.IGNORECASE | re.DOTALL)
    if match is None:
        # No body tag at all — valid_structure will catch this
        passed = False
    else:
        passed = match.group(1).strip() != ""
    result.checks["no_empty_body"] = passed
    if not passed:
        result.errors.append("Empty <body> — no visible content.")


def _check_valid_structure(content: str, result: ValidationResult) -> None:
    """Must have <html>, <head>, <body> tags."""
    has_html = bool(re.search(r"<html[\s>]", content, re.IGNORECASE))
    has_head = bool(re.search(r"<head[\s>]", content, re.IGNORECASE))
    has_body = bool(re.search(r"<body[\s>]", content, re.IGNORECASE))
    passed = has_html and has_head and has_body
    result.checks["valid_structure"] = passed
    if not passed:
        missing = []
        if not has_html:
            missing.append("<html>")
        if not has_head:
            missing.append("<head>")
        if not has_body:
            missing.append("<body>")
        result.errors.append(f"Missing structural tags: {', '.join(missing)}.")


def _check_emitted_css_slop(content: str, result: ValidationResult) -> None:
    """Scan emitted CSS/markup for slop patterns via the vendored slop rules.

    Warning-severity findings are advisory. Error-severity findings (today only
    contrast-canary below 1.2:1, text that is effectively invisible) fail the build.

    Shape-agnostic: the rules check CSS/markup, not page structure, so they apply
    to every artifact shape (including hero-less shapes like report or data-viz).

    Scans every size. The slop rules are linear (the block scanner is anchored on
    "{", not the old O(n^2) "[^{}]*" pre-brace run that hung on minified single
    lines), so there is no ReDoS reason to cap by size. Oversized files are still
    flagged independently by the reasonable_size check.
    """
    sys.path.insert(0, str(Path(__file__).parent))
    slop = import_module("css_slop_rules")
    findings = slop.scan_css(content)
    result.checks["css_slop_clean"] = not findings
    for f in findings:
        target = result.errors if f.severity == "error" else result.warnings
        target.append(f"CSS slop [{f.rule_id}] line {f.line}: {f.message}")


EXPORT_SHAPES = frozenset({"editor", "prototype"})


def _check_export_button(content: str, shape: str, result: ValidationResult) -> None:
    """For editor/prototype shapes, check for copy/export functionality in scripts.

    This is a warning, not an error — the shape context isn't always available.
    """
    if shape not in EXPORT_SHAPES:
        return

    # Look for export/copy patterns in <script> blocks
    script_blocks = re.findall(r"<script[^>]*>(.*?)</script>", content, re.IGNORECASE | re.DOTALL)
    script_content = " ".join(script_blocks)

    has_clipboard = "navigator.clipboard" in script_content
    has_copy_func = "copyToClipboard" in script_content
    has_copy = bool(re.search(r"\bcopy\b", script_content, re.IGNORECASE))

    passed = has_clipboard or has_copy_func or has_copy
    result.checks["has_export_button"] = passed
    if not passed:
        result.warnings.append(
            f"Shape '{shape}' should include copy/export functionality "
            "(navigator.clipboard, copyToClipboard, or copy function)."
        )


def validate_artifact(file_path: Path, shape: str | None = None) -> ValidationResult:
    """Run all validation checks on an HTML artifact file.

    Args:
        file_path: Path to the .html file to validate.
        shape: Optional artifact shape. When provided, enables shape-specific checks.

    Returns:
        ValidationResult with all check outcomes.
    """
    result = ValidationResult()
    content = file_path.read_text(encoding="utf-8")

    _check_doctype(content, result)
    _check_title(content, result)
    _check_self_contained(content, result)
    _check_heading_font(content, result)
    _check_has_style(content, result)
    _check_meta_viewport(content, result)
    _check_reasonable_size(file_path, result)
    _check_no_empty_body(content, result)
    _check_valid_structure(content, result)
    _check_emitted_css_slop(content, result)

    if shape is not None:
        _check_export_button(content, shape, result)

    return result


def main() -> None:
    """CLI entry point."""
    parser = argparse.ArgumentParser(description="Validate a generated HTML artifact.")
    parser.add_argument("file", help="Path to the .html file to validate.")
    parser.add_argument("--json-compact", action="store_true", help="Output compact JSON (no indentation).")
    parser.add_argument(
        "--shape", default=None, help="Artifact shape for shape-specific checks (e.g., editor, prototype)."
    )
    args = parser.parse_args()

    file_path = Path(args.file)

    if not file_path.is_file():
        error_result = {"valid": False, "checks": {}, "warnings": [], "errors": [f"File not found: {args.file}"]}
        indent = None if args.json_compact else 2
        json.dump(error_result, sys.stdout, indent=indent)
        sys.stdout.write("\n")
        sys.exit(2)

    try:
        result = validate_artifact(file_path, shape=args.shape)
    except (OSError, UnicodeDecodeError) as e:
        error_result = {"valid": False, "checks": {}, "warnings": [], "errors": [f"Cannot read file: {e}"]}
        indent = None if args.json_compact else 2
        json.dump(error_result, sys.stdout, indent=indent)
        sys.stdout.write("\n")
        sys.exit(2)

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

    sys.exit(0 if result.valid else 1)


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