# performance-optimization

Turns profiler traces, load tests, and query plans into a targeted tuning brief. Pinpoints a single bottleneck and verifies fixes with before-and-after data.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 366 installs · ★ 51
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/performance-optimization/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-performance-optimization

## What it does

Instead of spewing generic web or database advice, this skill forces the agent to inspect the data you already have. It takes raw artifacts like browser traces, slow query plans, flame graphs, or Core Web Vitals reports. Then it frames the exact symptom, platform environment, and target metric, such as p95 latency or frame budgets.

The workflow runs through structured stages. It captures the issue, inspects the packet, isolates a single bottleneck, and recommends at most two targeted adjustments. The skill operates using `Read`, `Grep`, `Glob`, `Bash`, and `Write`. Engine-specific traces from Unity, Unreal, or Godot get routed to dedicated game tooling.

This skill does not configure observability dashboards or debug broken program logic. Without an evidence artifact, it will request missing measurements rather than guessing blind optimizations.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill performance-optimization -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill performance-optimization -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill performance-optimization -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills performance-optimization
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill performance-optimization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/performance-optimization
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill performance-optimization -a opencode
```

### 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/akillness/jeo-skills/tree/HEAD/.agent-skills/performance-optimization/SKILL.md

## When to use it
- Identify API latency bottlenecks from APM traces
- Diagnose inefficient query execution plans and index misses
- Trace Core Web Vitals regressions and bundle size spikes
- Design before-and-after verification steps for hot paths

## Example prompts
- Review this EXPLAIN ANALYZE output and pinpoint why the filtered search is lagging.
- Here is our WebPageTest report; determine what blocks LCP on mobile.
- Our p95 response time jumped after the update, isolate the cause from this flame graph.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

## Other versions with the same name
- [performance-optimization · addyosmani](https://affpapa.org/en/nevibecode/skills/performance-optimization.md) — 65200 installs
- [performance-optimization · gamedev-skills](https://affpapa.org/en/nevibecode/skills/gamedev-skills-performance-optimization.md) — 7700 installs
- [performance-optimization · mindrally](https://affpapa.org/en/nevibecode/skills/mindrally-performance-optimization.md) — 848 installs
- [performance-optimization · dylantarre](https://affpapa.org/en/nevibecode/skills/dylantarre-performance-optimization.md) — 516 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 65 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