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

references/distinctive-frontend-design-refs/macrostructure-catalog.md

View on GitHub
# Macrostructure Catalog

Named page structures. Pick exactly one `macro:*` id in Phase 1, before aesthetic
directions, and emit it as the `macrostructure` field in the spec. The macrostructure
is the categorical shape of the page — the order and role of its sections — chosen
before any color, type, or motion decision. Choosing structure first prevents every
page from collapsing into the same hero-then-three-cards template.

These are OUR names, deliberately distinct from any external catalog and from the
component terms in `vocabulary.md` (Hero, Full-bleed, Surface type). Those describe
parts; these describe whole-page skeletons.

**Lazy loading:** load only the one entry you picked, addressed by its heading anchor
(e.g. `#macrostat-led`). Reading the whole catalog wastes context — the chosen entry
carries every rule the build needs.

**Variety rule:** `validate_design.py` penalizes a macrostructure that matches either
of the last two projects (mirrors the font/palette step-down). Vary the structural
axis across consecutive builds, not just the colors.

| id | one-line when-to-use |
|---|---|
| `macro:stat-led` | a single number or proof point is the whole argument |
| `macro:long-document` | dense reading: docs, essays, legal, changelogs |
| `macro:bento` | many small features of unequal weight, shown at a glance |
| `macro:manifesto` | a point of view to argue, not a product to sell |
| `macro:split-hero` | product and its proof sit side by side, equally weighted |
| `macro:gallery-grid` | the work is visual and the images are the pitch |
| `macro:timeline` | sequence or progression is the core idea |
| `macro:comparison` | the decision is "this versus that" |
| `macro:single-focus` | one action, nothing else; capture or convert |
| `macro:dashboard` | an operator surface for live data and controls |

---

## macro:stat-led

**When to use:** one metric, result, or proof point carries the entire argument
(uptime, dollars saved, users served). Lead with the number, justify it after.

**Layout skeleton:**
1. Oversized stat block — the figure set larger than the headline, with a one-line claim under it.
2. Context strip — two or three supporting figures or a short sentence that frames the big number.
3. Evidence — how the number is earned (method, source, customer).
4. Narrative body — the story behind the figure, scannable.
5. Single call to action tied to the claim.

**Anti-cliche note:** the stat must be a real measured figure, set as type, not a
spinning odometer or count-up animation on scroll. A fabricated round number ("10x
faster") with no source reads as filler; show the actual figure and where it came from.

---

## macro:long-document

**When to use:** the value is in dense, sustained reading — documentation, an essay,
legal text, a detailed changelog. Comprehension and navigation beat visual drama.

**Layout skeleton:**
1. Title block — title, one-line summary, last-updated date.
2. Sticky table of contents (sidebar on wide screens, collapsible on mobile).
3. Body sections with stable heading anchors and generous measure (60-75ch).
4. Inline asides or callouts for warnings and tips.
5. Prev/next or related-document footer.

**Anti-cliche note:** resist breaking a reading page into floating cards or a grid.
Long-form reading wants one calm column with strong typographic hierarchy, not a
dashboard of boxes. Line length and vertical rhythm do the work here.

---

## macro:bento

**When to use:** several features of unequal importance, shown together so the eye
grasps the whole offering at a glance. The grid itself communicates relative weight.

**Layout skeleton:**
1. Short framing headline.
2. Bento grid — tiles of mixed sizes; the largest tile holds the lead feature, smaller tiles hold secondary ones.
3. Each tile: one icon-or-visual, a short label, one sentence. One job per tile.
4. Single closing action below the grid.

**Anti-cliche note:** vary tile sizes to express priority — a uniform grid of equal
cards is the templated look this structure exists to avoid. If every tile is the same
size, it is a card grid, not a bento. Give the lead feature visibly more room.

---

## macro:manifesto

**When to use:** there is a point of view to argue, a stance to take, a belief to
state — not a product to demo. Editorial weight over conversion mechanics.

**Layout skeleton:**
1. Statement — a single bold claim, full width, set large.
2. Argument sections — short numbered or titled positions, each one paragraph.
3. Pull quotes or emphasized lines that carry the through-line.
4. Signature or attribution.
5. One quiet action (subscribe, read more) — low-pressure.

**Anti-cliche note:** keep chrome minimal. Manifestos lose force when wrapped in
product-marketing furniture (badge rows, logo walls, "trusted by"). The words are the
design; let typography and whitespace carry the conviction.

---

## macro:split-hero

**When to use:** the product and its proof deserve equal weight in the first viewport —
a screenshot beside the pitch, a demo beside the claim. Neither dominates.

**Layout skeleton:**
1. Two-column first viewport: left holds headline, subhead, action; right holds the product visual or live demo.
2. Below the fold: alternating split rows, each pairing one claim with one supporting visual.
3. Proof band — logos or a single testimonial, full width.
4. Closing action.

**Anti-cliche note:** the right-hand visual must be real product, not a generic
floating-laptop mockup or abstract gradient blob. A split hero with a stock device
frame and placeholder UI signals the page has nothing real to show.

---

## macro:gallery-grid

**When to use:** the work is inherently visual — photography, design, art, physical
product — and the images themselves are the argument. Text is caption, not pitch.

**Layout skeleton:**
1. Minimal title bar — name and one line, nothing more.
2. Image grid or masonry — the dominant element; let images run large.
3. Optional filter or category strip.
4. Per-item detail on click or hover — title, short note.
5. Contact or inquiry action in the footer.

**Anti-cliche note:** let the images breathe at full strength; avoid burying them under
heavy overlays, uniform hover-zoom, or text scrims on every tile. If the grid needs
explanatory copy on each image to make sense, the images are not carrying their job.

---

## macro:timeline

**When to use:** sequence or progression is the core idea — a roadmap, a history, a
process, a journey. The order of events is the message.

**Layout skeleton:**
1. Framing headline naming the span (years, stages, steps).
2. Spine — a vertical or horizontal axis with dated or numbered nodes.
3. Each node: a moment with a short title, one-line description, optional visual.
4. Direction is unmistakable (top-to-bottom or left-to-right, never both at once).
5. Closing node that points at the present or the next step.

**Anti-cliche note:** the sequence must carry real meaning — dates, ordered stages,
causal steps. A timeline used to decorate unordered features (where the order is
arbitrary) misleads the reader; use `macro:bento` for unordered features instead.

---

## macro:comparison

**When to use:** the reader's decision is "this versus that" — plans, us-versus-them,
before-and-after. The structure exists to make the difference legible.

**Layout skeleton:**
1. Headline naming the choice.
2. Comparison table or paired columns — shared rows, one column per option.
3. Each row is one dimension; differences are visually marked, not just listed.
4. A recommended or highlighted option, clearly but fairly indicated.
5. Action per option.

**Anti-cliche note:** keep the comparison honest. A table engineered so one column wins
every row (strawman competitor, cherry-picked rows) reads as manipulative and erodes
trust. Show real trade-offs; a fair comparison persuades better than a rigged one.

---

## macro:single-focus

**When to use:** exactly one action matters — sign up, download, book, subscribe.
Everything on the page serves that one conversion; nothing competes with it.

**Layout skeleton:**
1. One headline stating the single promise.
2. One supporting line.
3. One form or one button — the only interactive focus.
4. Minimal proof (one line, one logo row) only if it lifts conversion.
5. No secondary navigation that leads away.

**Anti-cliche note:** resist adding a second competing call to action or a full nav bar
— they leak attention from the one job. If a second action feels necessary, the page is
probably trying to be two pages; split it or pick the one action that matters most.

---

## macro:dashboard

**When to use:** an operator surface — live data, controls, status. Function over
persuasion. Follows tool rules, not landing-page rules (see `skills/shared-patterns/ui-design-judgment.md` section 1).

**Layout skeleton:**
1. Top bar — product, primary context switcher, account.
2. Left navigation — sections of the app.
3. Main region — data tables, charts, or the primary work surface, dense but readable.
4. Detail panel or drawer for the selected item.
5. Status and system feedback in a consistent, quiet location.

**Anti-cliche note:** apply Linear-style restraint — calm surfaces, few colors, strong
typography, tight spacing. Decorative gradients, marketing-style hero blocks, and card
mosaics belong on landing pages; on a dashboard they add noise and hide the data the
operator came for.
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