Skip to content
Skills Library
Design & UX · Review & audit

bootstrap-optimizer

/bootstrap-optimizer

Audit and optimize Bootstrap 5.3 usage (Bootstrap 6 is alpha only) for full CSS/JS imports, Sass variable duplication, data-bs plugin initialization, CSS variables/dark mode, RTL, bundle size, framework conflicts and the v5-to-v6 migration, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions Bootstrap, bootstrap.scss, data-bs-*, Bootstrap modal/dropdown, Bootstrap 6, or "optimize my Bootstrap UI" -- even if they never say audit or optimize.

Licence
MIT
Last repository change
04.11.2026

Assessment and security

85/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
8
Scripts
1
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 04.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/audit.py

What it does and when to use it

Audit and optimize Bootstrap 5.3 usage (Bootstrap 6 is alpha only) for full CSS/JS imports, Sass variable duplication, data-bs plugin initialization, CSS variables/dark mode, RTL, bundle size, framework conflicts and the v5-to-v6 migration, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions Bootstrap, bootstrap.scss, data-bs-*, Bootstrap modal/dropdown, Bootstrap 6, or "optimize my Bootstrap UI" -- even if they never say audit or optimize.

Triggers from the description

optimize my Bootstrap UI
Original author description

Audit and optimize Bootstrap 5.3 usage (Bootstrap 6 is alpha only) for full CSS/JS imports, Sass variable duplication, data-bs plugin initialization, CSS variables/dark mode, RTL, bundle size, framework conflicts and the v5-to-v6 migration, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions Bootstrap, bootstrap.scss, data-bs-*, Bootstrap modal/dropdown, Bootstrap 6, or "optimize my Bootstrap UI" -- even if they never say audit or optimize.

How it works

  1. Workflow
  2. Principles
  3. Docs
Original SKILL.md headings · 61 lines, 589 words
SKILL.md preview
---
name: bootstrap-optimizer
description: Audit and optimize Bootstrap 5.3 usage (Bootstrap 6 is alpha only) for full CSS/JS imports, Sass variable duplication, data-bs plugin initialization, CSS variables/dark mode, RTL, bundle size, framework conflicts and the v5-to-v6 migration, with real before/after measurement. Always produces a written findings report and a fix plan for approval before touching code. Use this whenever the user mentions Bootstrap, bootstrap.scss, data-bs-*, Bootstrap modal/dropdown, Bootstrap 6, or "optimize my Bootstrap UI" -- even if they never say audit or optimize.
---

# Bootstrap Optimizer

Bootstrap 5.3 is a CSS framework plus small JS plugins. The cost is the full CSS/JS bundle, custom Sass duplication and plugin initialization; Bootstrap 6 is an alpha and not the production target. Optimize imports, Sass variables and which plugins load per page.

## Workflow

### 1. Scope (quick)

- Find the app root and detect Bootstrap usage: `Bootstrap 5.3.8 (6 alpha)`. Record the version, framework (React/Next/Vue/Svelte/Solid/Angular or HTML), styling system, and whether the library is a package, a CSS-only kit, or copied source.
- Run `python <skill-dir>/scripts/audit.py <project-root>` -- static scan of `package.json`, config/CSS files and source for version drift, full CSS/JS imports, Sass variable duplication, uninitialized data-bs plugins, dark-mode flash, framework conflicts and v6 migration risk, with file:line evidence. Use `--json` to post-process.
- Classify the pain: bundle/import cost, runtime/re-render cost, theming/SSR style flash, accessibility/forms, large tables/lists, or migration/upgrade. Ask which hurts if unclear.
- Read `references/tooling.md` once: what can be measured here.

- Check how Bootstrap is imported (full CSS vs Sass modules), whether the JS bundle is global, and whether a second CSS framework is fighting its reset.

### 2. Audit

The script finds cheap leads; you find the rest by reading. Read the install/config, the global CSS/theme file, the provider or plugin setup, and the 3-5 most-used components. Load only what applies:

| Area | Reference |
|------|-----------|
| Install, config, provider/plugin, theming, SSR | `references/setup.md` |
| Bundle/imports, runtime, a11y/forms, tables, upgrades | `references/optimizations.md` |
| Measurement and honest reporting | `references/tooling.md` |

**Measure, never guess.** Build for production and measure the real route/bundle. Inspect SSR HTML for style tags and dark-mode flash; run axe/Playwright on dialogs, menus, forms and tables. Component count, bundle bytes and a11y violations are evidence; "feels heavy" is not.

Mark each finding **Confirmed** (build/analyzer/axe/code evidence) or **Suspected** (needs measuring).

### 3. Report

Fill `assets/report-template.md`, save it as `BOOTSTRAP_OPTIMIZATION_REPORT.md` in the project root, and show the user. Five-line summary, findings table by impact/effort, then per-finding detail (evidence, why it hurts, fix, risk, visual/behavior impact). Group near-duplicates.

### 4. Plan -- then stop for approval

Use plan mode: `EnterPlanMode` (load with ToolSearch if deferred), write the plan, present with `ExitPlanMode`; if unavailable show it in chat and wait for an explicit "go". Structure:

1. **Quick wins** -- trim imports, use path imports, add provider/plugin correctly, add missing labels/titles, move heavy components off the initial route, remove per-row overlays, align theme tokens, add SSR style/cache setup. Low risk.
2. **Structural** -- split component boundaries, virtualize tables, lazy-load heavy widgets, consolidate theming, migrate variants/tokens, fix form composition, deduplicate copied components. Name each behavior change.
3. **Heavy** -- major upgrade, primitive-base change, CSS-only to styled kit (or reverse), Tailwind 3 to 4, copy-in registry extraction, SSR architecture. Separately approved.
   Each step: files touched, expected effect, how to verify, how to roll back.

### 5. Fix

Only approved items, in small groups. After each: typecheck, lint, tests, production build, and a visual/axe check on affected components. A break must trace to one change. Do not mix a major migration with optimization edits. If a change alters a public component API, theme tokens or SSR behavior, stop and ask.

### 6. Verify and wrap up

Re-measure the same routes/components: route JS/CSS, SSR styles/theme, axe violations, dialog/form keyboard flow, table interaction. State plainly what could not be measured. End with deferred items and one suggested next step.

## Principles

- **One CSS framework.** Resets fight.
- **Import modules, not the bundle.**
- **Plugins are per page.** Initialize what exists.

## Docs

- https://getbootstrap.com/docs/5.3/getting-started/introduction/
Files in this package (8)
  • LICENSE 1 KB
  • README.md 1 KB
  • SKILL.md 5 KB
  • assets/report-template.md 1 KB
  • references/optimizations.md 1 KB
  • references/setup.md 1 KB
  • references/tooling.md 1 KB
  • scripts/audit.py 10 KB

Versions

The database has no other skills named bootstrap-optimizer.

Database snapshot: 13.11.2026 · package version 1148783a7792 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85sass-scss-optimizer
    Audit and optimize Sass/SCSS (Dart Sass 1.107) for @import deprecation, @use/@forward module structure, legacy JS API/node-sass, deprecated color functions, slash division, @extend/nesting bloat, output size, source maps and the Dart Sass 2 migration, with real before/after…
  • 100bootstrap-vite
    Include and bundle Bootstrap 6's CSS and JavaScript in a project using Vite. Use when setting up Bootstrap with Vite, bundling Bootstrap's Sass and JS through Vite, or creating a Vite-based Bootstrap project.
  • 85tailwindcss-optimizer
    Audit and optimize Tailwind CSS 4.3 usage for CSS-first setup, @theme/@source/@utility, dynamic class names, broad safelists, @apply sprawl, legacy v3 directives/config, cascade layers, dark mode, content detection and the v3-to-v4 migration, with real before/after measurement.…
  • 100bootstrap-color-system
    Work with Bootstrap 6's color system in Sass and CSS. Use when customizing colors, adding or overriding theme colors, working with color modes, or using the color scales, semantic tokens, and theme classes.
  • 100css-modules-and-sass
    Use this skill when maintaining scoped component styles, Sass mixins, nested rules, and variables using CSS Modules and Sass/SCSS.
  • 90fe-sass
    Writes and reviews Sass (SCSS) for Dart Sass - the module system with @use and @forward, sass:math and sass:color, division, placeholders, the project's px-to-rem helper - and says when plain CSS now does the job. Use when editing .scss files or scss style blocks, removing…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.