К основному содержанию
скилл CX Codex

performance-budget-setter — скилл для Claude Code: установка

Скилл performance-budget-setter для Claude Code помогает задать бюджеты для бандлов, API, запросов к базе и времени рендера. Бюджеты фиксируют для проверки метрик в CI и мониторинге.

MIT 228 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill performance-budget-setter -a claude-code
Открыть на GitHub

Что делает performance-budget-setter

Скилл раскладывает производительность по измеримым лимитам: размер начальной загрузки, задержка API, время SQL-запросов и Core Web Vitals. Он предлагает отдельные бюджеты для страниц, сторонних скриптов и ключевых пользовательских действий, а также шаблоны для их фиксации.

Внутри есть примеры для CI/CD, bundlesize, Lighthouse CI и webpack-bundle-analyzer. Для мониторинга показаны RUM через web-vitals, синтетические проверки и дашборд с алертами. Также разобраны code splitting, кэширование, пагинация и индексы базы. Если сборка не запускается командой npm run build, показанная проверка размера не сработает: этот шаг прямо вызывает её.

Какие задачи решает

  • задать лимиты для JavaScript и CSS
  • проверить задержку API по перцентилям
  • ограничить число и время запросов к базе
  • настроить контроль Core Web Vitals
  • подключить алерты при превышении бюджета

Примеры запросов агенту

  • Задай бюджеты производительности для интернет-магазина и раздели их по бандлам, API, базе и страницам.
  • Составь проверку для CI с npm run build, npx bundlesize и Lighthouse CI.
  • Предложи план мониторинга LCP, CLS и задержки API через RUM и синтетические проверки.

Как установить performance-budget-setter

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill performance-budget-setter -a claude-code

2Вручную: положить файлы

~/.claude/skills/performance-budget-setter/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/performance-budget-setter/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о performance-budget-setter

Как установить performance-budget-setter в Claude Code?

Выполните npx skills add patricio0312rev/skills --skill performance-budget-setter -a claude-code. Файл скилла появится по пути ~/.claude/skills/performance-budget-setter/SKILL.md.

Что делает performance-budget-setter?

Он помогает определить численные бюджеты для размера бандла, API, запросов к базе и времени рендера, а затем описать проверки в CI и мониторинг.

Что нужно для проверки бюджета бандла?

В примере CI сначала запускается npm run build, затем размер проверяет npx bundlesize, а Lighthouse CI запускается через lhci autorun. Это значит, что проекту нужен рабочий production build.

Исходный текст

SKILL.md · MIT
---
name: performance-budget-setter
description: Defines measurable performance budgets for bundle size, API latency, database queries, and render times. Provides enforcement strategies and monitoring plans. Use for "performance budgets", "performance monitoring", "web vitals", or "optimization targets".
---

# Performance Budget Setter

Set and enforce performance budgets to maintain fast user experiences.

## Performance Budget Template

```markdown
# Performance Budget: E-Commerce Website

## Bundle Size Budget

| Asset Type             | Budget     | Current    | Status |
| ---------------------- | ---------- | ---------- | ------ |
| Initial JS             | 200 KB     | 185 KB     | ✅     |
| Initial CSS            | 50 KB      | 48 KB      | ✅     |
| Vendor JS              | 150 KB     | 145 KB     | ✅     |
| Fonts                  | 100 KB     | 95 KB      | ✅     |
| Images (above fold)    | 300 KB     | 320 KB     | ❌     |
| **Total Initial Load** | **800 KB** | **793 KB** | ✅     |

## API Latency Budget

| Endpoint       | p50    | p95    | p99     |
| -------------- | ------ | ------ | ------- |
| GET /products  | <100ms | <300ms | <500ms  |
| POST /checkout | <200ms | <500ms | <1000ms |
| GET /search    | <150ms | <400ms | <800ms  |

## Database Query Budget

| Query Type       | Budget | Current |
| ---------------- | ------ | ------- |
| Simple reads     | <50ms  | 42ms    |
| Complex joins    | <200ms | 185ms   |
| Aggregations     | <500ms | 450ms   |
| Queries per page | <20    | 18      |

## Core Web Vitals

| Metric                         | Good   | Poor   | Target |
| ------------------------------ | ------ | ------ | ------ |
| LCP (Largest Contentful Paint) | <2.5s  | >4.0s  | <2.0s  |
| FID (First Input Delay)        | <100ms | >300ms | <50ms  |
| CLS (Cumulative Layout Shift)  | <0.1   | >0.25  | <0.05  |

## Page-Specific Budgets

### Homepage

- Time to Interactive: <3s
- Total Blocking Time: <300ms
- Speed Index: <3s

### Product Page

- Time to Interactive: <4s
- Images loaded: <2s
- Reviews section: <1s

### Checkout

- Time to Interactive: <3s
- Payment processing: <2s
- Zero layout shifts

## Third-Party Scripts

| Service     | Budget     | Purpose          |
| ----------- | ---------- | ---------------- |
| Analytics   | 30 KB      | Google Analytics |
| Chat Widget | 50 KB      | Customer support |
| Payment     | 100 KB     | Stripe           |
| **Total**   | **180 KB** |                  |
```

## Enforcement Strategy

### 1. CI/CD Integration

```yaml
# .github/workflows/performance-budget.yml
name: Performance Budget Check

on: [pull_request]

jobs:
  budget-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Build production bundle
        run: npm run build

      - name: Check bundle size
        run: |
          npx bundlesize

      - name: Lighthouse CI
        run: |
          npm install -g @lhci/cli
          lhci autorun
```

### 2. Webpack Bundle Analyzer

```javascript
// webpack.config.js
const BundleAnalyzerPlugin =
  require("webpack-bundle-analyzer").BundleAnalyzerPlugin;

module.exports = {
  plugins: [
    new BundleAnalyzerPlugin({
      analyzerMode: process.env.ANALYZE ? "server" : "disabled",
    }),
  ],
  performance: {
    hints: "error",
    maxAssetSize: 200000, // 200 KB
    maxEntrypointSize: 400000, // 400 KB
  },
};
```

### 3. package.json Configuration

```json
{
  "bundlesize": [
    {
      "path": "./dist/js/main.*.js",
      "maxSize": "200 KB"
    },
    {
      "path": "./dist/css/main.*.css",
      "maxSize": "50 KB"
    },
    {
      "path": "./dist/js/vendor.*.js",
      "maxSize": "150 KB"
    }
  ]
}
```

## Monitoring Plan

### Real User Monitoring (RUM)

```typescript
// Track Core Web Vitals
import { getCLS, getFID, getFCP, getLCP, getTTFB } from "web-vitals";

function sendToAnalytics(metric) {
  const body = JSON.stringify(metric);

  if (navigator.sendBeacon) {
    navigator.sendBeacon("/analytics", body);
  } else {
    fetch("/analytics", { body, method: "POST", keepalive: true });
  }
}

getCLS(sendToAnalytics);
getFID(sendToAnalytics);
getLCP(sendToAnalytics);
```

### Synthetic Monitoring

```bash
# Lighthouse CI
lhci autorun --config=.lighthouserc.json

# WebPageTest API
curl "https://www.webpagetest.org/runtest.php?url=https://example.com&k=API_KEY"
```

### Performance Dashboard

```markdown
**Daily Metrics:**

- Bundle size trend
- API latency percentiles
- Core Web Vitals scores
- Page load times

**Alerts:**

- Bundle size exceeds budget by 10%
- LCP >2.5s for >5% of users
- API p95 >500ms
- Any metric exceeds budget
```

## Optimization Strategies

### Reduce Bundle Size

```typescript
// Code splitting
const ProductPage = lazy(() => import("./ProductPage"));

// Tree shaking
import { specific } from "library"; // ✅
import * as library from "library"; // ❌

// Dynamic imports
if (featureFlag) {
  const module = await import("./feature");
}
```

### Optimize API Calls

```typescript
// Parallel requests
const [user, orders] = await Promise.all([fetchUser(id), fetchOrders(id)]);

// Caching
const cachedData = await redis.get(key);
if (cachedData) return cachedData;

// Pagination
const products = await db.products
  .find()
  .limit(20)
  .skip((page - 1) * 20);
```

### Optimize Database Queries

```sql
-- Add indexes
CREATE INDEX idx_orders_user_created ON orders(user_id, created_at);

-- Limit columns
SELECT id, name FROM products; -- ✅
SELECT * FROM products;        -- ❌

-- Use EXPLAIN
EXPLAIN ANALYZE SELECT ...;
```

## Budget Violation Response

### When Budget Exceeded

1. **Immediate:**

   - Block PR from merging
   - Notify team in Slack
   - Create ticket

2. **Within 24 hours:**

   - Investigate cause
   - Identify optimization opportunities
   - Propose fix or budget increase

3. **Decision:**
   - Fix code (preferred)
   - Increase budget (requires justification)

### Budget Increase Request Template

```markdown
## Budget Increase Request

**Component:** Main JS bundle
**Current Budget:** 200 KB
**Requested Budget:** 250 KB
**Reason:** Added critical feature X

**Impact Analysis:**

- Load time increase: +0.5s
- User impact: Medium
- Revenue impact: Unknown

**Alternatives Considered:**

1. Code splitting: Reduces to 210 KB (preferred)
2. Remove feature Y: Reduces to 195 KB (rejected)
3. Lazy loading: Complex, 3 weeks effort

**Recommendation:** Implement code splitting
```

## Best Practices

1. **Set realistic budgets**: Based on user data
2. **Enforce in CI**: Automated checks
3. **Monitor continuously**: RUM + synthetic
4. **Review quarterly**: Adjust as needed
5. **Prioritize UX**: User-centric metrics
6. **Document exceptions**: Why budget increased
7. **Celebrate wins**: When under budget

## Output Checklist

- [ ] Bundle size budgets defined
- [ ] API latency targets set
- [ ] Database query budgets
- [ ] Core Web Vitals targets
- [ ] Page-specific budgets
- [ ] CI/CD enforcement configured
- [ ] Monitoring dashboard
- [ ] Alert thresholds set
- [ ] Violation response process
- [ ] Regular review schedule

© patricio0312rev · MIT · patricio0312rev/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
performance-budget-guard davila7 Хук performance-budget-guard для Claude проверяет размер JS-бандла после сборки Next.js и не даёт выкатить сборку, которая вылезла за бюджет. 393установок performance-optimization rampstackco Скилл performance-optimization диагностирует скорость загрузки веб-страниц, метрики Core Web Vitals и размер бандла, предлагая чёткий план исправлений. CX Codex +1 328установок auditing-performance spencerpauly Скилл auditing-performance для Claude Code проводит аудит производительности: бандл, рендеринг, запросы к базе, Core Web Vitals. Разбирает долгую загрузку страниц и тормоза интерфейса. CX Codex +1 518установок web-performance-optimization davila7 Скилл web-performance-optimization для Claude, который помогает разобрать, почему сайт грузится медленно, и по шагам убрать узкие места. CX Codex +1 3 490установок performance-engineering travisjneuman Скилл performance-engineering для Claude Code помогает оптимизировать производительность веб-приложений. Включается при падении показателей Core Web Vitals, росте бандла и замедлении работы страниц или API. CX Codex +1 144установок react-performance affaan-m Скилл react-performance для аудита и ускорения приложений на React 18/19 и Next.js. Помогает находить сетевые водопады, сокращать размер бандла и настраивать Server Components во время код-ревью. CX Codex +1 6 700установок

Из того же набора148

Весь набор →
rag-pipeline-builder Скилл rag-pipeline-builder проектирует RAG-пайплайн для ассистента по документам: чанкинг, метаданные, гибридный поиск, реранкинг и план оценки качества. CX Codex +1 251установок preview-environments-builder Скилл preview-environments-builder генерирует пайплайны временных окружений для каждого пулл-реквеста с автоматическим развёртыванием, уникальным адресом и удалением ресурсов после закрытия PR. CX Codex +1 250установок load-test-scenario-builder Скилл load-test-scenario-builder проектирует сценарии нагрузочного тестирования, готовит k6-скрипты, профили трафика и критерии успеха для проверки пропускной способности. CX Codex +1 236установок graphql-schema-designer Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок test-data-factory-builder Скилл test-data-factory-builder для Claude Code создаёт фабрики и билдеры тестовых данных. Подключается к запросам на генерацию фикстур, тестовых сущностей и связанных записей. CX Codex +1 229установок terraform-module-builder Скилл terraform-module-builder помогает проектировать переиспользуемые модули Terraform с валидацией входных переменных, outputs и структурой каталогов. CX Codex +1 229установок snapshot-test-refactorer Скилл snapshot-test-refactorer для Claude Code превращает громоздкие снимки разметки в точечные проверки поведения и данных. Заменяет хрупкие проверки, падающие при малейшем изменении пробелов или вёрстки. CX Codex +1 228установок doc-to-vector-dataset-generator Скилл doc-to-vector-dataset-generator для Claude Code превращает документы в очищенные JSONL-чанки для embeddings и vector search. Готовит данные для поиска по документам. CX Codex +1 227установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой