oxfmt
Installation
SKILL.md
Oxfmt
Use this skill when work touches Oxfmt or Oxc formatting: install/config, day-to-day usage, Prettier/Biome migration, sorting extras, language support, editors, or CI --check gates.
Workflow
- Inspect the local Oxfmt surface before changing code:
- Package version for
oxfmt(still 0.x / beta until 1.0; 0.71 at last refresh). - Config: prefer
oxfmt.config.ts/.mtswithdefineConfig; also accept.oxfmtrc.json(c)(one type per directory); Vite+ may usefmtinvite.config.*instead (nested configs always off in Vite+ mode). - Remaining Prettier/Biome setup,
.prettierignore, scripts (format/format:check), editor default formatter.
- Package version for
- For setup, how-to, style choices, sorting, monorepos, pairing with Oxlint, or troubleshooting, follow the full guide first: usage-guide.md.
- Refresh current official docs when versions differ from the snapshot or the work touches language support, sorting, or migration. Start from source-map.md.
- Route deeper detail to the focused references:
- Install, CLI, config options, editorconfig: setup-cli-config.md.
- Languages, sorting (imports / Tailwind / package.json / JSDoc), ignores, inline comments: languages-sorting-ignores.md.
- Prettier/Biome migration, coexistence, CI, and
.vscodesettings: prettier-migration-ci.md.
- Preserve the project's print width, quote/semi style, and
experimentalOperatorPositionunless migrating or the user asks to change them. - Verify with
bunx oxfmt --check(CI) orbunx oxfmt(write) on the touched paths.