perf-audit

Audit hot-path code changes against a declared performance budget.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Jennyfirrr/workspace-template --skill perf-audit-jennyfirrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-audit
Source: https://github.com/Jennyfirrr/workspace-template/tree/main/claude-skills/perf-audit
Command: npx skills add https://github.com/Jennyfirrr/workspace-template --skill perf-audit-jennyfirrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies cost-regression shapes on a project’s hot-path before shipping, preventing slower-than-expected code from reaching production by evaluating allocations, copies, branches, hoisting opportunities, data-layout changes, and complexity increases against the budget.

Core Features & Use Cases

  • Structural detection of cost-shape changes on edited hot-path regions.
  • Measured modality when perf tooling exists to compare costs against a per-path budget using benchmarks or equivalence checks.
  • Output a findings report with recommended mitigations and cross-references to project contracts.

Quick Start

Invoke /perf-audit on the current diff to evaluate hot-path cost and generate a findings report.

Frequently Asked Questions about perf-audit

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

FAQPage Schema
How do I catch performance regressions on a hot-path before shipping code changes?

To benchmark code changes against a per-path budget, use a measured modality that compares costs using performance tooling. This evaluates edited hot-path regions directly against your declared limits to detect cost regressions pre-merge.

How do I audit code complexity and data-layout changes for cost regressions?

You can audit code complexity and data-layout changes by inspecting edited hot-path regions for structural shifts. This structural detection identifies hoisting opportunities and complexity increases against your budget, generating a findings report with recommended mitigations.

Can I evaluate hot-path cost without dedicated benchmark tooling?

You can evaluate hot-path cost without dedicated tooling using structural detection. This modality analyzes the edited code regions directly for allocations, copies, and branches, providing cost-regression findings even when measured benchmarking tools are absent.

What is the best way to prevent slower-than-expected code from reaching production?

The best way to prevent slower code from reaching production is to audit hot-path cost against a declared budget before shipping. This evaluates cost-shape changes like new allocations and branches, outputting a findings report with actionable remedies and contract cross-references.

What limitations exist when auditing hot-path cost against a budget?

A key limitation of auditing hot-path cost is that measured modality requires existing performance tooling to compare costs via benchmarks. Without such tooling, the audit is limited to structural detection of cost-shapes rather than actual measured benchmark comparisons.