performance-profiler

alirezarezvani/claude-skills · .gemini/skills/performance-profiler/SKILL.md

Systematic performance profiling for Node.js, Python, and Go applications. Identifies CPU, memory, and I/O bottlenecks, generates flamegraphs, analyzes bundle sizes, optimizes database queries, runs load tests with k6 and Artillery. Always measures before and after. Use when investigating a slow endpoint, planning a performance budget, or hunting a memory leak in production.

Software EngineeringNo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

Performance Profiler

Tier: POWERFUL
Category: Engineering
Domain: Performance Engineering

Overview

Systematic performance profiling for Node.js, Python, and Go applications. Identifies CPU, memory, and I/O bottlenecks; generates flamegraphs; analyzes bundle sizes; optimizes database queries; detects memory leaks; and runs load tests with k6 and Artillery. Always measures before and after.

Core Capabilities

CPU profiling — flamegraphs for Node.js, py-spy for Python, pprof for Go
Memory profiling — heap snapshots, leak detection, GC pressure
Bundle analysis — webpack-bundle-analyzer, Next.js bundle analyzer
Database optimization — EXPLAIN ANALYZE, slow query log, N+1 detection
Load testing — k6 scripts, Artillery scenarios, ramp-up patterns
Before/after measurement — establish baseline, profile, optimize, verify

When to Use

App is slow and you don't know where the bottleneck is
P99 latency exceeds SLA before a release
Memory usage grows over time (suspected leak)
Bundle size increased after adding dependencies
Preparing for a traffic spike (load test before launch)
Database queries taking >100ms

Quick Start

# Analyze a project for performance risk indicators
python3 scripts/performance_profiler.py /path/to/project

# JSON output for CI integration
python3 scripts/performance_profiler.py /path/to/project --json

# Custom large-file threshold
python3 scripts/performance_profiler.py /path/to/project --large-file-threshold-kb 256

Golden Rule: Measure First

# Establish baseline BEFORE any optimization
# Record: P50, P95, P99 latency | RPS | error rate | memory usage

# Wrong: "I think the N+1 query is slow, let me fix it"
# Right: Profile → confirm bottleneck → fix → measure again → verify improvement

Node.js Profiling

→ See references/profiling-recipes.md for details

References

references/profiling-recipes.md — Node.js/Python/Go profiling commands, flamegraph generation, heap snapshots
references/optimization-playbook.md — before/after measurement template, quick-win optimization checklist (DB/Node/bundle/API), common pitfalls, best practices

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/performance-profiler · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/performance-profiler" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/performance-profiler" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/performance-profiler

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so performance-profiler is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

performance-profiler

alirezarezvani/claude-skills · .gemini/skills/performance-profiler/SKILL.md

Software EngineeringNo license★ 25441⑂ 3598commit 19392f7

Install skillView source on GitHub

What this skill does

Performance Profiler

Tier: POWERFUL
Category: Engineering
Domain: Performance Engineering

Overview

Core Capabilities

CPU profiling — flamegraphs for Node.js, py-spy for Python, pprof for Go
Memory profiling — heap snapshots, leak detection, GC pressure
Bundle analysis — webpack-bundle-analyzer, Next.js bundle analyzer
Database optimization — EXPLAIN ANALYZE, slow query log, N+1 detection
Load testing — k6 scripts, Artillery scenarios, ramp-up patterns
Before/after measurement — establish baseline, profile, optimize, verify

When to Use

App is slow and you don't know where the bottleneck is
P99 latency exceeds SLA before a release
Memory usage grows over time (suspected leak)
Bundle size increased after adding dependencies
Preparing for a traffic spike (load test before launch)
Database queries taking >100ms

Quick Start

# Analyze a project for performance risk indicators
python3 scripts/performance_profiler.py /path/to/project

# JSON output for CI integration
python3 scripts/performance_profiler.py /path/to/project --json

# Custom large-file threshold
python3 scripts/performance_profiler.py /path/to/project --large-file-threshold-kb 256

Golden Rule: Measure First

# Establish baseline BEFORE any optimization
# Record: P50, P95, P99 latency | RPS | error rate | memory usage

# Wrong: "I think the N+1 query is slow, let me fix it"
# Right: Profile → confirm bottleneck → fix → measure again → verify improvement

Node.js Profiling

→ See references/profiling-recipes.md for details

References

references/profiling-recipes.md — Node.js/Python/Go profiling commands, flamegraph generation, heap snapshots
references/optimization-playbook.md — before/after measurement template, quick-win optimization checklist (DB/Node/bundle/API), common pitfalls, best practices

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/performance-profiler · pinned to the source commit

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/performance-profiler" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/alirezarezvani/claude-skills.git .skillboard-tmp
git -C .skillboard-tmp checkout 19392f7a08264ed00486a251f5b2098321771f94
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/.gemini/skills/performance-profiler" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/performance-profiler

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so performance-profiler is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 19392f7a0826. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

performance-profiler

What this skill does

Performance Profiler

Overview

Core Capabilities

When to Use

Quick Start

Golden Rule: Measure First

Node.js Profiling

References

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

performance-profiler

What this skill does

Performance Profiler

Overview

Core Capabilities

When to Use

Quick Start

Golden Rule: Measure First

Node.js Profiling

References

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits