gaia-performance-review

Identify and report performance bottlenecks in story-scoped code changes.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-performance-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gaia-performance-review
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-performance-review
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-performance-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Bottlenecks in a story's performance (N+1 queries, memory/bundle impact, caching gaps, and algorithmic complexity) slow down delivery and obscure root causes. This Skill automates per-story bottleneck discovery, produces a machine-readable verdict, and updates the Review Gate to streamline deployments.

Core Features & Use Cases

  • Automated, end-to-end bottleneck analysis for a single story, including changes under docs/implementation-artifacts.
  • Detects N+1 queries, unbounded queries, memory leaks, excessive bundle sizes, and caching gaps; emits a detailed, machine-readable report.
  • Integrates with the Review Gate to register verdicts and generate per-story performance artifacts for sprint reviews.

Quick Start

Run the performance review for a story using its key, for example /gaia-performance-review E28-S108.

Frequently Asked Questions about gaia-performance-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate per-story bottleneck analysis for N+1 queries and caching gaps?▼

Per-story bottleneck analysis is automated by running a performance review with a specific story key. This evaluates changed files for N+1 queries, memory impact, caching strategy, and algorithmic complexity.

What is a machine-readable verdict in performance bottleneck detection?▼

A machine-readable verdict is a deterministic classification output by a fast-path classifier. It registers performance findings into a Review Gate to streamline deployment decisions.

How do I run a performance review for a specific story key?▼

You trigger the review by invoking the performance review command with your story key, such as E28-S108. It analyzes changes under docs/implementation-artifacts to produce per-story performance artifacts.

Does the bottleneck analysis detect memory leaks and excessive bundle sizes?▼

Yes, the bottleneck analysis detects memory leaks, unbounded queries, and excessive bundle sizes. It evaluates memory and bundle impact alongside caching gaps within the changed files.

Can I integrate performance review results into my sprint review process?▼

Yes, the performance review integrates with a Review Gate to register deterministic verdicts. It generates per-story performance artifacts that can be used directly in sprint reviews.

What are the limitations of using an automated review gate for bottleneck analysis?▼

Bottleneck analysis is scoped per-story and restricted to changed files within implementation artifacts. It requires a valid story key to execute and does not evaluate the entire codebase globally.