
Perf Budget Auditor
Audit your frontend build against a performance budget and catch size regressions before you ship. Flags total bundle over budget, initial bundle over budget, individual chunks over a threshold, oversized image assets, source maps shipped to production, and large unminified JavaScript. Reads a webpack or Vite-style stats.json plus a perf-budget.json you control.
- Detect oversized JavaScript bundles and assets during CI/CD or local builds
- Identify leaked source maps and unminified code in production artifacts
- Enforce performance budgets using custom thresholds or stats.json manifests
$12
· or 60 creditsSecure checkout via Stripe
Included in download
- Detect oversized JavaScript bundles and assets during CI/CD or local builds
- Identify leaked source maps and unminified code in production artifacts
- terminal, file_read automation included
- Ready for Cursor
Sample input
Audit my dist folder against our performance budget and let me know if the build is safe to deploy.
Sample output
Perf Budget Audit Results
- Severity: HIGH | Rule: INITIAL_JS_BUDGET
- File: dist/assets/index-D4f2a.js (450KB)
- Message: Exceeds initial budget of 200KB.
- Remediation: Use dynamic imports to code-split non-critical modules or check for duplicate dependencies.
Audit your frontend build against a performance budget and catch size regressions before you ship. Flags total bundle over budget, initial bundle over budget, individual chunks over a threshold, oversized image assets, source maps shipped to production, and large unminified JavaScript. Reads a webpack or Vite-style stats.json plus a perf-budget.json you control.
$12
· or 60 creditsSecure checkout via Stripe
Included in download
- Detect oversized JavaScript bundles and assets during CI/CD or local builds
- Identify leaked source maps and unminified code in production artifacts
- terminal, file_read automation included
- Ready for Cursor
- Instant install
Sample input
Audit my dist folder against our performance budget and let me know if the build is safe to deploy.
Sample output
Perf Budget Audit Results
- Severity: HIGH | Rule: INITIAL_JS_BUDGET
- File: dist/assets/index-D4f2a.js (450KB)
- Message: Exceeds initial budget of 200KB.
- Remediation: Use dynamic imports to code-split non-critical modules or check for duplicate dependencies.
About This Skill
What it does
Perf Budget Auditor is a specialized developer tool designed to automatically detect frontend performance regressions before they reach production. It scans build artifacts, manifests (stats.json), and asset folders to identify oversized bundles, unoptimized images, leaked source maps, and unminified JavaScript.
Why use this skill
Manually checking file sizes after every build is tedious and error-prone. This skill automates the audit process by comparing your build output against defined performance budgets (perf-budget.json). It provides actionable remediation guidance rather than just raw numbers, helping developers pinpoint exactly which chunks or assets are bloating the application.
Supported tools
- Standard web build folders (dist, build, out)
- Webpack/Rollup/Vite manifest files (stats.json)
- Custom performance budget configurations
- Common frontend assets (JS, CSS, WASM, Images)
Output Expected
You will receive a structured report detailing the inspected scope, specific rule violations, severity levels, and precise file paths. Each finding includes "evidence" (e.g., actual size vs. budget) and clear remediation steps to fix the bloat.
Use Cases
- Detect oversized JavaScript bundles and assets during CI/CD or local builds
- Identify leaked source maps and unminified code in production artifacts
- Enforce performance budgets using custom thresholds or stats.json manifests
- Get actionable remediation steps for specific bundle size regressions
Known Limitations
Heuristic detector. It reads a build manifest and file sizes, so it reports gzip or brotli sizes only if your stats already include them, and the unminified-JS check is a heuristic from manifest flags and raw size. It measures what the build produced; it does not run Lighthouse or a live browser.
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/perf-budget-auditor -o /tmp/perf-budget-auditor.zip && unzip -o /tmp/perf-budget-auditor.zip -d ~/.claude/skills && rm /tmp/perf-budget-auditor.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Early access skill
Be the first to review this skill.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
Allowed Hosts
File Scopes
Read-only. Parses stats and budget JSON with the standard library and inspects output file sizes. Ships default thresholds, overridable via perf-budget.json. It does not execute the build or read environment variables.
Works with any agent that can read a build directory and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step. It reads build manifests and output file sizes; it does not run the bundler. Read-only.
Creator
JustHandled Labs creates focused agent skills and workflow packs for Claude, Codex, Cursor, and AI-assisted builders. Each tool is designed around a real repeatable task: cleaner commits, better PRs, stronger handoffs, safer repo hygiene, clearer documentation, and less copy-paste chaos. The goal is not generic AI productivity. The goal is specific workflows that are easier to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. JustHandled Labs builds tools for people who want useful automation without theatrical complexity.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
cinematic-sites
Turn any basic business URL into a high-end cinematic landing page with AI-generated 4K assets and GSAP animations.
designing-hybrid-context-layers
Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.
consumer-motivation-analyzer
Go beyond surface-level feedback to uncover the psychological drivers and hidden motivations behind buyer behavior.
keyword-research
Transform URLs or product lists into SEO keyword research packs with Google Ads data and intent-based clustering.