К основному содержанию
скилл CX Codex

oxlint — скилл для Claude Code: что делает и как установить

Скилл для Claude Code запускает линтер oxlint и настраивает его правила. Включается при наличии oxlint в package.json или конфигурационных файлов в корне проекта.

MIT 1 000 установок ★ 2 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add delexw/claude-code-misc --skill oxlint -a claude-code
Открыть на GitHub

Что делает oxlint

Скилл проверяет файлы JavaScript и TypeScript с помощью линтера oxlint на базе Oxc, применяя свыше 690 правил из каталогов ESLint и TypeScript. Перед запуском агент проверяет зависимости в package.json либо наличие файлов .oxlintrc.json или oxlint.config.ts. Если следов oxlint в проекте нет, агент не выполняет проверку.

Команда запускает npx oxlint либо проектный скрипт линтинга. Безопасные исправления вносятся через флаг --fix, а флаг --fix-dangerously агент избегает, пока пользователь явно его не запросит. Для интеграции с CI поддерживаются форматы вывода json, github и unix.

Для проверки правил с учётом типов через опцию typeAware в проекте обязательно требуется рабочий tsconfig.json.

Какие задачи решает

  • проверить код JavaScript и TypeScript через oxlint
  • исправить ошибки форматирования и линтинга флагом --fix
  • создать начальный файл конфигурации .oxlintrc.json
  • подключить дополнительные плагины вроде React или Next.js

Примеры запросов агенту

  • Проверь проект через oxlint и примени безопасные фиксы
  • Создай начальный конфиг .oxlintrc.json с плагином react
  • Запусти oxlint только для файлов в папке src/components

Как установить oxlint

1Через Skills CLI (Vercel)

npx skills add delexw/claude-code-misc --skill oxlint -a claude-code

2Вручную: положить файлы

~/.claude/skills/oxlint/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/oxlint/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об oxlint

Как установить oxlint в Claude Code?

Выполните команду npx skills add delexw/claude-code-misc --skill oxlint -a claude-code.

Что делает скилл oxlint?

Скилл учит агента распознавать наличие oxlint в репозитории, запускать анализ файлов, применять автоисправления и править файл .oxlintrc.json.

Что нужно для работы type-aware проверок?

Для опции typeAware: true или флага --type-aware в проекте обязательно должен присутствовать файл tsconfig.json.

Исходный текст

SKILL.md · MIT
---
name: oxlint
description: "Run and configure oxlint — the high-performance JavaScript/TypeScript linter built on the Oxc compiler stack. Use this skill whenever working in a project that has oxlint installed (check for `oxlint` in package.json devDependencies or an `.oxlintrc.json` / `oxlint.config.ts` config file). This includes when you need to lint code after making changes, fix linting errors, configure oxlint rules/plugins, set up or modify `.oxlintrc.json`, or migrate from ESLint."
---

# Oxlint — High-Performance JS/TS Linter

Oxlint is 50-100x faster than ESLint. It ships with 690+ rules covering ESLint core, TypeScript, React, Jest, Unicorn, jsx-a11y, and more. It prioritizes high-signal correctness checks by default — things that are incorrect, unsafe, or useless — so teams can adopt it without drowning in false positives.

## Detection

Before linting, confirm the project uses oxlint by checking for any of:
- `oxlint` in `package.json` devDependencies/dependencies
- An `.oxlintrc.json` file in the project root
- An `oxlint.config.ts` file in the project root
- An `oxlint` or `lint` script in `package.json` that references `oxlint`

If none of these exist, the project doesn't use oxlint — don't run it.

## Running Oxlint

### After code changes
Run oxlint to check your work. Prefer the project's npm script if one exists:

```bash
# If package.json has a lint script using oxlint
npm run lint

# Otherwise, run directly
npx oxlint
```

### Fixing issues automatically
```bash
npx oxlint --fix
```

Use `--fix` for safe automatic fixes. Avoid `--fix-dangerously` unless the user explicitly asks for it — it can apply unsafe transformations.

### Linting specific files
After editing only a few files, you can lint just those:
```bash
npx oxlint src/components/Button.tsx src/utils/helpers.ts
```

### Interpreting output
Oxlint prints diagnostics with rule names in parentheses, e.g. `(no-unused-vars)`. When fixing:
1. Read the diagnostic message carefully — oxlint gives precise, actionable information
2. Fix the underlying code issue rather than suppressing the rule
3. Only add `// oxlint-ignore` comments as a last resort when the diagnostic is a genuine false positive

### Output formats
For CI or tooling integration:
```bash
npx oxlint --format json        # Machine-readable JSON
npx oxlint --format github      # GitHub Actions annotations
npx oxlint --format unix        # Simple one-line-per-error format
```

## Configuration

### Creating a config
```bash
npx oxlint --init
```
This generates an `.oxlintrc.json` starter config.

### Config file format (.oxlintrc.json)
The config uses JSONC (JSON with comments). Key sections:

```jsonc
{
  // Enable/disable individual rules with severity levels
  "rules": {
    "no-unused-vars": "error",
    "no-console": "warn",
    "no-plusplus": ["error", { "allowForLoopAfterthoughts": true }]
  },

  // Enable groups of related rules by category
  "categories": {
    "correctness": "error",   // Definitely-wrong code
    "suspicious": "warn",     // Probably-wrong code
    "pedantic": "off",        // Opinionated style checks
    "perf": "warn",           // Performance anti-patterns
    "style": "off",           // Cosmetic preferences
    "restriction": "off",     // Extra-strict rules (opt-in)
    "nursery": "off"          // Unstable/experimental rules
  },

  // Plugins to enable (setting this overwrites defaults, so list all you want)
  "plugins": ["typescript", "unicorn", "oxc"],

  // File-specific overrides
  "overrides": [
    {
      "files": ["**/*.test.{ts,tsx}"],
      "rules": { "no-console": "off" }
    },
    {
      "files": ["scripts/**"],
      "rules": { "no-console": "off" }
    }
  ],

  // Environment globals
  "env": {
    "browser": true,
    "node": true
  },

  // Plugin-wide settings
  "settings": {
    "react": {
      "linkComponents": [{ "name": "Link", "linkAttribute": "to" }]
    },
    "jsx-a11y": {
      "components": { "Link": "a", "Button": "button" }
    }
  },

  // Type-aware linting (requires tsconfig)
  "options": {
    "typeAware": true
  }
}
```

### Rule severity levels
- `"off"` / `"allow"` — Disable the rule
- `"warn"` — Report but don't fail the build
- `"error"` / `"deny"` — Report and exit non-zero

Unique rule names can omit plugin prefix: `"no-console"` = `"eslint/no-console"`.

### Categories
Categories group rules by intent. The recommended starting point:
- `correctness: "error"` — Always on. Catches real bugs.
- `suspicious: "warn"` — Good signal, occasionally noisy.
- Everything else: enable incrementally as the team is ready.

### Available plugins
**Enabled by default:** `typescript`, `unicorn`, `oxc`

**Opt-in (CLI flags or config):**
| Plugin | CLI flag | Purpose |
|--------|----------|---------|
| react | `--react-plugin` | React-specific rules |
| jsx-a11y | `--jsx-a11y-plugin` | Accessibility rules for JSX |
| nextjs | `--nextjs-plugin` | Next.js best practices |
| import | `--import-plugin` | Import/export validation |
| jest | `--jest-plugin` | Jest testing rules |
| vitest | `--vitest-plugin` | Vitest testing rules |
| jsdoc | `--jsdoc-plugin` | JSDoc documentation rules |
| node | `--node-plugin` | Node.js-specific rules |
| promise | `--promise-plugin` | Promise best practices |
| react-perf | `--react-perf-plugin` | React performance rules |
| vue | `--vue-plugin` | Vue.js rules |

To disable a default plugin: `--disable-typescript-plugin`, `--disable-unicorn-plugin`, `--disable-oxc-plugin`.

### Extending shared configs
```jsonc
{
  "extends": ["./configs/base.json", "./configs/frontend.json"]
}
```
Later entries override earlier ones. Paths resolve relative to the declaring config.

### Monorepo support
Oxlint supports nested configs. Each directory can have its own `.oxlintrc.json` that overrides parent settings. Disable with `--disable-nested-config` if unwanted.

## CLI Quick Reference

| Flag | What it does |
|------|-------------|
| `-c, --config=PATH` | Use a specific config file |
| `--tsconfig=PATH` | TypeScript config for path aliases |
| `--fix` | Auto-fix safe issues |
| `--fix-suggestions` | Also apply suggested fixes |
| `-A, --allow=RULE` | Suppress a rule (e.g., `-A no-console`) |
| `-W, --warn=RULE` | Warn on a rule |
| `-D, --deny=RULE` | Error on a rule |
| `--quiet` | Suppress warnings, show only errors |
| `--deny-warnings` | Treat warnings as errors (exit non-zero) |
| `--max-warnings=N` | Fail if more than N warnings |
| `-f, --format=FMT` | Output format: default, json, github, unix, etc. |
| `--ignore-pattern=PAT` | Exclude files matching pattern |
| `--type-aware` | Enable type-informed rules (needs tsconfig) |
| `--print-config` | Show resolved config (useful for debugging) |
| `--rules` | List all available rules |

Categories can also be used with `-A`/`-W`/`-D`:
```bash
npx oxlint -D correctness -W suspicious -A pedantic
```

## Suppressing rules inline

```js
// oxlint-ignore no-console -- needed for debug logging
console.log(debugInfo);

// oxlint-ignore-next-line no-unused-vars
const _placeholder = computeValue();
```

Use `oxlint-ignore` (not `eslint-disable`) — oxlint recognizes both, but prefer its native syntax.

## Migrating from ESLint

If the project is moving from ESLint to oxlint:

1. **Side-by-side approach** — Run both linters, with `eslint-plugin-oxlint` disabling rules that oxlint already covers:
   ```bash
   npm install -D eslint-plugin-oxlint
   ```
   Add it as the last plugin in your ESLint config.

2. **Full replacement** — Use `@oxlint/migrate` to convert your ESLint config:
   ```bash
   npx @oxlint/migrate
   ```
   This generates an `.oxlintrc.json` from your existing ESLint configuration.

## Supported file types

`.js`, `.mjs`, `.cjs`, `.ts`, `.mts`, `.cts`, `.jsx`, `.tsx`, `.vue`, `.svelte`, `.astro`

For `.vue`, `.svelte`, and `.astro` files, oxlint lints only the `<script>` blocks.

© delexw · MIT · delexw/claude-code-misc

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
install-anti-slop dmmulroy Скилл install-anti-slop разворачивает в репозитории вендорные плагины Oxlint против антипаттернов кода. Помогает настроить правила линтинга и зафиксировать версии зависимостей. CX Codex +1 16 300установок ultracite secondsky Скилл для настройки Ultracite: линтинг и форматирование JS/TS через Biome, ESLint или Oxlint. Помогает с миграцией и разбором ошибок конфигурации. CX Codex +1 432установок linting-neostandard-eslint9 mcollina Скилл linting-neostandard-eslint9 настраивает ESLint 9 с flat config и базой neostandard в проектах на JavaScript и TypeScript. Помогает перейти с устаревшего .eslintrc и запустить проверки в CI. CX Codex +1 1 200установок typescript-quality claude-dev-suite Скилл typescript-quality для Claude Code: настраивает ESLint, Biome и строгий tsconfig для TypeScript и JavaScript. Включается, когда в проекте расходятся типы и множатся правила линтера. CX Codex +1 1 100установок eslint sanjeed5 С рекомендациями по настройке ESLint в проектах JavaScript и TypeScript. Помогает находить ошибки, проверять возвращаемые значения и поддерживать единый стиль кода. CX Codex +1 ★ 3 589звёзд репо antfu Anthony Fu Скилл antfu задаёт агенту правила Anthony Fu для JavaScript и TypeScript: структура файлов, ESLint, Knip, публикация пакетов. Пригодится при старте проекта и настройке монорепозитория. CX Codex +1 17 400установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой