perf-web-optimization — скилл для Claude Code: обзор и установка
Скилл perf-web-optimization помогает оптимизировать загрузку веб-страниц: настраивает отложенную загрузку, сокращает размер бандла и выставляет кэш. Пригодится при медленной работе сайта или тяжёлом JS.
MIT ★ 7 191 обновлён 2026-10-24
npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a claude-codeЧто делает perf-web-optimization
Скилл выстраивает оптимизацию по цепочке: замер, выявление узких мест, приоритизация, внедрение и проверка. Он ориентируется на целевые показатели LCP до 2.5 секунд, INP до 200 миллисекунд и CLS ниже 0.1. На практике агент прописывает для главного изображения loading="eager" вместе с fetchpriority="high", задаёт фиксированные width и height против скачков вёрстки и блокирует ранний запуск сторонних скриптов до первого клика или скролла.
Внутрь заложены правила работы со сборщиками и шаблоны разделения кода для React lazy и Next.js dynamic. Скилл находит тяжёлые пакеты вроде moment (67KB) или lodash (72KB) и предлагает заменить их на date-fns, dayjs либо нативные методы браузера. Для настройки раздачи статики он формирует заголовки Cache-Control с параметром immutable.
Запускать аудит Lighthouse или настраивать проекты на Astro через этот скилл не стоит. Для замеров автор прямо рекомендует perf-lighthouse, а для специфики фреймворка Astro выделил навык perf-astro.
Какие задачи решает
- ускорить загрузку главного контента (LCP) через приоритетные изображения и шрифты
- сократить размер JavaScript-бандла заменой тяжёлых библиотек
- устранить сдвиги макета (CLS) явным указанием размеров картинок
- отложить выполнение сторонних скриптов до взаимодействия с пользователем
- прописать правила Cache-Control для неизменяемой статики и API
Примеры запросов агенту
- Проверь package.json и предложи компактные альтернативы для тяжёлых зависимостей
- Оптимизируй загрузку hero-картинки и шрифтов на посадочной странице
- Настрой заголовки Cache-Control для статических файлов и API-маршрутов
Как установить perf-web-optimization
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a claude-code2Вручную: положить файлы
~/.claude/skills/perf-web-optimization/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/perf-web-optimization/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a codex2Вручную: положить файлы
.agents/skills/perf-web-optimization/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a cursor2Вручную: положить файлы
.cursor/skills/perf-web-optimization/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(performance)/perf-web-optimization'2Вручную: положить файлы
.github/skills/perf-web-optimization/SKILL.md1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a gemini-cli2Командой платформы
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(performance)/perf-web-optimization'Вручную: положить файлы
.devin/skills/perf-web-optimization/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о perf-web-optimization
Как установить perf-web-optimization в Claude Code?
Выполните команду npx skills add tech-leads-club/agent-skills --skill perf-web-optimization -a claude-code.
Что делает скилл perf-web-optimization?
Он направляет процесс ускорения сайта: даёт паттерны загрузки изображений, снижает объём сборки JS, откладывает второстепенные скрипты и генерирует заголовки браузерного кэширования.
Подходит ли этот скилл для запуска тестов Lighthouse?
Нет, для выполнения тестов и анализа отчётов Lighthouse автор предусмотрел отдельный скилл perf-lighthouse.
Исходный текст
SKILL.md · MIT
---
name: perf-web-optimization
description: 'Optimize web performance: bundle size, images, caching, lazy loading, and overall page speed. Use when site is slow, reducing bundle size, fixing layout shifts, improving Time to Interactive, or optimizing for Lighthouse scores. Triggers on: web performance, bundle size, page speed, slow site, lazy loading. Do NOT use for Core Web Vitals-specific fixes (use core-web-vitals), running Lighthouse audits (use perf-lighthouse), or Astro-specific optimization (use perf-astro).'
---
# Web Performance Optimization
Systematic approach: Measure → Identify → Prioritize → Implement → Verify.
## Target Metrics
| Metric | Good | Needs Work | Poor |
| ------ | ------- | ---------- | ------- |
| LCP | < 2.5s | 2.5-4s | > 4s |
| INP | < 200ms | 200-500ms | > 500ms |
| CLS | < 0.1 | 0.1-0.25 | > 0.25 |
| TTFB | < 800ms | 800ms-1.8s | > 1.8s |
## Quick Wins
### 1. Images (usually biggest impact on LCP)
```html
<!-- Hero/LCP image: eager + high priority -->
<img src="/hero.webp" alt="Hero" width="1200" height="600" loading="eager" fetchpriority="high" decoding="async" />
<!-- Below fold: lazy load -->
<img src="/product.webp" alt="Product" width="400" height="300" loading="lazy" decoding="async" />
```
Always set `width` and `height` to prevent CLS.
### 2. Fonts (common LCP/CLS culprit)
```html
<!-- Preconnect to font origin -->
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<!-- Non-blocking font load -->
<link
rel="stylesheet"
href="https://fonts.googleapis.com/css2?family=Inter&display=swap"
media="print"
onload="this.media='all'"
/>
```
### 3. Third-party Scripts (common INP killer)
```html
<!-- Defer to user interaction -->
<script>
function loadThirdParty() {
// Load analytics, chat widgets, etc.
}
;['scroll', 'click', 'touchstart'].forEach((e) => addEventListener(e, loadThirdParty, { once: true, passive: true }))
setTimeout(loadThirdParty, 5000)
</script>
```
### 4. Critical CSS
Inline critical CSS in `<head>`, defer the rest:
```html
<style>
/* critical styles */
</style>
<link rel="preload" href="/styles.css" as="style" onload="this.rel='stylesheet'" />
```
## Bundle Analysis
```bash
# Webpack
npx webpack-bundle-analyzer dist/stats.json
# Vite
npx vite-bundle-visualizer
# Check package size before installing
npx bundlephobia <package-name>
```
Common heavy packages to replace:
- `moment` (67KB) → `date-fns` (12KB) or `dayjs` (2KB)
- `lodash` (72KB) → cherry-pick imports or native methods
## Code Splitting Patterns
```javascript
// React lazy
const Chart = lazy(() => import('./Chart'))
// Next.js dynamic
const Admin = dynamic(() => import('./Admin'), { ssr: false })
// Vite/Rollup manual chunks
build: {
rollupOptions: {
output: {
manualChunks: {
vendor: ['react', 'react-dom']
}
}
}
}
```
## Caching Headers
```
# Static assets (immutable hash in filename)
Cache-Control: public, max-age=31536000, immutable
# HTML (revalidate)
Cache-Control: no-cache
# API responses
Cache-Control: private, max-age=0, must-revalidate
```
## Measurement
For running audits, reading reports, and setting budgets, use the **perf-lighthouse** skill.
## Checklist
### Images
- [ ] Modern formats (WebP/AVIF)
- [ ] Responsive `srcset`
- [ ] `width`/`height` attributes
- [ ] `loading="lazy"` below fold
- [ ] `fetchpriority="high"` on LCP image
### JavaScript
- [ ] Bundle < 200KB gzipped
- [ ] Code splitting by route
- [ ] Third-party scripts deferred
- [ ] No unused dependencies
### CSS
- [ ] Critical CSS inlined
- [ ] Non-critical CSS deferred
- [ ] No unused CSS
### Fonts
- [ ] `font-display: swap`
- [ ] Preconnect to font origin
- [ ] Subset if possible
## Detailed Examples
For in-depth optimization patterns, see:
- [references/core-web-vitals.md](references/core-web-vitals.md) - Fixing LCP, CLS, INP issues
- [references/bundle-optimization.md](references/bundle-optimization.md) - Reducing JS bundle size
- [references/image-optimization.md](references/image-optimization.md) - Image formats, responsive images, sharp scripts
© tech-leads-club · MIT · tech-leads-club/agent-skills