migrate-oxfmt
This skill walks you through converting your JavaScript/TypeScript formatter from Prettier or Biome to Oxfmt, a high-performance alternative. It covers running the built-in automated migration tool, reviewing and adjusting the generated config, and configuring Oxfmt-specific features like import sorting and Tailwind CSS class ordering.
migrate-oxfmt guides you through switching your JavaScript/TypeScript project's formatter from Prettier or Biome to Oxfmt.
AI-generated summary based on this skill's SKILL.md
Install
oxc-project/oxc/migrate-oxfmt · repository language: Rust
git clone https://github.com/oxc-project/oxc
cp -r oxc/.agents/skills/migrate-oxfmt ~/.claude/skills/migrate-oxfmtnpx skillfed install oxc-project/oxc/migrate-oxfmtFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I migrate from Prettier to Oxfmt?
migrate-oxfmt guides you through converting your JavaScript/TypeScript project from Prettier to Oxfmt. The skill covers running the built-in automated migration tool, which converts your Prettier configuration automatically. After migration, you'll review the generated Oxfmt config, adjust any settings as needed, and configure Oxfmt-specific features like import sorting and Tailwind CSS class ordering for your project.
Can migrate-oxfmt help me switch from Biome to Oxfmt formatter?
Yes. migrate-oxfmt supports migrating from Biome to Oxfmt as a primary use case. The skill provides an automated migration tool that converts your Biome configuration to Oxfmt format, helping you understand the equivalent configuration options between the two formatters and ensuring a smooth transition for your JavaScript/TypeScript codebase.
What does the automated migration tool in migrate-oxfmt do?
migrate-oxfmt's automated migration tool converts formatter configs from Prettier or Biome to Oxfmt format. It analyzes your existing configuration, maps settings to their Oxfmt equivalents, and generates a new config file. The tool handles the technical conversion work, allowing you to focus on reviewing the output and making any project-specific adjustments needed.
How do I convert Prettier config to Oxfmt with migrate-oxfmt?
migrate-oxfmt provides step-by-step guidance for converting your Prettier configuration to Oxfmt. The skill explains Oxfmt configuration options and their Prettier equivalents, helping you understand how settings map between formatters. You'll use the automated migration tool to generate your initial Oxfmt config, then adjust Oxfmt-specific features like import sorting and Tailwind CSS class ordering as needed.
Does migrate-oxfmt help update CI/CD after formatter migration?
migrate-oxfmt covers updating CI/CD scripts and build tools after switching to Oxfmt. The skill helps you configure your pipeline to use Oxfmt instead of Prettier or Biome, ensuring your automated checks and formatting steps work correctly in your development and deployment workflows.
What Oxfmt-specific features does migrate-oxfmt help configure?
migrate-oxfmt walks you through configuring Oxfmt-specific features beyond basic formatting. These include import sorting and Tailwind CSS class ordering, which are unique to Oxfmt. The skill helps you understand these capabilities and set them up appropriately for your JavaScript/TypeScript project after completing the migration from Prettier or Biome.
SKILL.md
rendered from the published skill — quoted content, verbatim
This skill guides you through migrating a JavaScript/TypeScript project from Prettier or Biome to Oxfmt.
Overview
Oxfmt is a high-performance, Prettier-compatible code formatter. Most Prettier options are supported directly.
An automated migration tool is built into oxfmt, supporting both Prettier and Biome as migration sources.
Step 1: Run Automated Migration
First, decide whether the automated tool fits:
- Static root config (JSON/YAML, or a JS/TS config that just exports a plain object): use
--migratebelow. - Dynamic JS/TS config (logic such as environment branches or computed values):
--migratewrites only a resolved snapshot of the values — the logic does not survive. Migrate manually instead, porting the logic tooxfmt.config.tswith the option mappings in this guide. - Nested per-directory configs:
--migrateonly handles the config found from the current directory. Migrate
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.agents/skills/migrate-oxfmt/SKILL.md