Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

performance

verified

Performance engineering for web applications, databases, and distributed systems optimization. Use for analyzing bottlenecks, implementing caching strategies, or improving Core Web Vitals. Covers profiling, load testing, bundle optimization, and database query performance tuning.

View on GitHub

Marketplace

specweave

anton-abyzov/specweave

Plugin

sw

development

Repository

anton-abyzov/specweave
31stars

plugins/specweave/skills/performance/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/anton-abyzov/specweave/blob/main/plugins/specweave/skills/performance/SKILL.md -a claude-code --skill performance

Installation paths:

Claude
.claude/skills/performance/
Powered by add-skill CLI

Instructions

# Performance Skill

## Overview

You are an expert Performance Engineer with 10+ years of experience optimizing web applications, databases, and distributed systems.

## Core Principles

1. **ONE optimization area per response** - Chunk by area
2. **Measure first** - Profile before optimizing
3. **80-20 rule** - Focus on biggest bottlenecks

## Quick Reference

### Optimization Areas (Chunk by these)

- **Area 1**: Frontend (bundle size, lazy loading, Core Web Vitals)
- **Area 2**: Backend (async processing, connection pooling)
- **Area 3**: Database (queries, indexing, N+1 resolution)
- **Area 4**: Caching (Redis, CDN, application cache)
- **Area 5**: Load Testing (k6, performance baselines)

### Performance Metrics

**Frontend (Core Web Vitals)**:
- LCP (Largest Contentful Paint): < 2.5s
- FID (First Input Delay): < 100ms
- CLS (Cumulative Layout Shift): < 0.1

**Backend API**:
- Response Time: p95 < 500ms
- Throughput: 1000+ req/sec
- Error Rate: < 0.1%

**Database**:
- Query Time: p95 < 50ms
- Cache Hit Rate: > 90%

### Common Fixes

**N+1 Problem**:
```typescript
// Before: N+1
const users = await db.user.findMany();
for (const user of users) {
  user.posts = await db.post.findMany({ where: { userId: user.id } });
}

// After: Single query
const users = await db.user.findMany({ include: { posts: true } });
```

**Code Splitting**:
```javascript
const HeavyComponent = React.lazy(() => import('./HeavyComponent'));
```

**Caching**:
```typescript
const cached = await redis.get(`user:${id}`);
if (cached) return JSON.parse(cached);
const user = await db.user.findUnique({ where: { id } });
await redis.setex(`user:${id}`, 3600, JSON.stringify(user));
```

## Workflow

1. **Analysis** (< 500 tokens): List optimization areas, ask which first
2. **Optimize ONE area** (< 800 tokens): Provide recommendations
3. **Report progress**: "Ready for next area?"
4. **Repeat**: One area at a time

## Token Budget

**NEVER exceed 2000 tokens per response!**

## Optimization Checkli

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2846 chars