migrate-oxfmt

Migrate Prettier or Biome formatter configurations to .oxfmtrc.json files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/SeanChenR/maestro-agent --skill migrate-oxfmt-seanchenr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-oxfmt
Source: https://github.com/SeanChenR/maestro-agent/tree/main/.agents/skills/migrate-oxfmt
Command: npx skills add https://github.com/SeanChenR/maestro-agent --skill migrate-oxfmt-seanchenr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating a JavaScript or TypeScript codebase from Prettier or Biome to Oxfmt can be error-prone and time consuming because formats, defaults, plugins, and CI commands differ; this Skill provides a clear, stepwise migration path and guidance to review the automated output.

Core Features & Use Cases

  • Automated migration command that reads Prettier or Biome config and writes a migrated .oxfmtrc.json with mapped options.
  • Maps common formatter options (printWidth/tabWidth/useTabs/semi/singleQuote), migrates Tailwind and package.json sorting options when detected, and documents unsupported or manual tasks such as overrides and nested configs.
  • Use case: convert a monorepo previously formatted with Prettier to Oxfmt, update CI checks to oxfmt --check, and reconcile editor and LSP settings.

Quick Start

Run the migration tool to convert your Prettier or Biome configuration into a .oxfmtrc.json, review the generated settings, and update CI/editor commands as needed.

Frequently Asked Questions about migrate-oxfmt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Prettier config to Oxfmt in a JavaScript or TypeScript project?

To migrate Prettier config to Oxfmt, run a migration tool that reads your existing settings and writes a mapped .oxfmtrc.json file. You need to review the generated configuration and manually convert any unsupported overrides before committing.

Can I migrate Biome formatter settings to an Oxfmt configuration file?

Yes, you can migrate Biome formatter settings to an Oxfmt configuration file. The migration process reads your Biome config, maps common formatter options like printWidth and semi, and outputs a .oxfmtrc.json file for your JavaScript or TypeScript codebase.

How do I update CI and editor commands when switching to Oxfmt?

When switching to Oxfmt, update your CI checks to use oxfmt --check and reconcile your editor and LSP settings. The migration process flags unsupported nested configs so you can manually adjust your automated formatting pipeline.

What formatter options are automatically mapped during an Oxfmt migration?

During an Oxfmt migration, common formatter options like printWidth, tabWidth, useTabs, semi, and singleQuote are automatically mapped. It also migrates Tailwind and package.json sorting options when detected in your original Prettier or Biome configuration.

What are the limitations of migrating formatter configurations to Oxfmt?

The limitations of migrating to Oxfmt include unsupported or non-migratable overrides and nested configs that require manual conversion. You must review the generated .oxfmtrc.json before committing and enforcing it via CI to ensure accurate formatting.

Does the Oxfmt migration tool support monorepos with Tailwind and packagejson plugins?

Yes, the Oxfmt migration tool supports monorepos by migrating Tailwind and package.json sorting options when detected. It provides a stepwise path to convert configurations, update CI checks, and reconcile editor settings across your JavaScript or TypeScript packages.