playbooks

home / skills / openclaw / skills / bundle-checker

bundle-checker skill

/skills/lxgicstudios/bundle-checker

This skill analyzes your bundle to identify large dependencies and suggests optimizations to reduce size and improve load times.

npx playbooks add skill openclaw/skills --skill bundle-checker

Review the files below or copy the command above to add this skill to your agents.

Files (8)
SKILL.md
2.0 KB
---
name: bundle-checker
description: Analyze bundle size and get AI suggestions to reduce it. Use when your builds are getting bloated.
---

# Bundle Checker

Your bundle is 2MB and you don't know why. This tool analyzes your build output and tells you exactly what's eating up space and how to fix it.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-bundle-check
```

## What It Does

- Analyzes your bundle composition
- Identifies the largest dependencies
- Suggests tree-shaking opportunities
- Recommends lighter alternatives

## Usage Examples

```bash
# Analyze current project
npx ai-bundle-check

# Analyze specific directory
npx ai-bundle-check ./my-project/

# Get detailed breakdown
npx ai-bundle-check --verbose
```

## Best Practices

- **Check before shipping** - catch size regressions early
- **Consider alternatives** - moment.js vs date-fns makes a huge difference
- **Dynamic imports** - split code that isn't needed immediately
- **Monitor trends** - track bundle size in CI

## When to Use This

- Your app loads slowly and you suspect the bundle
- Adding a new dependency and want to check the impact
- Performance audit flagged JavaScript size
- CI bundle size check is failing

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgic.dev

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-bundle-check --help
```

## How It Works

Scans your package.json and build output, identifies heavy dependencies, and sends the analysis to GPT-4o-mini. The AI knows common bundle bloat patterns and suggests specific optimizations like switching libraries or adding tree-shaking config.

## License

MIT. Free forever. Use it however you want.

Overview

This skill analyzes your JavaScript bundle and gives actionable AI-powered recommendations to shrink it. It inspects build output and package metadata to pinpoint what consumes space and why. The result is a clear, prioritized plan to reduce payload size and improve load performance.

How this skill works

The tool scans your project folder and build artifacts, parsing package.json and generated bundles to list modules by size. It detects common bloat patterns—large dependencies, non-tree-shaken code, duplicated assets—and queries an AI model to produce tailored optimization steps. Output includes largest files, suggestions for lighter alternatives, and specific tree-shaking or code-splitting changes.

When to use it

  • Your application loads slowly and you suspect bundle size issues
  • Before shipping a release to catch regressions early
  • After adding a new dependency to evaluate its impact
  • When CI flags bundle size or when running performance audits
  • When you want concrete migration recommendations to lighter libraries

Best practices

  • Run bundle analysis as part of CI to detect regressions
  • Prefer tree-shakable libraries and avoid importing entire packages
  • Use dynamic imports for non-critical code paths
  • Compare suggested alternatives and test compatibility before swapping libraries
  • Track bundle size trends and set size budgets

Example use cases

  • One-command analysis of a local project to list the top size offenders
  • Verbose report showing per-file and per-dependency breakdowns for a production build
  • CI integration that fails builds when size budgets exceed thresholds
  • Guidance to replace heavy libraries (e.g., moment.js) with lighter alternatives (e.g., date-fns)
  • Advice on where to apply code splitting and how to adjust bundler config

FAQ

Does this require installation?

No install is required; run it with npx. Node.js 18+ is recommended.

Does it send code to an external AI?

The tool sends bundle analysis data to the configured AI model (requires an OPENAI_API_KEY) to generate tailored suggestions.

Can it break my build?

It only analyzes and suggests changes; it does not modify your source or build artifacts automatically.

What inputs does it need?

Point it at your project directory or build output. It reads package.json and generated bundles to produce the report.