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
npx skills add plugin87/ux-ui-agent-skills --skill performance -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/performance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/performance/
1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill performance -a codex2Manually: put the files in place
.agents/skills/performance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill performance -a cursor2Manually: put the files in place
.cursor/skills/performance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install plugin87/ux-ui-agent-skills .claude/skills/performance2Manually: put the files in place
.github/skills/performance/SKILL.md1Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill performance -a gemini-cli2Platform CLI
gemini skills install https://github.com/plugin87/ux-ui-agent-skills --path .claude/skills/performanceManually: put the files in place
.devin/skills/performance/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add plugin87/ux-ui-agent-skills --skill performance -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.