Skip to content

majiayu000/spellbook / skills/performance-capacity

performance-capacity

Verified

Plan, diagnose, and verify performance budgets, latency targets, load tests, capacity estimates, bottleneck analysis, caching strategy, query efficiency, queue throughput, and regression gates. Use when a feature may be slow, a system must scale, a performance regression is suspected, or release readiness depends on throughput, cost, memory, CPU, or response time.

Performance Capacity

Purpose

Use this skill to make performance measurable before optimizing. It turns vague "make it faster" work into budgets, probes, bottleneck hypotheses, and regression gates.

Baseline First

Before changing code, capture:

  1. User-facing operation or background job under test.
  2. Current p50/p95/p99 latency or throughput.
  3. Data size and concurrency assumptions.
  4. Resource limits: CPU, memory, IO, network, database, queue.
  5. Existing cache behavior and invalidation rules.
  6. Cost or quota constraints.

If no baseline can be gathered, state the nearest measurable proxy and its limitations.

Budget Design

Define budgets by surface:

SurfaceExamples
UITTI, interaction latency, bundle size, render count
APIp95 latency, error rate, DB query count, payload size
Jobsthroughput, max lag, retry cost, idempotency
Dataquery plan, index coverage, backfill duration
InfraCPU/RSS, concurrency, autoscaling, cost per request

Optimization Rules

  • Optimize the measured bottleneck, not the most familiar code.
  • Prefer algorithmic, query, batching, and cache correctness fixes before capacity-only fixes.
  • Define cache invalidation and stale-data tolerance.
  • Add a regression test, benchmark, or dashboard check for risky paths.
  • Do not trade correctness, authorization, or tenant isolation for speed.

Output Shape

operation:
baseline:
target_budget:
bottleneck_hypothesis:
measurement_plan:
optimization_options:
capacity_estimate:
regression_gate:
verification_commands:
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall