# perf-baseline-manager

perf-baseline-manager keeps one JSON performance baseline for each version and records metrics with environment details. Use it when comparing releases.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 2300 installs · ★ 2003 repo stars
- 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/baseline/SKILL.md
- Updated: 2026-07-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/perf-baseline-manager

## What it does

perf-baseline-manager handles baseline storage and version comparisons. It writes each version to `{state-dir}/perf/baselines/<version>.json`, together with the measured metrics and environment metadata.

The skill treats `docs/perf-requirements.md` as the governing contract. Its result includes the baseline version, a metrics summary, and the file path. Saving the same version again replaces its previous baseline, so earlier results for that version do not remain as a second file.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- store performance metrics for a version
- compare measurements across versions
- keep environment metadata with a baseline
- replace an existing version baseline without making a duplicate

## Example prompts
- Save a performance baseline for `<version>` with its metrics and environment details.
- Compare the results for versions `<version>` and prepare a summary.
- Check the baseline files and keep one JSON file per version.

## Similar
- [build-perf-baseline](https://affpapa.org/en/nevibecode/skills/build-perf-baseline.md) — skill · 4500 installs
- [perf](https://affpapa.org/en/nevibecode/skills/perf.md) — skill · 899 installs
- [w-perf](https://affpapa.org/en/nevibecode/skills/w-perf.md) — skill · 647 installs
- [rag-perf](https://affpapa.org/en/nevibecode/skills/rag-perf.md) — skill · 2200 installs
- [perf-lighthouse](https://affpapa.org/en/nevibecode/skills/perf-lighthouse.md) — skill · 341 installs
- [golang-benchmark](https://affpapa.org/en/nevibecode/skills/golang-benchmark.md) — skill · 41800 installs

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