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/performance-optimization.md

View on GitHub
# Web Performance Optimization

Optimize web loading, JavaScript runtime, rendering, memory, bundles, and Next.js SSR/SSG by measured user impact. Use RUM, synthetic monitoring, and performance budgets.

Not for: backend or algorithmic performance in a specific language (the `programming` skill); MCP server development. Only web and frontend runtime and load performance. Animation render cost (compositor-safe properties, `will-change`): `distinctive-frontend-design-refs/performance-budgets.md`.

## Verification STOP blocks

- **Before optimizing:** STOP. Give baseline metrics (LCP, FID, CLS, bundle size) with the measurement source. Optimization without a baseline is guessing.
- **After each optimization:** STOP. Give before/after metrics for that change. "It should be faster" is not evidence; show the numbers.
- **Before reporting done:** STOP. Every recommendation has metric, baseline, target, and evidence source. Without numbers it is an opinion.

## Output contract

Every recommendation carries all four fields; omitting one makes it unverifiable:

- **Metric:** what is measured (LCP, bundle size, FID).
- **Baseline:** current value with source ("3.2s via Lighthouse").
- **Target:** numeric goal ("<=2.5s").
- **Evidence:** how the improvement was or will be measured.

## Hard rules (always apply)

- **Profile before optimizing.** Measure with real data first; no guessing or premature optimization.
- **Core Web Vitals thresholds:** LCP <=2.5s, FID <=100ms, CLS <=0.1 are the non-negotiable "good" targets.
- **RUM over synthetic** when they conflict; real user experience beats lab conditions.
- **Bundle size validation:** every recommendation includes before/after bundle analysis (webpack-bundle-analyzer or equivalent).
- **Regression prevention:** performance budgets with automated CI/CD checks.

## Defaults (on unless disabled)

- `web-vitals` tracking for Core Web Vitals with sampling and reporting.
- Intersection-observer lazy loading for images, components, and below-fold content.
- Route- and component-based code splitting for bundles over 200KB.
- Budget recommendations from industry standards (total JS <200KB, images <500KB).
- Actionable reports with file references, size impact, and priority.

## Optional (off unless enabled)

- Aggressive service worker caching (adds cache-invalidation complexity).
- Responsive images in multiple formats (WebP, AVIF) with `srcset`.
- Lighthouse CI regression detection.
- Deep dependency-tree analysis for duplicate modules and `splitChunks` tuning.

## Scope and limits

Profile web apps, analyze webpack dependencies, prioritize resources, fix loading and runtime bottlenecks. Assess compression, caching, and CDN delivery from the client side; infrastructure changes need the right specialist.

Limits: no guaranteed scores (devices, networks, and usage vary); no optimization without profiling data; no server or CDN configuration changes; no predicting future performance. When asked for guarantees, explain that the work is measurement-driven and results depend on real usage, while the fixes follow proven practice.

For test work, use the `testing` skill.

## Output format

Implementation schema ([output-schemas.md](../../../shared-patterns/output-schemas.md)):

````markdown
## Performance Optimization: [Component/Feature]

### Current Baseline Metrics

| Metric | Before | Threshold | Status |
|--------|--------|-----------|--------|
| LCP | X.Xs | ≤2.5s | ❌ POOR |
| FID | Xms | ≤100ms | ✅ GOOD |
| CLS | X.XX | ≤0.1 | ⚠️ NEEDS IMPROVEMENT |
| Bundle Size | XKB | <200KB | ❌ EXCEEDS |

### Optimizations Implemented

1. **[Optimization Name]**
   - **Change**: [What was changed]
   - **Impact**: [Metric improvement]
   - **File**: `path/to/file.ts:line`

### After Optimization Metrics

| Metric | Before | After | Improvement | Status |
|--------|--------|-------|-------------|--------|
| LCP | X.Xs | Y.Ys | -Z% | ✅ GOOD |
| FID | Xms | Yms | -Z% | ✅ GOOD |
| CLS | X.XX | Y.YY | -Z% | ✅ GOOD |
| Bundle Size | XKB | YKB | -ZKB | ✅ WITHIN BUDGET |

### Performance Budget

```json
{
  "js": { "max": 200, "current": 180 },
  "css": { "max": 50, "current": 35 },
  "images": { "max": 500, "current": 420 }
}
```

### Next Steps

- [ ] Monitor RUM data for 7 days
- [ ] Verify improvements on slow networks
- [ ] Update performance budgets in CI/CD
````

## Common errors

| Error | Cause | Fix |
|---|---|---|
| Premature optimization without baseline | Changing code before measuring | STOP. Profile first: `lighthouse`, `webpack-bundle-analyzer`, RUM. Get baselines before changes |
| RUM vs synthetic conflict | Lighthouse good, real users slow | Prioritize RUM; check network, device, and geography in RUM. Synthetic only approximates |
| Bundle size regression | Optimization added dependencies | Run the analyzer before and after. If the bundle grew, find another approach or justify the trade-off |

## Preferred patterns

| Instead of | Why wrong | Do |
|---|---|---|
| Changing code without measuring | No view of what is slow, may fix the wrong thing, cannot prove improvement | Profile with Lighthouse, RUM, bundle analyzer; find real bottlenecks |
| Micro-optimizations while big bundles and slow images remain | Negligible gains, misses real impact | Fix measurable bottlenecks: large bundles, unoptimized images, blocking resources |
| "Lighthouse is 95, performance is fine" while users complain | Lab tests miss slow networks and old devices | RUM with `web-vitals`; prioritize p75/p95 from real users |

Full catalog with detection and fixes: `performance-optimization/preferred-patterns.md`.

## Anti-rationalization

| Rationalization | Why it's wrong | Required action |
|---|---|---|
| "Looks fast enough" | Subjective without data | Profile with real metrics |
| "Lighthouse score is good" | Lab is not real users | Implement RUM tracking |
| "Small optimization, skip measurement" | Cannot prove improvement | Before/after metrics required |
| "Users won't notice X ms" | Delays add up | Optimize all measured bottlenecks |
| "It's the user's slow device" | You cannot control devices; optimize for them | Optimize for p75/p95 devices |
| "Bundle size doesn't matter with fast networks" | Many users have slow networks | Enforce bundle budgets |

## Hard gate patterns

On any of these: STOP, report the issue, fix with the correct approach.

| Pattern | Why blocked | Correct approach |
|---|---|---|
| Arbitrary `setTimeout`/delays | Masks timing issues | Proper async/await or event-driven patterns |
| Main thread blocked >50ms | Poor FID | Chunk work, web workers, or `requestIdleCallback` |
| Layout shifts from dynamic content | Poor CLS | Reserve space with `aspect-ratio` or explicit dimensions |
| Unoptimized images >500KB | Slow LCP | Next.js Image, responsive images, modern formats |
| Bundle >200KB without code splitting | Slow initial load | Route-based code splitting |

## 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 |
|---|---|---|
| No baseline metrics | Cannot measure improvement | "Should I run profiling to get baseline metrics first?" |
| RUM vs synthetic conflict | User decides priority | "RUM shows slow, Lighthouse shows fast - which to prioritize?" |
| Performance vs feature trade-off | Business decision | "Feature X adds 50KB - acceptable trade-off?" |
| Budget vs target conflict | User sets priorities | "Can't meet both <200KB budget and <2.5s LCP - which is priority?" |

Decide explicitly first: budget limits, acceptable trade-offs, target device and network profile, whether to add service workers.

## Reference loading table

Load on demand; each holds patterns, code, and quantified impact.

| Signal | Load | Content |
|---|---|---|
| async, waterfall, parallel, Promise.all, fetch, Suspense, streaming, API route | `performance-optimization/react-async-patterns.md` | CRITICAL: 6 waterfall elimination patterns |
| bundle, import, code split, tree shaking, barrel file, lazy load, dynamic import, third-party script | `performance-optimization/react-bundle-optimization.md` | CRITICAL: 5 bundle size patterns |
| render, CLS, layout shift, hydration, SVG, content-visibility, script defer, conditional render, resource hint, Activity, useTransition | `performance-optimization/react-rendering-performance.md` | MEDIUM: 10 rendering patterns |
| Set, Map, array, loop, sort, flatMap, early return, index map, cache | `performance-optimization/js-algorithm-optimizations.md` | LOW-MEDIUM: 10 algorithm and data structure fixes |
| DOM, CSS, requestIdleCallback, localStorage, RegExp, batch reads, batch writes | `performance-optimization/browser-dom-optimizations.md` | LOW-MEDIUM: 4 browser and DOM hot-path fixes |
| INP, FID, sendBeacon, web-vitals, RUM, sampling, attribution, metric reporting | `performance-optimization/metrics-and-monitoring.md` | CRITICAL: INP setup, detection patterns, metric-collection error fixes |
| Next.js, App Router, next/image, next/font, streaming, ISR, revalidate, Server Component, dynamic | `performance-optimization/nextjs-optimization.md` | CRITICAL: Next.js 13.4+ performance patterns with detection |
| Lighthouse CI, performance budget, lhci, size-limit, CI/CD performance, regression, synthetic | `performance-optimization/performance-testing.md` | HIGH: Lighthouse CI setup, assertions, bundle gates, CI config |
| Core Web Vitals implementation, LCP optimization, FID reduction, CLS fixes, web-vitals library | `performance-optimization/core-web-vitals.md` | CRITICAL: Core Web Vitals patterns and thresholds |
| webpack analyzer, chunk optimization, splitChunks, bundle analysis | `performance-optimization/bundle-optimization.md` | HIGH: bundle analysis and splitting strategies |
| pattern examples, premature optimization, ignoring RUM, blocking main thread | `performance-optimization/preferred-patterns.md` | MEDIUM: pattern catalog with detection and fixes |
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