Skip to main content

Migrate skill

The bestax-migrate skill teaches an agent to move an existing app from react-bulma-components (unmaintained since 2022, Bulma 0.9.x) to @allxsmith/bestax-bulma on Bulma v1. It drives the bestax-migrate codemod and then resolves everything the codemod flags.

Unlike the other skills, this one is not bundled by create-bestax — it's for existing sites, not new ones.

Install​

npx skills add https://github.com/allxsmith/bestax --skill bestax-migrate

What the agent does with it​

  1. Runs pnpm dlx bestax-migrate react-bulma-components src/ --dry, reviews the report, then applies the codemod for real — that rewrites the components, the stylesheets (CSS/SCSS onto Bulma v1 + the bestax extras), and package.json (react-bulma-components removed, @allxsmith/bestax-bulma added, bulma → ^1, node-sass → sass).
  2. Installs the rewritten dependencies (npm install / pnpm install) — the codemod never runs a package manager itself, and its peer-deps report entries call out React (older than 18) or Font Awesome (older than 6) blockers first.
  3. Greps for TODO(bestax-migrate) comments and resolves each one using the skill's reference tables — the component map, the universal prop map, and per-case recipes for the patterns the codemod deliberately refuses to guess at (Tile → Grid, controlled Dropdown, touch breakpoints, dynamic prop values, …).
  4. Finishes the flagged CSS cases (computed Sass variables, indented-syntax files, third-party Bulma extensions) and verifies the build.

Example prompt​

This app uses react-bulma-components. Migrate it to @allxsmith/bestax-bulma
following the bestax-migrate skill, and make sure the build passes when you're done.

References bundled with the skill​

  • references/component-map.md — all 32 react-bulma-components components (and every compound sub-component) with their bestax targets.
  • references/prop-map.md — the universal modifier-prop conversions and responsive breakpoint-object flattening.
  • references/unmappables.md — a recipe for every TODO(bestax-migrate) the codemod can leave.
  • references/css-migration.md — the Bulma 0.9 → 1 CSS step.

See the full migration guide for the codemod itself.