Skip to main content
skill CX Codex

performance · plugin87 — Claude Code skill: Core Web Vitals and setup

This Claude Code skill guides UI performance work against Core Web Vitals. It activates for slow interactions, animation jank, layout shifts, and loading problems.

MIT 562 installs ★ 3,216 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add plugin87/ux-ui-agent-skills --skill performance -a claude-code
Open on GitHub

What performance does

The skill lays out a process for diagnosing interface performance and changing loading behavior, layout, and animation. Its targets are LCP ≤ 2.5s, INP ≤ 200ms, and CLS ≤ 0.1; measurements use a mid-tier mobile profile with slow 4G and 4× CPU throttling.

Its guidance covers splitting code by route and heavy widget, deferring below-the-fold content, reserving space for media, and limiting animation to transform and opacity. It also accounts for prefers-reduced-motion and design-system runtime cost.

Full operation requires the UX/UI Agent Skills kit, including its gates, references, and design-system library. Installing just the skill folder with npx skills add leaves it in guidance-only mode: gates do not run, so it returns no verdict.

What it helps with

  • bring LCP, INP, and CLS within their budgets
  • prevent layout shifts during page loading
  • reduce delays from heavy widgets
  • remove animation jank on low-end devices

Example prompts for the agent

  • Check this interface against LCP, INP, and CLS targets.
  • Find what causes the layout to shift while the page loads.
  • Improve mobile responsiveness under slow 4G and 4× CPU throttling.

How to install performance

1Skills CLI (Vercel)

npx skills add plugin87/ux-ui-agent-skills --skill performance -a claude-code

2Manually: put the files in place

~/.claude/skills/performance/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/performance/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about performance

How do I install performance in Claude Code?

Run npx skills add plugin87/ux-ui-agent-skills --skill performance -a claude-code. The skill file is placed at ~/.claude/skills/performance/SKILL.md.

What does performance do?

It guides UI checks against Core Web Vitals and suggests changes to loading, layout stability, and animation responsiveness.

What does performance need to work?

Full operation needs the UX/UI Agent Skills kit, with its gates, references, and design-system library. Install it with npx [email protected] init; adding only the skill folder with npx skills add does not run the gates.

Source text

SKILL.md · MIT
---
name: performance
description: Optimize UI performance against Core Web Vitals (LCP, INP, CLS) with loading/code-split strategy, layout-shift prevention, and animation performance rules. Use when the user wants to improve speed, fix jank or layout shift, hit Web Vitals budgets, or make a UI feel fast on low-end devices.
---

# Skill: Performance

## Requirements

This skill needs the full UX/UI Agent Skills kit: the gates, the references and
the design-system library. Install it with `npx [email protected] init`
or as the Claude Code plugin. `npx [email protected] add` copies the skill folder and
nothing else. Installed that way, this skill runs in **guidance-only mode**: no gate
runs, so it gives no verdict.

> **Step 0: is the kit here?** Check once:
> `ls ${CLAUDE_SKILL_DIR}/../../../tokens >/dev/null 2>&1 && echo KIT_OK || echo KIT_MISSING`
> On `KIT_MISSING`, open your reply with: "Guidance-only mode: the UX/UI Agent
> Skills kit is not installed here, so no gate ran and nothing below is
> measured." Then work from this file and general practice, under three rules.
> Do not guess or cite the contents of a kit file you could not open. State no
> measured number (no contrast ratio, no N/N, no "passes WCAG"): write "not
> verified" where one would go. End with a line `Skipped (kit not installed):`
> that names every gate script this file tells you to run, then the install
> command above.

Make the UI fast and stable. Treat performance as an accessibility concern: slow/janky UIs fail low-end devices first.

## Steps
1. Read `${CLAUDE_SKILL_DIR}/../../../workflows/performance.md` (Core Web Vitals targets, loading strategy, layout-shift, animation perf, design-system runtime cost).
2. Diagnose against budgets: **LCP ≤ 2.5s**, **INP ≤ 200ms**, **CLS ≤ 0.1**. Measure on a mid-tier mobile profile (throttle slow 4G + 4× CPU).
3. Loading: render above-fold first (SSR/Server Components), code-split by route + heavy widget, lazy-load below-fold/behind-interaction (Astro islands / Qwik), preload one critical font weight, modern responsive images.
4. Kill layout shift: size skeletons to final dimensions, reserve media space via `aspect-ratio` (`${CLAUDE_SKILL_DIR}/../../../tokens/sizing.json`), never inject content above existing.
5. Animation: only `transform`/`opacity`, `will-change` sparingly, 100-300ms (`${CLAUDE_SKILL_DIR}/../../../tokens/motion.json`), honor `prefers-reduced-motion`. Prefer CSS state styling over JS for low INP; tree-shake/per-component imports.

## Verification (definition of done)
- Lighthouse / field data meets LCP ≤ 2.5s, INP ≤ 200ms, CLS ≤ 0.1 on mid-tier mobile.
- First interaction stays responsive under slow-4G + 4× CPU throttle.
- Skeletons + media reserve space (zero CLS on load); no non-compositor animation in loops.

© plugin87 · MIT · plugin87/ux-ui-agent-skills

Similar skills

All skills for Frontend and UI →

performance by other authors comes first.

performance millionco This skill measures React runtime performance for one repeatable interaction and ties browser delays to component renders. CX Codex +1 314installs performance daveebbelaar performance — a skill for Claude Code that measures CPU, memory, and energy usage in macOS apps. It identifies causes of freezes and helps offload tasks from the main thread to the GPU. CX Codex +1 1,000installs performance rshankras performance diagnoses slow apps, hangs, and memory leaks using Instruments; spots unnecessary SwiftUI re-renders and view identity issues. CX Codex +1 212installs performance OrchestKit This skill helps diagnose slow web pages, React renders, backend requests, and LLM inference across a performance review. CX Codex +1 233installs performance cognitedata performance is a Claude Code skill that finds and fixes performance issues in Flows apps. It activates for requests about slow pages, re-renders, CDF queries, bundles, or memory leaks. CX Codex +1 1,900installs core-web-vitals-tuner patricio0312rev core-web-vitals-tuner provides step-by-step code patterns to improve LCP, INP, and CLS scores. Helps tune frontend performance for Core Web Vitals audits. CX Codex +1 322installs core-web-vitals web-quality-skills core-web-vitals is a Claude Code skill that helps improve LCP, INP, and CLS using field data and browser traces. It activates for Core Web Vitals issues, including layout shifts. CX Codex +1 36,500installs performance-optimization official github The performance-optimization rule helps spot web performance issues tied to Core Web Vitals and review possible fixes. Use it when working on page loading, rendering, or layout stability. CX Codex +1 ★ 41,430repo stars performance-and-web-vitals dembrandt The performance-and-web-vitals skill guides Lighthouse audits and Core Web Vitals fixes across LCP, CLS, and INP. It provides rules to optimize images, fonts, scripts, and layout shifts. CX Codex +1 1,200installs web-performance-audit secondsky web-performance-audit — a skill that audits page speed: pulls Core Web Vitals, finds bottlenecks and points at what to fix. Useful when LCP or CLS drifts out of range. CX Codex +1 553installs cloudflare-web-perf podo cloudflare-web-perf audits Core Web Vitals, render-blocking assets, and Lighthouse performance scores. It diagnoses and fixes LCP, INP, and CLS bottlenecks using Chrome DevTools traces. CX Codex +1 221installs

From the same set35

The whole set →
ux-writing The ux-writing Claude Code skill writes and reviews interface copy. It covers buttons, errors, empty states, notifications, and microcopy reviews. CX Codex +1 601installs brandkit The brandkit Claude Code skill builds a brand design system from a brief, including tokens, light and dark themes, and a shared theme.css. Ask for a new product foundation or a themeable token set to trigger it. CX Codex +1 594installs migrate-design-system migrate-design-system — a skill for Claude Code that maps token systems to external design systems. Converts and aligns primitives across Material Design 3, Apple HIG, Carbon, or shadcn/ui. CX Codex +1 564installs prototype A skill for Claude Code guides an idea from content through wireframes and prototypes to code, with a validation plan at each stage. It activates for prototyping, user-flow mapping, or usability-test planning and execution. CX Codex +1 563installs token-build Claude Code skill for running design token build pipelines. Converts DTCG JSON tokens into web styles, iOS catalogs, and Android themes. CX Codex +1 555installs figma-integration The figma-integration Claude Code skill connects a project’s tokens and components with Figma, syncing in either direction and checking for design-code drift. It activates for token sync, design extraction, or component parity checks. CX Codex +1 554installs governance governance — a skill for Claude Code and Codex that enforces design system evolution rules, SemVer token versioning, and component deprecation workflows. CX Codex +1 549installs accessibility Checks interactive elements against core accessibility requirements. Use it during UI audits or when completing a component. CX Codex +1 ★ 3,216repo stars

Project sponsors

Companies that keep this analytics open