perf-review

Profile query plans, resource usage, and caching strategies to identify performance hotspots.

4|1|Updated May 31, 2015
One-click install
npx skills add https://github.com/samcdavid/dotfiles --skill perf-review-samcdavid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-review
Source: https://github.com/samcdavid/dotfiles/tree/main/claude/skills/perf-review
Command: npx skills add https://github.com/samcdavid/dotfiles --skill perf-review-samcdavid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep performance review of code changes or a codebase area. Profiles query plans, evaluates index coverage, estimates load impact, checks for resource exhaustion, and audits caching strategy beyond standard code review checks.

Core Features & Use Cases

  • Map hot paths across the codebase to identify where performance bottlenecks originate.
  • Analyze queries, data flows, and caching layers to evaluate efficiency and scalability.
  • Produce a structured performance report suitable for follow-up optimizations and engineering sprints.

Quick Start

Run a dedicated performance audit on the target codebase to analyze hot paths, queries, and caching strategies.

Frequently Asked Questions about perf-review

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

FAQPage Schema
How do I perform a performance audit on code changes in a pull request?

A performance audit analyzes code changes by profiling query plans, resource usage, and caching strategies to identify hotspots and scalability concerns. It requires access to the repository, profiling data, and benchmarks to map hot paths and evaluate load impact.

What is deep performance profiling for code review and when do I need it?

Deep performance profiling evaluates query plans, index coverage, and caching layers beyond standard code review checks. You need it when reviewing feature branches or subsystems to identify performance bottlenecks, map hot paths, and estimate load impact before deployment.

How do I check for resource exhaustion and scalability concerns in my codebase?

Checking for resource exhaustion involves mapping hot paths across the codebase and analyzing data flows to evaluate efficiency and scalability. The audit produces a structured performance report identifying hotspots and resource limits suitable for follow-up engineering sprints.

Can I analyze caching strategies and query plans without external profiling dependencies?

Analyzing caching strategies and query plans requires access to the repository, profiling data, and benchmarks. Without these inputs, the multi-step workflow from hot-path mapping to adversarial review cannot accurately evaluate index coverage or estimate load impact.

What is the best way to identify performance bottlenecks originating in a subsystem under review?

The best way to identify performance bottlenecks is running a dedicated performance audit that profiles query plans and evaluates caching layers. This maps hot paths across the codebase to pinpoint where bottlenecks originate and produces a structured optimization report.

What are the limitations of performance review for code changes?

Performance review is limited by its dependence on existing profiling data and benchmarks, meaning it cannot accurately estimate load impact or map hot paths without repository access. It focuses on hotspots and caching strategies rather than standard code review checks.