skill-performance-optimization

Diagnose measured performance bottlenecks and verify improvements against stable workloads.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/longdang193/project-OS-starter --skill skill-performance-optimization-longdang193
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-performance-optimization
Source: https://github.com/longdang193/project-OS-starter/tree/main/generated_agents/claude/skills/skill-performance-optimization
Command: npx skills add https://github.com/longdang193/project-OS-starter --skill skill-performance-optimization-longdang193

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Performance work often fails because teams optimize the wrong layer, compare inconsistent measurements, or ship speculative caches and indexes without proof. This Skill enforces a measurement-first method: fix comparison conditions, capture a baseline, identify the dominant constraint, apply one minimal fix, and rerun the identical workload to prove the improvement. ## Core Features & Use Cases - Baseline and comparison discipline: Locks version, environment, data, concurrency, and warm/cold state before measuring, with enough repetitions to expose variance and tail latency. - Surface-specific evidence maps: Guides evidence collection for browser (Web Vitals, traces), service (p50/p95/p99 latency, saturation), database (query plans, scans), memory (heap profiles), build (bundle chunks), and prompt-cache (provider token usage) scenarios. - Verified improvement only: Rejects unproven optimizations, requires absolute and relative change reporting, and keeps only wins backed by reruns and correctness checks. - Use Case: A checkout p95 regression triggers an alarm. Use this Skill to baseline against the last healthy window, trace the repeated database query causing the bottleneck, fix only that query, and confirm p95/p99 improvement without correctness errors. ## Quick Start Use the performance optimization skill to diagnose the p95 latency regression in the checkout flow and verify a fix against the production baseline.

Frequently Asked Questions about skill-performance-optimization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a p95 latency regression in production?▼

Use the alarm's production dimensions and last healthy window as the baseline, then trace the full request path to find the dominant constraint such as a repeated database query. Fix only that bottleneck and rerun comparable traffic to confirm p95 and p99 improve.

How to verify a performance optimization actually worked?▼

Rerun the identical workload and environment used for the baseline, then report absolute change, relative change, variance or percentiles, and resource tradeoffs. Keep only proven wins and confirm semantic correctness of the output.

What evidence should I collect for database performance issues?▼

Collect query count, execution plans, actual rows processed, scans, joins, sort spill, and total time. These reveal whether the dominant constraint is indexing, query structure, or data volume before you edit anything.

Does equal prompt hashing prove a provider cache hit?▼

No. Equal local hashes only prove serialization stability, not provider cache reuse. Require provider usage evidence such as cache read/write token counts, or report the cache claim as unverified.

When should I not add caching to fix performance?▼

Avoid caching without defined freshness, invalidation, isolation, memory bounds, and eviction policies. Speculative whole-response caching without these guarantees is explicitly rejected by the method.

Why do performance comparisons between builds mislead teams?▼

Comparing different builds, data sets, traffic patterns, devices, or warm/cold states invalidates results. The method requires fixing all comparison conditions before measuring so observed changes reflect the fix, not environmental drift.