# perf

perf is a Claude Code skill that guides performance troubleshooting across database bottlenecks, CPU spikes, memory leaks, and high latency. Runs during profiling or benchmark analysis.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/perf/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alexj11324-perf

## What it does

The skill enforces a measurement-first workflow. Before touching application code, it guides the agent to define baseline latency targets at p50 and p99, reliably reproduce the issue, and inspect flame graphs to isolate hot execution paths.

Practical playbooks cover typical backend bottlenecks: resolving N+1 database queries through batching or joins, tuning connection pool capacity, and reading execution plans for missing indexes. For caching, it evaluates cache-aside or write-through strategies while mitigating thundering herd spikes, and targets memory pressure by replacing buffered payloads with streams.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill perf -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/perf/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/perf/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill perf -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/perf/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill perf -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/perf/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/perf
```

2. **Manually: put the files in place**
- File: `.github/skills/perf/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill perf -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/perf
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/perf/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/perf/SKILL.md

## When to use it
- Track down hot execution paths using CPU flame graphs and call trees
- Eliminate N+1 database queries via batched joins or eager loading
- Configure caching models while preventing thundering herd spikes
- Mitigate garbage collection pauses by streaming heavy network payloads

## Example prompts
- Help me optimize this slow API request and inspect why latency spiked
- How do I detect and eliminate N+1 queries in this service?
- Profile this worker script because memory usage grows constantly

## Similar
- [perf-profile](https://affpapa.org/en/nevibecode/skills/perf-profile.md) — skill · 692 installs
- [w-perf](https://affpapa.org/en/nevibecode/skills/w-perf.md) — skill · 647 installs
- [perf-profiler](https://affpapa.org/en/nevibecode/plugins/perf-profiler.md) — plugin · ★ 2858 repo stars
- [optimize-performance](https://affpapa.org/en/nevibecode/agents/optimize-performance.md) — subagent · ★ 587 repo stars
- [performance-engineer](https://affpapa.org/en/nevibecode/agents/performance-engineer.md) — subagent · 671 installs
- [performance-optimization](https://affpapa.org/en/nevibecode/commands/seth-hobson-performance-optimization.md) — command · ★ 126 repo stars

## Other versions with the same name
- [perf · pwguler](https://affpapa.org/en/nevibecode/skills/perf.md) — 899 installs

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
