# perf-benchmarker

Runs benchmarks sequentially under strict duration rules to catch performance regressions and set baseline metrics.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 installs · ★ 1965
- Author: composio-community
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/composio-community/awesome-claude-plugins/tree/HEAD/perf/skills/benchmark/SKILL.md
- Updated: 2026-07-26
- HTML: https://affpapa.org/en/nevibecode/skills/perf-benchmarker

## What it does

The skill enforces sequential execution for all benchmarks. Parallel test runs are explicitly disallowed to prevent skew. A minimum warmup period of 10s runs before any measurements begin.

Standard runs must take at least 60s per execution. Shorter 30s passes are permitted only during binary search phases. The workflow requires re-running any anomalies, and code changes are prohibited during an active run. All rules follow the contract defined in `docs/perf-requirements.md`.

Metrics extraction depends on a strict output contract. The benchmarked command must print a JSON block between `PERF_METRICS_START` and `PERF_METRICS_END` markers. If your test harness cannot output wrapped JSON, metric parsing fails.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add composio-community/awesome-claude-plugins --skill perf-benchmarker -a claude-code
```
```bash
npx skills add composio-community/awesome-claude-plugins --skill benchmark -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add composio-community/awesome-claude-plugins --skill benchmark -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add composio-community/awesome-claude-plugins --skill benchmark -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install composio-community/awesome-claude-plugins benchmark
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add composio-community/awesome-claude-plugins --skill benchmark -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/composio-community/awesome-claude-plugins --path perf/skills/benchmark
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add composio-community/awesome-claude-plugins --skill benchmark -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/composio-community/awesome-claude-plugins/tree/HEAD/perf/skills/benchmark/SKILL.md

## When to use it
- measure latency baselines without noise from parallel executions
- validate performance regressions across sequential runs
- isolate anomalies by repeating irregular test executions
- extract structured metrics delimited by PERF_METRICS markers

## Example prompts
- Run sequential benchmarks for `npm run bench` with 60s duration
- Check for regression using `python bench.py` with 10s warmup
- Perform binary search benchmark using `cargo bench` with 30s runs

## Similar
- [rag-perf](https://affpapa.org/en/nevibecode/skills/rag-perf.md) — skill · 2200 installs
- [llm-evaluation](https://affpapa.org/en/nevibecode/skills/llm-evaluation.md) — skill · 12755 installs
- [web-perf](https://affpapa.org/en/nevibecode/skills/cloudflare-web-perf.md) — skill · 110200 installs
- [golang-benchmark](https://affpapa.org/en/nevibecode/skills/golang-benchmark.md) — skill · 39500 installs
- [tilegym-improve-cutile-kernel-perf](https://affpapa.org/en/nevibecode/skills/tilegym-improve-cutile-kernel-perf.md) — skill · 1600 installs
- [principle-explain-the-number](https://affpapa.org/en/nevibecode/skills/principle-explain-the-number.md) — skill · 4100 installs

From the same set: [composio-community/awesome-claude-plugins](https://affpapa.org/en/nevibecode/by/composio-community/awesome-claude-plugins.md) — 8 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