migrate-oxlint

Migrate JavaScript/TypeScript linting from ESLint to Oxlint with @oxlint/migrate.

785|169|Updated Aug 8, 2024
One-click install
npx skills add https://github.com/Ohh-889/skyroc-admin --skill migrate-oxlint-ohh-889
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-oxlint
Source: https://github.com/Ohh-889/skyroc-admin/tree/main/.agents/skills/migrate-oxlint
Command: npx skills add https://github.com/Ohh-889/skyroc-admin --skill migrate-oxlint-ohh-889

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ESLint configurations can slow migration and hinder performance; this skill provides a structured, tool-assisted path to replace ESLint with Oxlint, reducing setup friction and enabling a modern linting workflow.

Core Features & Use Cases

  • Automated migration using the official @oxlint/migrate tool to generate a compatible .oxlintrc.json.
  • Clear guidance for reviewing, adjusting plugins, and updating CI/scripts after migration.
  • Step-by-step best practices for handling unsupported features and ensuring a smooth transition.

Quick Start

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

Frequently Asked Questions about migrate-oxlint

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

FAQPage Schema
How do I migrate an ESLint configuration to Oxlint in a TypeScript project?

You can migrate ESLint to Oxlint by running npx @oxlint/migrate from your project root, which automatically generates a compatible .oxlintrc.json file. The tool maps existing ESLint plugins and configurations to their Oxlint equivalents for a modern linting workflow.

What's the best way to update CI pipelines when moving from ESLint to Oxlint?

When moving from ESLint to Oxlint, update your CI pipelines by replacing ESLint execution commands with Oxlint equivalents. You should review the generated .oxlintrc.json, adjust plugin mappings, and run tests to ensure a smooth transition.

Does the Oxlint migration tool support all custom ESLint plugins?

The Oxlint migration tool maps existing ESLint plugins, but unsupported features may exist. It provides step-by-step guidance for handling unsupported plugins and best practices for adjusting your configuration to ensure compatibility during the transition.

Why should I migrate my JavaScript linting from ESLint to Oxlint?

Migrating JavaScript linting from ESLint to Oxlint modernizes your tooling and significantly reduces runtime overhead. It replaces slow ESLint configurations with a faster, modern linting workflow, reducing setup friction and improving performance.

What limitations should I expect when converting my .eslintrc file to .oxlintrc.json?

When converting .eslintrc to .oxlintrc.json, expect potential limitations with unsupported ESLint features. The migration process includes reviewing generated configurations, manually adjusting unmapped plugins, and following best practices for post-migration testing.