# perf-theory-gatherer

A skill that turns git history and code evidence into up to five hypotheses about a performance problem.

- 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/theory/SKILL.md
- Updated: 2026-07-26
- HTML: https://affpapa.org/en/nevibecode/skills/perf-theory-gatherer

## What it does

You describe a scenario, and the skill walks it in order: recent git history scoped to the relevant paths, then the code paths involved, found through a repo map or grep. What comes back is a list of hypotheses, each with evidence and a confidence level of low, medium or high. Five is the ceiling.

The output shape is fixed. Every hypothesis gets an id, a short description, a file path or git change as evidence, and a confidence rating. Checking git history is mandatory before any hypothesis is written. The skill does not suggest optimizations — it only names possible causes.

It follows `docs/perf-requirements.md` as the canonical contract, so that file needs to exist in your repo. Without it the skill has no agreed requirements for the performance work, which is worth checking before you run it.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- turn commit history into candidate causes of a slowdown
- locate the code paths a given scenario touches
- separate hypotheses from ready-made optimization advice
- tie every hypothesis to a file or git change
- cap the investigation at five prioritized hypotheses

## Example prompts
- review git history for the slow order list scenario and give me hypotheses with evidence
- why is the report export slow — find the code paths and list up to five causes
- check recent commits in the search module and produce hypotheses with confidence levels

## Similar
- [thinking-theory-of-constraints](https://affpapa.org/en/nevibecode/skills/thinking-theory-of-constraints.md) — skill · 643 installs
- [django-perf-review](https://affpapa.org/en/nevibecode/skills/django-perf-review.md) — skill · 2900 installs
- [web-perf](https://affpapa.org/en/nevibecode/skills/cloudflare-web-perf.md) — skill · 110200 installs
- [high-perf-browser](https://affpapa.org/en/nevibecode/skills/high-perf-browser.md) — skill · 5300 installs
- [build-perf-baseline](https://affpapa.org/en/nevibecode/skills/build-perf-baseline.md) — skill · 3500 installs
- [tilegym-improve-cutile-kernel-perf](https://affpapa.org/en/nevibecode/skills/tilegym-improve-cutile-kernel-perf.md) — skill · 1600 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