gaia-perf-deepdive

Analyze code stories for performance bottlenecks and output a PASSED/FAILED verdict.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Read, Grep, Glob, Bash, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill analyzes performance bottlenecks in code stories, identifying N+1 queries, memory/bundle impact, caching, and algorithmic complexity. It provides a machine-readable verdict and updates the Review Gate.

Core Features & Use Cases

  • Performance Bottleneck Analysis: Identifies N+1 queries, memory/bundle impact, caching issues, and algorithmic complexity.
  • Machine-Readable Verdict: Emits a PASSED/FAILED verdict for the Review Gate.
  • Use Case: Use this Skill to analyze a story and ensure performance requirements are met before merging code.

Quick Start

Run the gaia-perf-deepdive skill on a story with the key 'STORY-KEY'.

Frequently Asked Questions about gaia-perf-deepdive

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

FAQPage Schema
How do I find N+1 queries and memory bottlenecks in my code before merging?

To find N+1 queries and memory bottlenecks, you can use performance analysis tools that scan code stories using deterministic detectors and LLM judgment. This process identifies ORM pattern issues, caching problems, and algorithmic complexity.

What is the best way to automate performance analysis for code review gates?

Automating performance analysis for code review gates involves running deterministic tools and LLM judgment on your code stories. This emits a machine-readable PASSED or FAILED verdict to ensure performance requirements are met before merging.

How does LLM judgment work for detecting algorithmic complexity and caching issues?

LLM judgment detects algorithmic complexity and caching issues by combining deterministic complexity analyzers with semantic reasoning. It evaluates code stories to pinpoint performance bottlenecks that static pattern detectors alone might miss.

Can I use complexity analyzers and memory scanners to check bundle impact?

Yes, you can use complexity analyzers and memory scanners to check bundle impact. This Skill integrates deterministic tools to evaluate memory and bundle size impacts alongside algorithmic complexity within your code.

Why does my code review fail when performance bottlenecks are not detected?

Code review fails when performance bottlenecks are not detected because the analysis must emit a machine-readable PASSED or FAILED verdict for the Review Gate. Unresolved N+1 queries or caching issues will trigger a FAILED status.

When do I need to run a deep dive performance analysis on a code story?

You need to run a deep dive performance analysis on a code story before merging code to ensure performance requirements are met. It identifies N+1 queries, memory impact, caching issues, and algorithmic complexity.