How do I install the Perf Audit skill?

Run npx skillmds@latest add b-open-io-prompts/perf-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Perf Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Perf Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Perf Audit free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Perf Audit?

b-open-io (@b-open-io-prompts) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Perf Audit by b-open-io-prompts — Agent Skill

Name: Perf Audit
Rating: 4.666666666666667 (3 reviews)
Author: b-open-io

Perf Audit

Run local performance audits on a project without network calls. This skill should be used when the user says 'audit performance', 'check bundle size', 'find large images', 'check for heavy dependencies', 'run a perf audit', 'how big is my bundle', 'optimize images', 'find oversized assets', or before any performance optimization work. Also use when an agent needs baseline metrics before making changes. All scripts output structured JSON to stdout.

b-open-io Updated Sep 10, 2026

File contents

Performance Audit

Run local, deterministic performance audits. All scripts output JSON to stdout, use only standard unix tools, and make zero network calls.

Scripts

Full Audit (start here)

Runs all audits in parallel and produces a unified report with a health score (0-100).

bash <skill-path>/scripts/full-audit.sh /path/to/project

Returns:

{
  "health_score": 85,
  "image_audit": { ... },
  "bundle_audit": { ... },
  "dep_audit": { ... }
}

Image Audit

Scan for oversized images, missing next-gen formats, and dimension info.

bash <skill-path>/scripts/image-audit.sh /path/to/project

Flags images over 500KB as oversized. Uses sips on macOS for dimensions. Reports images without a WebP/AVIF equivalent.

Bundle Audit

Analyze JS and CSS bundle sizes in build output directories (.next, dist, build, out).

bash <skill-path>/scripts/bundle-audit.sh /path/to/project

Reports raw and gzipped sizes for every bundle file. Flags source maps in production. Requires a build to exist -- run the project's build command first if no build output is found.

Dependency Audit

Check package.json for known-heavy dependencies and suggest lighter alternatives.

bash <skill-path>/scripts/dep-audit.sh /path/to/project

Checks against a curated list of heavy packages (moment, lodash, jquery, full icon libraries, etc.) and suggests tree-shakable or lighter replacements.

Workflow

Run full-audit.sh to get the baseline health score
Review each sub-audit for specific issues
Fix issues (optimize images, swap deps, configure tree-shaking)
Re-run full-audit.sh to measure improvement
Include before/after scores in your completion report

---name: perf-auditdescription: Run local performance audits on a project without network calls. This skill should be used when the user says 'audit performance', 'check bundle size', 'find large images', 'check for heavy dependencies', 'run a perf audit', 'how big is my bundle', 'optimize images', 'find oversized assets', or before any performance optimization work. Also use when an agent needs baseline metrics before making changes. All scripts output structured JSON to stdout.---# Performance AuditRun local, deterministic performance audits. All scripts output JSON to stdout, use only standard unix tools, and make zero network calls.## Scripts### Full Audit (start here)Runs all audits in parallel and produces a unified report with a health score (0-100).```bashbash <skill-path>/scripts/full-audit.sh /path/to/project```Returns:```json{ "health_score": 85, "image_audit": { ... }, "bundle_audit": { ... }, "dep_audit": { ... }}```### Image AuditScan for oversized images, missing next-gen formats, and dimension info.```bashbash <skill-path>/scripts/image-audit.sh /path/to/project```Flags images over 500KB as oversized. Uses `sips` on macOS for dimensions. Reports images without a WebP/AVIF equivalent.### Bundle AuditAnalyze JS and CSS bundle sizes in build output directories (.next, dist, build, out).```bashbash <skill-path>/scripts/bundle-audit.sh /path/to/project```Reports raw and gzipped sizes for every bundle file. Flags source maps in production. Requires a build to exist -- run the project's build command first if no build output is found.### Dependency AuditCheck package.json for known-heavy dependencies and suggest lighter alternatives.```bashbash <skill-path>/scripts/dep-audit.sh /path/to/project```Checks against a curated list of heavy packages (moment, lodash, jquery, full icon libraries, etc.) and suggests tree-shakable or lighter replacements.## Workflow1. Run `full-audit.sh` to get the baseline health score2. Review each sub-audit for specific issues3. Fix issues (optimize images, swap deps, configure tree-shaking)4. Re-run `full-audit.sh` to measure improvement5. Include before/after scores in your completion report

Frequently asked questions