migrate-oxlint

Migrate ESLint configurations to Oxlint and generate .oxlintrc.json.

1|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/mohamed-g-shoaib/forge --skill migrate-oxlint-mohamed-g-shoaib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-oxlint
Source: https://github.com/mohamed-g-shoaib/forge/tree/main/.agents/skills/migrate-oxlint
Command: npx skills add https://github.com/mohamed-g-shoaib/forge --skill migrate-oxlint-mohamed-g-shoaib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ESLint configurations and workflows can be difficult to port to Oxlint; this guide provides a clear pathway to switch linting tooling, standardize rules, and align configurations.

Core Features & Use Cases

  • Provides an official migration tool (@oxlint/migrate) to convert ESLint configs to Oxlint.
  • Demonstrates how to generate .oxlintrc.json from common ESLint setups and handles TypeScript projects.
  • Includes guidance for plugin mapping, rule considerations, and manual adjustments during migration.

Quick Start

Run the migration tool from your project root with npx @oxlint/migrate to generate the .oxlintrc.json.

Frequently Asked Questions about migrate-oxlint

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

FAQPage Schema
How do I migrate ESLint configs to Oxlint?

To migrate ESLint configs to Oxlint, run the @oxlint/migrate tool from your project root via npx to automatically generate a .oxlintrc.json file from your existing setup.

What is the @oxlint/migrate tool used for?

The @oxlint/migrate tool converts existing ESLint configurations into Oxlint formats, handling plugin mapping and generating a valid .oxlintrc.json file for JavaScript and TypeScript projects.

Does Oxlint migration work with TypeScript projects?

Yes, Oxlint migration fully supports TypeScript projects by converting existing ESLint configurations and providing specific guidance for handling type-aware settings during the transition.

Can I map ESLint plugins to Oxlint automatically?

Yes, the Oxlint migration process handles plugin mapping automatically, converting your existing ESLint plugins into their corresponding Oxlint equivalents within the generated .oxlintrc.json.

What do I need to run an ESLint to Oxlint migration?

To run the migration, you need an existing ESLint config file, the @oxlint/migrate tool, and Oxlint installed in your JavaScript or TypeScript project to produce a valid configuration.

Are there limitations when converting ESLint rules to Oxlint?

While the migration tool automates plugin mapping and rule conversion, you may need manual adjustments for specific rule considerations and type-aware settings that do not map directly to Oxlint.