migrate-oxlint

Installation

Summary

Automated migration guide from ESLint to Oxlint with rule mapping and configuration review.

Uses the official @oxlint/migrate tool to automatically convert ESLint flat configs to .oxlintrc.json, with options for type-aware rules, experimental rules, and plugin migration
Maps 13+ popular ESLint plugins (TypeScript, React, Import, Unicorn, Jest, etc.) to built-in oxlint equivalents; unmigrated rules can be identified with --details
Covers manual handling of unsupported features: local plugins, Prettier integration (use oxfmt instead), and external ESLint plugins via jsPlugins
Provides CLI command equivalents and migration tips including gradual rollout, parallel ESLint/oxlint execution, and disable-comment compatibility

SKILL.md

This skill guides you through migrating a JavaScript/TypeScript project from ESLint to Oxlint.

Overview

Oxlint is a high-performance linter that implements many popular ESLint rules natively in Rust. It can be used alongside ESLint or as a full replacement.

An official migration tool is available, and will be used by this skill: @oxlint/migrate

Step 1: Run Automated Migration

Run the migration tool in the project root:

npx @oxlint/migrate

This reads your ESLint flat config (eslint.config.js for example) and generates a .oxlintrc.json file from it. It will find your ESLint config file automatically in most cases.

See options below for more info.

Related skills