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/react-portfolio.md

View on GitHub
# React Portfolio and Gallery Sites

React portfolios and galleries for artists and photographers (React 18+, Next.js App Router). Use functional components, hooks, composition, and the App Router Server/Client split. Prioritize image quality, loading performance, accessibility, responsive layouts, and SEO. Use code splitting, static generation, and route prefetching for portfolio pages. Compress high-resolution images and support screen readers.

Not for: carts, Stripe, or checkout (`nextjs-ecommerce.md`); general React or Next.js architecture (`typescript-frontend.md`); React Native apps (`react-native.md`); generating the artwork itself (`image-gen` skill).

## Hard rules (always apply)

- **Read before editing.** Never edit a file you have not read in this session.
- **Run build and tests before reporting done.** Run `npm run build` (or equivalent) and show the actual output. Do not summarize as "build succeeds."
- **Feature branch, never main.** If on main, create a branch before committing.
- **Verify dependencies before importing.** Check `package.json` first.
- **`next/image`** for portfolio images, never plain `img`.
- **Alt text** on every image, descriptive.
- **Responsive images:** `sizes` prop or `srcset` on all gallery images.
- **Lazy loading** for images below the fold.
- **Touch-friendly:** every gallery interaction works on touch (swipe, tap).

## Portfolio design defaults (override with a stated reason)

Let the artist's work guide the layout. For an unfamiliar genre, new artist voice, or brand reset, go deeper with DISTINCTIVE mode in this skill.

- **The work is the hero.** The first viewport shows the strongest piece at full bleed, not a row of thumbnails around a name tag. No cards in the hero.
- **One composition per section.** Hero (strongest work), Body (supporting pieces), Detail (single piece or series deep-dive), Credits (statement and contact). Do not mix "about the artist" with the gallery grid in one section.
- **Real work, not Lorem Ipsum or stock photos.** Use the actual portfolio images from day one. Placeholder images produce placeholder decisions about scale, crop, density, and color.
- **Two typefaces maximum.** Display face for titles, body face for statements. One family with weight variation is often stronger.
- **One accent color.** The artwork carries the color; extra UI color fights it.
- **Motion budget (2-3 slots):** (1) one hero entrance on load, (2) one scroll-linked effect for the body grid (cross-fade, lazy reveal, or parallax), (3) one interaction effect on image hover or lightbox open. Ambient decorative motion buries the work.
- **Tells check.** Before building, check the tells table in `skills/shared-patterns/ui-design-judgment.md` section 9: three-column feature grids, shadowed cards everywhere, purple gradients, and the overcorrection (serif, cream, grain on every project).
- **Litmus:** remove the artist's name and leave only the work. Can a new visitor describe the artist's voice in one sentence? If not, the portfolio is not communicating yet.

## Defaults (on unless disabled)

- Blur-up placeholders while images load.
- WebP/AVIF with JPEG fallback.
- URL-based category filtering (for example `?category=paintings`).
- Lightbox keyboard navigation: arrow keys and Escape.

## Optional (off unless enabled)

- Masonry layout: only when requested.
- Infinite scroll: only when pagination is not enough.
- Image zoom: only when detailed artwork viewing is needed.
- Video embedding: only when multimedia content is requested.

## Implementation details

Use CSS Grid or Flexbox for galleries. Preserve detail with responsive formats, device-specific sizes, and base64 blur placeholders. Set `priority` on above-fold images.

Lightboxes need arrow keys, Escape, swipe, adjacent-image preloading, backdrop dismissal, and focus trapping. Add pinch-zoom when detailed viewing is needed. Use sm/md/lg/xl breakpoints and fluid grids.

Add JSON-LD for artworks, Open Graph tags, semantic HTML, and meta descriptions.

Related references: visual identity, color schemes, responsive layout, and accessibility in `ui-design.md`; type-safe components and build in `typescript-frontend.md`.

Out of scope: brand design, artist bios and statements (`writing` skill), CMS setup (CMS specialist), video editing (`video-editing` skill).

## Workflow (implementation schema)

1. **ANALYZE.** Confirm real artwork is available (not Lorem Ipsum or stock). Pick the strongest piece for the full-bleed hero. Write the brief: visual thesis, content plan, interaction thesis. Identify gallery needs (grid or masonry, filtering, lightbox), image needs (formats, sizes, lazy loading), and breakpoints.
2. **DESIGN.** Component architecture (Gallery, ImageCard, Lightbox), state (filtering, lightbox), image loading strategy (priority, lazy, blur).
3. **IMPLEMENT.** Gallery components with `next/image`, URL-based filtering, lightbox with keyboard and touch navigation, responsive design and image optimization.
4. **VALIDATE.** LCP < 2.5s, accessibility (alt text, keyboard), responsive (mobile, tablet, desktop), SEO (structured data, meta tags).

## Reference loading table

| Signal | Load | Why |
|---|---|---|
| Any layout, typography, color, or visual design choice (load first) | `skills/shared-patterns/ui-design-judgment.md`, then `ui-design-recipes.md` and `ui-design-examples.md` in the same folder | Design defaults with reasons and the look-then-fix loop |
| Gallery component, filtering, image patterns, anti-rationalization table | `react-portfolio/gallery-patterns.md` | Gallery code, `next/image` priority and lazy examples, preferred patterns, anti-rationalization table |
| Lightbox implementation, keyboard/touch navigation | `react-portfolio/lightbox-patterns.md` | Full lightbox with keyboard and touch navigation |
| next/image, blur placeholders, WebP/AVIF, format config | `react-portfolio/image-optimization.md` | Image formats, blur placeholders, config |
| Breakpoints, mobile-first CSS, touch interactions | `react-portfolio/responsive-design.md` | Breakpoints and touch patterns |
| App Router pages, Server vs Client components, metadata API, URL filtering, SSG | `react-portfolio/nextjs-app-router.md` | App Router structure for portfolios |
| Portfolio LCP, CLS, INP, gallery bundle size, `priority`, `sizes` prop | `react-portfolio/performance.md` | Portfolio-specific Web Vitals fixes; general web performance is `performance-optimization.md` |
| SEO, structured data, JSON-LD, Open Graph, sitemap, social preview | `react-portfolio/portfolio-seo.md` | Artwork structured data and social previews |

## Common errors

| Error | Cause | Fix |
|---|---|---|
| Image not optimized | Plain `img` instead of `next/image` | Replace every `img` with `next/image` |
| Missing alt text | Images without `alt` | Add descriptive alt text to every Image |
| Poor LCP | Large unoptimized images, no priority | `priority` on above-fold images; lazy-load below the fold |

## Blocker criteria

Resolve routine issues from repository evidence. When you are sure, decide, record the assumption, and continue; ask Jev when genuinely unsure. Ask only when these leave a material decision open.

| Situation | Why stop | Ask |
|---|---|---|
| Masonry vs grid unclear | Different implementations | "Grid layout or masonry (Pinterest-style)?" |
| Video content needed | Different optimization | "Include video in portfolio or images only?" |
| CMS integration requested | Needs a CMS specialist | "Which CMS? (Sanity, Contentful, custom?)" |
| Animation level unclear | Simple vs complex | "Simple hover effects or complex transitions?" |

Decide explicitly before acting on: layout style, video handling, CMS platform, animation level.

Shared patterns: [anti-rationalization-core.md](../../../shared-patterns/anti-rationalization-core.md), [verification-checklist.md](../../../shared-patterns/verification-checklist.md).
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