# Review Performance Risks Before Release

Performance risks often appear after code works but before scale exposes weak paths. This skill guides Claude, Codex, and Claude Code through focused performance review questions.

## Install

```bash
npx skillstore add danielpodolsky/performance-gate
```

## Metadata

- Status: approved
- Slug: danielpodolsky-performance-gate
- Skillstore revision: r1
- Version status: missing
- Tree hash: cfda84427c347b6868f9172107d46e7c2ee6ee45de8f75bffd726cd8857cb1d2
- Author: DanielPodolsky
- GitHub username: DanielPodolsky
- License: MIT
- Repository: https://github.com/DanielPodolsky/mentor-spec/tree/main/.claude/skills/gates/performance
- Ref: 34f316ba14ef36c7a620fc09f2676d2429997a77
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/danielpodolsky-performance-gate
- Manifest: https://skillstore.pages.dev/api/skills/danielpodolsky-performance-gate/manifest

## Capabilities

- Reviews code changes for obvious scalability, query, rendering, API, and memory risks.
- Checks for N\+1 queries, missing pagination, oversized payloads, and inefficient data access.
- Flags frontend render patterns such as repeated sorting, inline callbacks, and missing memoization.
- Provides pass or warning style review output for performance gate decisions.
- Supplies Socratic questions that help teams reason about scale without over-optimizing.

## Use Cases

- Pre-merge performance review: Review a pull request for query count, pagination, rendering, and memory risks before approval.
- Frontend render audit: Check React components for repeated calculations, unstable callbacks, large lists, and cleanup problems.
- Architecture readiness check: Ask scale-focused questions before a new feature handles larger datasets or higher request volume.

## Prompt Templates

### Basic performance gate

```
Run the performance gate on my recent change. Check for obvious scalability, query, rendering, API, and memory risks. Return PASS or WARNING with concise reasons.
```

### Pull request warning review

```
Review this pull request with the performance gate. Identify any N+1 queries, missing pagination, redundant API calls, expensive render work, or cleanup issues.
```

### Scale scenario analysis

```
Evaluate this feature as if it must handle 10,000 records and then 1,000,000 records. Ask the key performance questions and list any warnings.
```

### Cross-layer performance audit

```
Apply the performance gate across database access, API payloads, frontend rendering, and memory lifecycle. Separate confirmed risks from context-dependent concerns.
```

## Limitations

- Does not run benchmarks, profilers, load tests, or database explain plans.
- Cannot prove performance safety without the project code and runtime context.
- Focuses on obvious anti-patterns, not low-level micro-optimizations.
- May need human judgment for prototypes, rare admin tasks, and small datasets.

## Best Practices

- Provide the relevant code path, expected data size, and usage frequency before running the gate.
- Treat warnings as review prompts and confirm impact with measurements when risk is material.
- Prioritize algorithmic, query, and payload fixes before minor syntax-level optimizations.

## Anti Patterns

- Using the gate as a replacement for profiling, load testing, or production monitoring.
- Optimizing prototype code without evidence that data size or traffic will grow.
- Ignoring warnings about unbounded queries, repeated renders, or missing cleanup because current data is small.

## Security Audit

- Audited at: 2026-07-06T09:38:08.362\+00:00
- Summary: All static external command hits were false positives caused by Markdown code fences and inline code examples in SKILL.md. The skill is review guidance only and does not instruct agents to execute shell commands, access secrets, or contact networks. No prompt injection or data exfiltration intent was found.

## Stats

- Views: 246
- Downloads: 10
- Favorites: 0
- Popularity score: 0
