performance-budget-setter — скилл для Claude Code: установка
Скилл performance-budget-setter для Claude Code помогает задать бюджеты для бандлов, API, запросов к базе и времени рендера. Бюджеты фиксируют для проверки метрик в CI и мониторинге.
MIT 228 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill performance-budget-setter -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/performance-budget-setter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/performance-budget-setter/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill performance-budget-setter -a codex2Вручную: положить файлы
.agents/skills/performance-budget-setter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill performance-budget-setter -a cursor2Вручную: положить файлы
.cursor/skills/performance-budget-setter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills architecture/performance-budget-setter/SKILL.md2Вручную: положить файлы
.github/skills/performance-budget-setter/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill performance-budget-setter -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path architecture/performance-budget-setterВручную: положить файлы
.devin/skills/performance-budget-setter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill performance-budget-setter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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