perf-theory-gatherer

$npx mdskill add ComposioHQ/awesome-claude-plugins/perf-theory-gatherer

Generates performance hypotheses using git history and code evidence for specific scenarios.

  • Helps developers create data-backed theories about performance issues in code.
  • Integrates with git for history review and uses repo-map or grep for code path identification.
  • Decides recommendations by analyzing recent changes and relevant code paths to produce up to five hypotheses.
  • Presents results in a structured format with evidence and confidence levels for each hypothesis.

SKILL.md

.github/skills/perf-theory-gathererView on GitHub ↗
---
name: perf-theory-gatherer
description: "Use when generating performance hypotheses backed by git history and code evidence."
version: 1.0.0
---

# perf-theory-gatherer

Generate performance hypotheses for a specific scenario.

Follow `docs/perf-requirements.md` as the canonical contract.

## Required Steps

1. Review recent git history (scope to relevant paths when possible).
2. Identify code paths involved in the scenario (repo-map or grep).
3. Produce up to 5 hypotheses with evidence + confidence.

## Output Format

```
hypotheses:
  - id: H1
    hypothesis: <short description>
    evidence: <file/path or git change>
    confidence: low|medium|high
  - id: H2
    ...
```

## Constraints

- MUST check git history before hypothesizing.
- No optimization suggestions; only hypotheses.
- Keep to 5 hypotheses maximum.

More from ComposioHQ/awesome-claude-plugins

SkillDescription
add-subSubscribe to a skill event. Adds a subscription that injects context before or after a skill runs. Supports optional conditions at both insert-level (inherited by all subscriptions) and subscription-level (AND-stacked). Conditions include fileExists, gitBranch, envSet, envEquals, fileContains (with optional regex).
helpShow skill-bus overview, status, and available commands. Quick reference for all skill-bus features.
list-subsList all active skill-bus subscriptions across global and project scopes, showing merge status, insert-level and subscription-level conditions, effective condition stacking, and what would fire for each skill.
pause-subsTemporarily disable the skill bus. Quick toggle to stop all subscriptions from firing without removing them.
perf-analyzer"Use when synthesizing perf findings into evidence-backed recommendations and decisions."
perf-baseline-manager"Use when managing perf baselines, consolidating results, or comparing versions. Ensures one baseline JSON per version."
perf-benchmarker"Use when running performance benchmarks, establishing baselines, or validating regressions with sequential runs. Enforces 60s minimum runs (30s only for binary search) and no parallel benchmarks."
perf-code-paths"Use when mapping code paths, entrypoints, and likely hot files before profiling."
perf-investigation-logger"Use when appending structured perf investigation notes and evidence."
perf-profiler"Use when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence."