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.