Ultracite：现代JS/TS项目零配置代码检查与格式化工具，比ESLint快100倍

ultracite by secondsky/claude-skills

107 周安装量

102 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/secondsky/claude-skills --skill ultracite

开发代码规范性能优化

🇨🇳中文介绍

Ultracite Skill

为现代 JavaScript/TypeScript 项目提供快速、零配置的代码检查和格式化

概述

Ultracite 是一个统一的代码检查和格式化解决方案，支持多种提供程序：Biome（默认，基于 Rust）、ESLint+Prettier+Stylelint 以及 Oxlint+Oxfmt。它提供特定于框架的预设和零配置默认值，用更快、更简单的替代方案取代传统的 ESLint+Prettier 设置。Ultracite 在后台隐形运行，每次保存时自动格式化代码并应用修复。

版本 7 变更：多提供程序架构、预设路径迁移、MCP 服务器支持、AI 钩子 版本 6 变更：引入特定于框架的预设（React、Next.js、Vue、Svelte 等）

核心目标

闪电般的性能：利用 Biome 的 Rust 实现实现即时代码检查/格式化
零配置设计：提供 200 多个针对现代 TypeScript 开发优化的合理默认值
简单性与隐形性：以最少的用户交互运行
类型安全：强制执行 TypeScript 严格模式及全面的 null/undefined 处理
工具兼容性：与其他开发工具协同工作，无冲突

与替代方案相比的主要优势

对比 ESLint + Prettier:

性能快 10-100 倍（Rust 对比 JavaScript）
单一工具而非两个
无需配置
默认在保存时自动修复
内置 TypeScript 严格模式

对比单独的 Biome:

200 多个预配置规则
特定于框架的预设（React、Next.js、Vue、Svelte）
AI 编辑器集成（Cursor、Claude Code、Copilot）
Git 钩子集成
迁移工具

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

何时使用此技能

在以下情况下使用 Ultracite：

启动新的 JavaScript/TypeScript 项目
使用 React、Next.js、Vue、Svelte 或其他现代框架构建
在 monorepo 中工作（Turborepo、Nx、Lerna）
团队希望获得一致的格式化而无需争论细节
性能至关重要（大型代码库、CI/CD 优化）
从 ESLint + Prettier 迁移到更快的解决方案
使用 AI 编码助手（Cursor、Claude Code、Windsurf）
需要严格类型安全的 TypeScript 项目
具有无障碍访问要求（ARIA、语义化 HTML）的项目

⚠️ 考虑替代方案的情况

有限的框架支持：

需要 Angular/Ember 特定规则（Biome 支持是基础的）
需要高级 CSS 代码检查（仍推荐 Stylelint）

需要 Biome 未复制的特定 ESLint 插件
需要 CSS 中的属性排序（Stylelint 功能）
团队拥有大量自定义 ESLint 配置

具有自定义 ESLint 规则的大型代码库（需要迁移工作）
具有大量 Prettier 自定义配置的项目

有关详细限制和解决方法，请参阅：references/limitations-and-workarounds.md

此技能提供交互式命令和自主代理，以简化工作流程：

/ultracite:doctor - 验证项目设置，检查 v6→v7 预设路径，检测冲突
/ultracite:migrate - 交互式迁移向导（ESLint/Prettier → Ultracite，v6→v7 升级）

config-validator - 分析 biome.jsonc 的语法、预设路径、规则冲突、性能
migration-assistant - 通过规则映射和差距分析指导 ESLint/Prettier 迁移

有关完整的交互功能文档，请参阅 README.md。

Ultracite v7 支持三种代码检查提供程序。根据您的需求选择：

🚀 Biome（默认）- 推荐用于大多数项目

速度：最快（比 ESLint 快 10-100 倍）
设置：零配置，包含 200 多个预设规则
最适合：新项目、TypeScript 优先开发、性能关键型构建
限制：规则比 ESLint 少，CSS/SCSS 支持基础

🔧 ESLint + Prettier + Stylelint - 推荐用于最大兼容性

速度：较慢但生态系统成熟
设置：需要更多配置
最适合：具有现有 ESLint 插件的项目、需要高级 CSS/SCSS 代码检查
限制：基于 JavaScript（较慢），需要多个工具

⚡ Oxlint + Oxfmt - 推荐用于最大速度

速度：最快的代码检查（仅代码检查甚至比 Biome 更快）
设置：具有 TypeScript 集成的类型感知代码检查
最适合：大型 TypeScript 代码库、类型安全关键项目
限制：生态系统较新，规则比 ESLint 少

初始化期间选择提供程序：

bun x ultracite init --linter biome   # 默认
bun x ultracite init --linter eslint  # ESLint + Prettier + Stylelint
bun x ultracite init --linter oxlint  # Oxlint + Oxfmt

加载提供程序特定文档：

Biome：references/provider-biome.md
ESLint：references/provider-eslint.md
Oxlint：references/provider-oxlint.md

破坏性变更：v7 中预设路径已更改。

v6 路径（旧）：

{
  "extends": ["ultracite/core", "ultracite/react"]
}

v7 路径（新）：

{
  "extends": ["ultracite/biome/core", "ultracite/biome/react"]
}

更新 ultracite 包：bun update ultracite
更新 biome.jsonc 中的预设路径（添加 /biome/ 段）
运行 npx ultracite doctor 以验证配置
测试代码检查：npx ultracite check .

新的 v7 功能：

多提供程序支持（Biome、ESLint、Oxlint）
用于 AI 助手的 MCP 服务器集成
AI 钩子（AI 编辑后自动格式化）
类型感知代码检查（Oxlint）
ultracite doctor 诊断命令

加载完整的 v7 迁移指南：references/v7-migration.md

关键变更：引入了特定于框架的预设。

v5 方法（旧）：

{
  "extends": ["ultracite/core"]
}

v6 方法（新）：

{
  "extends": ["ultracite/core", "ultracite/react"]  // 框架预设
}

加载完整的 v6 迁移指南：references/v6-migration.md

项目适用性评估

当调用此技能时，扫描项目并评估：

检查现有工具：

检查 ESLint

ls -la .eslintrc* eslint.config.* package.json | grep eslint

# 检查 Prettier
ls -la .prettierrc* prettier.config.* package.json | grep prettier

# 检查 Biome
ls -la biome.json* package.json | grep biome

2. 识别框架：

 * 检查 `package.json` 中的 `react`、`next`、`vue`、`svelte` 等
 * 推荐合适的预设

3. 评估项目大小：

 * 大型项目（1000+ 文件）最能从 Rust 性能中受益
 * 小型项目可能不会注意到速度差异

4. 检查 TypeScript 配置：

 * 如果存在 `tsconfig.json`，请注意 Ultracite 要求 `strictNullChecks: true`
 * 如果禁用则发出警告（将生成许多警告）

5. 推荐或警告：

    ✅ 推荐：此 TypeScript + React 项目非常适合 Ultracite
- 500+ 文件将从 Rust 性能中受益
- 提供 React 预设
- 可以替换现有的 ESLint + Prettier 设置

⚠️ 考虑：此项目使用高级 ESLint 插件
- 自定义规则：eslint-plugin-custom-security
- 可能需要保留 ESLint 以使用这些特定规则
- 可以仅将 Ultracite 用于格式化

Node.js v14.18+（推荐 v18+）
包管理器：Bun（推荐）、npm、pnpm 或 yarn
项目根目录中的 package.json 文件

快速开始（交互式）

# 使用 Bun（推荐，速度更快）
bun x ultracite init

# 带提供程序选择（v7+）
bun x ultracite init --linter biome   # 默认，最快
bun x ultracite init --linter eslint  # ESLint + Prettier + Stylelint
bun x ultracite init --linter oxlint  # Oxlint + Oxfmt（类型感知）

# 使用 npm
npx ultracite init

# 使用 pnpm
pnpm dlx ultracite init

# 使用 yarn
yarn dlx ultracite init

交互式设置将：

提示选择提供程序（Biome、ESLint、Oxlint）- 仅限 v7+
安装 Ultracite 和提供程序依赖项
提示选择框架（React、Next.js、Vue 等）
询问编辑器设置（VS Code、Cursor 等）
提供 AI 代理规则安装（Cursor、Claude Code、Copilot）
提示 Git 钩子集成（Husky、Lefthook、lint-staged）
提供从现有工具迁移（ESLint、Prettier）
创建/合并配置文件（biome.jsonc、.eslintrc.js 等）
更新 .vscode/settings.json 以进行编辑器集成
在 tsconfig.json 中启用 strictNullChecks（如果是 TypeScript）

非交互式设置（CI/自动化）

# 自动检测设置，跳过提示
bunx ultracite init --quiet

# 显式指定选项（v7+）
bunx ultracite init \
  --linter biome \
  --pm bun \
  --frameworks react,next \
  --editors vscode \
  --agents cursor,claude \
  --integrations husky \
  --migrate eslint,prettier \
  --quiet

--linter：提供程序选择（biome、eslint、oxlint）- 仅限 v7+
--pm：包管理器（bun、npm、pnpm、yarn）
--frameworks：react、next、solid、vue、qwik、angular、remix、svelte
--editors：vscode、zed
--agents：cursor、claude、cline、copilot、windsurf 等
--integrations：husky、lefthook、lint-staged
--migrate：eslint、prettier、biome
--quiet：跳过所有提示（当 CI=true 时自动启用）

手动设置（高级）

# 1. 安装依赖项
bun add -D ultracite @biomejs/biome

# 2. 创建 biome.jsonc
cat > biome.jsonc << 'EOF'
{
  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
  "extends": ["ultracite/core"]
}
EOF

# 3. 创建 VS Code 设置
mkdir -p .vscode
cat > .vscode/settings.json << 'EOF'
{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "quickfix.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  }
}
EOF

# 4. 启用 TypeScript 严格模式
# 添加到 tsconfig.json：
{
  "compilerOptions": {
    "strictNullChecks": true
  }
}

# 检查安装
bunx ultracite doctor

# 预期输出：
# ✔ Biome 已安装
# ✔ 找到配置文件：biome.jsonc
# ✔ 编辑器集成已配置
# ✔ TypeScript 严格模式已启用

project-root/
├── biome.jsonc              # 主配置
├── .vscode/settings.json    # VS Code 集成
├── tsconfig.json            # TypeScript 配置（需要 strictNullChecks）
└── package.json

最小 biome.jsonc：

{
  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
  "extends": ["ultracite/core"],

  // 可选：添加框架预设
  // "extends": ["ultracite/core", "ultracite/react"],

  // 可选：自定义规则
  "linter": {
    "rules": {
      "suspicious": {
        "noConsoleLog": "off"  // 禁用特定规则
      }
    }
  },

  // 可选：排除文件
  "files": {
    "ignore": ["dist", "build", "coverage", "**/*.generated.ts"]
  }
}

ultracite/react：React Hooks、JSX 无障碍访问、组件最佳实践
ultracite/nextjs：React + Next.js App Router、图像优化、文档结构
ultracite/vue：Vue 3 组合式 API、模板语法、响应性
ultracite/svelte：Svelte 4/5 语法、响应式声明

{
  "extends": ["ultracite/core", "ultracite/react"]
}

ultracite/core 预设包含 200 多个规则，涵盖 7 个类别：

无障碍访问：ARIA 验证、语义化 HTML、键盘导航
正确性：类型安全、未使用代码移除、详尽依赖项
性能：代码优化、barrel 文件警告
安全性：防止 eval()、XSS 风险、不安全模式
风格：一致的模式、const 偏好、导入组织
可疑：捕获宽松相等、debugger 语句、拼写错误
复杂度：认知复杂度限制

格式化默认值：2 个空格、80 字符/行、LF 行尾、单引号

有关详细的框架预设、规则描述和高级配置，请参阅：references/configuration-guide.md

IDE 集成（推荐）

VS Code 设置：

安装 Biome 扩展：biomejs.biome
验证 .vscode/settings.json：

{ "editor.defaultFormatter": "biomejs.biome", "editor.formatOnSave": true, "editor.codeActionsOnSave": { "quickfix.biome": "explicit", "source.organizeImports.biome": "explicit" } }
禁用冲突的扩展（ESLint、Prettier）

保存时自动格式化
保存时自动修复（移除未使用的导入、修复顺序、应用严格相等）
粘贴时格式化
问题面板显示不可修复的问题
通过灯泡指示器快速修复

检查代码（仅代码检查）：

bunx ultracite check
bunx ultracite check src/
bunx ultracite check --diagnostic-level error  # 仅错误

修复代码（自动修复）：

bunx ultracite check --write
bunx ultracite check --write src/

格式化代码（仅格式化）：

bunx ultracite format --write
bunx ultracite format --write src/

Package.json 脚本：

{
  "scripts": {
    "lint": "ultracite check",
    "lint:fix": "ultracite check --write",
    "format": "ultracite format --write"
  }
}

Ultracite 自动检测并集成：

Husky：基于 Node.js 的钩子管理器
Lefthook：快速的基于 Go 的钩子管理器
lint-staged：仅对暂存文件运行代码检查器

# Husky
bunx ultracite init --integrations husky

# Lefthook
bunx ultracite init --integrations lefthook

# lint-staged
bunx ultracite init --integrations lint-staged

示例 .husky/pre-commit：

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

ultracite check --staged --write

有关完整的 Git 钩子设置指南（Husky、Lefthook、lint-staged），请参阅：references/git-hooks-setup.md

Ultracite 生成 AI 编辑器规则，教导 AI 助手关于您的代码检查/格式化标准。

支持的编辑器：

Cursor（.cursorrules）
Claude Code（.windsurfrules）
GitHub Copilot（.github/copilot-instructions.md）
Continue.dev（.continuerules）
Codeium（.codeiumrules）
Zed（.zedrules）

bunx ultracite generate-ai-rules
bunx ultracite generate-ai-rules --all  # 所有编辑器
bunx ultracite generate-ai-rules --editor=cursor  # 特定编辑器

有关完整的 AI 编辑器集成指南和自定义，请参阅：references/ai-editor-integration.md

Ultracite 针对 monorepo 进行优化，具有：

共享基础配置
包特定覆盖
Turborepo/Nx 缓存集成
大型工作区性能优化

示例 monorepo 结构：

monorepo/
├── biome.json              # 共享基础配置
├── apps/
│   └── web/
│       └── biome.json      # Next.js 特定覆盖
└── packages/
    └── ui/
        └── biome.json      # React 特定覆盖

有关完整的 monorepo 设置、Turborepo/Nx 集成和性能提示，请参阅：references/monorepo-configuration.md

从 ESLint/Prettier/Biome 迁移

bunx ultracite migrate eslint
bunx ultracite migrate prettier
bunx ultracite migrate biome

分析当前配置
将规则映射到 Biome 等效规则
创建具有等效规则的 biome.json
更新 package.json 脚本
移除旧依赖项
彻底测试

有关包含详细规则映射的完整迁移指南，请参阅：references/migration-guides.md

CSS/SCSS：Biome 不检查 CSS。解决方法：使用 Stylelint 框架支持缺口：有限的 Angular/Astro 支持。解决方法：使用 ultracite/core + 手动规则 ESLint 插件：许多 ESLint 插件没有 Biome 等效项。解决方法：对特定插件与 Ultracite 一起运行 ESLint 文件类型：无 Markdown、YAML、HTML 代码检查。解决方法：使用专用工具（markdownlint、yamllint、htmlhint）

有关限制的完整列表和详细解决方法，请参阅：references/limitations-and-workarounds.md

VS Code 保存时不格式化 → 安装 Biome 扩展，配置设置
ESLint 冲突 → 禁用 ESLint 或选择性运行
解析错误 → 在 biome.json 中配置 JSX 支持
预提交钩子失败 → 使用 bunx 而非全局安装
CI 失败 → 固定 Bun/Node 版本，增加内存限制

有关完整的故障排除指南，请参阅：references/troubleshooting.md

有关自动化设置，请参阅 scripts/install-ultracite.sh。

有关 ESLint/Prettier 迁移，请参阅 scripts/migrate-to-ultracite.sh。

请参阅 references/ 目录中的：

configuration-guide.md：框架预设和规则详情
git-hooks-setup.md：Husky、Lefthook、lint-staged 设置
ai-editor-integration.md：Cursor、Claude Code、Copilot 规则
monorepo-configuration.md：Turborepo、Nx、pnpm 工作区
migration-guides.md：ESLint、Prettier、Biome 迁移
troubleshooting.md：常见问题和解决方案
limitations-and-workarounds.md：已知缺口和修复方法

当前版本（已验证 2025-11-27）：

ultracite：latest
@biomejs/biome：>=1.9.0

npm view ultracite version
npm view @biomejs/biome version

bun update ultracite @biomejs/biome

何时加载参考文档

根据用户问题或任务需求按需加载参考文件：

references/provider-biome.md：当用户询问以下内容时：

Biome 提供程序详情
仅 Biome 配置
Biome 性能优化
Biome 预设路径（v7：ultracite/biome/*）
Biome 规则自定义

references/provider-eslint.md：当用户询问以下内容时：

ESLint 提供程序设置
ESLint + Prettier + Stylelint 集成
ESLint 插件配置
从 ESLint 迁移到 Ultracite
高级 CSS/SCSS 代码检查

references/provider-oxlint.md：当用户询问以下内容时：

Oxlint 提供程序设置
类型感知代码检查功能
Oxlint 性能优势
Oxlint 与 Biome 比较
TypeScript 集成

references/v6-migration.md：当用户询问以下内容时：

从 v5 升级到 v6
框架预设介绍
v6 配置变更
v6 破坏性变更

references/v7-migration.md：当用户询问以下内容时：

从 v6 升级到 v7
预设路径迁移（ultracite/core → ultracite/biome/core）
多提供程序设置
v7 破坏性变更
ultracite doctor 命令

references/mcp-integration.md：当用户询问以下内容时：

MCP 服务器设置
通过 MCP 进行 AI 助手集成
模型上下文协议
MCP 服务器配置

references/ai-hooks.md：当用户询问以下内容时：

AI 钩子设置（区别于 AI 规则）
AI 编辑后自动格式化
编辑器钩子配置
编辑后格式化自动化

references/configuration-guide.md：当用户询问以下内容时：

框架预设（React、Next.js、Vue、Svelte）
核心预设规则（200+ 规则细分）
规则自定义方法
文件排除模式
高级配置

references/git-hooks-setup.md：当用户询问以下内容时：

预提交钩子
Husky 集成
Lefthook 集成
lint-staged 设置
CI/CD 集成
钩子故障排除

references/ai-editor-integration.md：当用户询问以下内容时：

AI 编辑器规则生成
Cursor 集成
Claude Code 集成
GitHub Copilot 设置
自定义 AI 规则
编辑器特定设置

references/monorepo-configuration.md：当用户询问以下内容时：

Monorepo 设置
Turborepo 集成
Nx 集成
包特定覆盖
工作区配置
性能优化

references/migration-guides.md：当用户询问以下内容时：

ESLint 迁移
Prettier 迁移
Biome 迁移
规则映射
迁移清单
迁移后步骤

references/troubleshooting.md：当用户询问以下内容时：

VS Code 问题
ESLint/Prettier 冲突
解析错误
预提交钩子失败
CI 失败
TypeScript 严格性错误
安装问题
性能问题

references/limitations-and-workarounds.md：当用户询问以下内容时：

CSS 代码检查
框架支持缺口
ESLint 插件生态系统
文件类型支持
编辑器集成
迁移限制

Ultracite 提供具有多提供程序支持的统一代码检查和格式化解决方案：

✅ 在以下情况下使用：

启动新项目
使用 React/Next/Vue/Svelte 构建
在 monorepo 中工作
希望无需配置即可获得一致的格式化
性能很重要（Biome/Oxlint 提供程序）
需要 ESLint 兼容性（ESLint 提供程序）
使用 AI 编码助手
需要类型感知代码检查（Oxlint）

⚠️ 在以下情况下考虑替代方案：

需要任何提供程序都不支持的特定 ESLint 插件
需要高级 CSS 代码检查（尽管 ESLint 提供程序包含 Stylelint）
需要遗留框架支持

多提供程序：选择 Biome（最快）、ESLint（最兼容）或 Oxlint（类型感知）
版本 7：预设路径迁移、MCP 服务器、AI 钩子、多提供程序架构
版本 6：特定于框架的预设（React、Next.js、Vue、Svelte 等）
比传统 ESLint + Prettier 快 10-100 倍（Biome/Oxlint）
零配置（为 Biome 预配置 200 多个规则）
特定于框架的预设
AI 编辑器集成 + AI 钩子
Git 钩子支持
强制执行 TypeScript 严格模式

bun x ultracite init --linter biome   # 默认（v7+）
bun x ultracite init --linter eslint  # ESLint 提供程序（v7+）
bun x ultracite init --linter oxlint  # Oxlint 提供程序（v7+）

最常见的工作流程：

使用 bun x ultracite init 安装
选择框架预设（React、Next.js 等）
选择 Git 钩子集成（Husky、Lefthook、lint-staged）
启用 AI 编辑器规则（Cursor、Claude Code、Copilot）
可选地从 ESLint/Prettier 迁移
使用保存时自动格式化进行编码
使用确保质量的预提交钩子提交

在安装前始终检查现有的 Git 钩子管理器
评估项目适用性（扫描 ESLint/Prettier/框架）
根据项目特性推荐或警告
在 TypeScript 项目中启用 strictNullChecks
使用特定于框架的预设以获得最佳结果
根据用户问题按需加载参考文件

🇺🇸English

Ultracite Skill

Fast, zero-config linting and formatting for modern JavaScript/TypeScript projects

Overview

Ultracite is a unified linting and formatting solution that supports multiple providers: Biome (default, Rust-based), ESLint+Prettier+Stylelint , and Oxlint+Oxfmt. It provides framework-specific presets and zero-configuration defaults, replacing traditional ESLint+Prettier setups with a faster, simpler alternative. Ultracite operates invisibly in the background, automatically formatting code and applying fixes on every save.

Version 7 Changes : Multi-provider architecture, preset path migration, MCP server support, AI hooks Version 6 Changes : Framework-specific presets introduced (React, Next.js, Vue, Svelte, etc.)

Core Goals

Lightning-Fast Performance : Leverages Biome's Rust implementation for instant linting/formatting
Zero-Config Design : Ships with 200+ sensible defaults optimized for modern TypeScript development
Simplicity & Invisibility: Operates with minimal user interaction
Type Safety : Enforces TypeScript strict mode and comprehensive null/undefined handling
Tool Compatibility : Works alongside other development tools without conflicts

Key Benefits vs Alternatives

vs ESLint + Prettier:

10-100x faster performance (Rust vs JavaScript)
Single tool instead of two
Zero configuration needed
Auto-fixes on save by default
Built-in TypeScript strict mode

vs Biome alone:

200+ preconfigured rules
Framework-specific presets (React, Next.js, Vue, Svelte)
AI editor integration (Cursor, Claude Code, Copilot)
Git hook integrations
Migration tooling

When to Use This Skill

✅ Ideal Projects

Use Ultracite when:

Starting a new JavaScript/TypeScript project
Building with React, Next.js, Vue, Svelte, or other modern frameworks
Working in monorepos (Turborepo, Nx, Lerna)
Teams want consistent formatting without bikeshedding
Performance is critical (large codebases, CI/CD optimization)
Migrating from ESLint + Prettier to a faster solution
Using AI coding assistants (Cursor, Claude Code, Windsurf)
TypeScript projects requiring strict type safety
Projects with accessibility requirements (ARIA, semantic HTML)

⚠️ Consider Alternatives When

Limited framework support:

Need Angular/Ember-specific rules (Biome support is basic)
Require advanced CSS linting (Stylelint still recommended)

Specialized requirements:

Need specific ESLint plugins not replicated in Biome
Require property ordering in CSS (Stylelint feature)
Team has extensive custom ESLint configurations

Legacy projects:

Large codebases with custom ESLint rules (migration effort required)
Projects with extensive Prettier customization

For detailed limitations and workarounds, see : references/limitations-and-workarounds.md

Interactive Components

This skill provides interactive commands and autonomous agents for streamlined workflows:

Commands

/ultracite:doctor - Validate project setup, check for v6→v7 preset paths, detect conflicts
/ultracite:migrate - Interactive migration wizard (ESLint/Prettier → Ultracite, v6→v7 upgrade)

Agents

config-validator - Analyze biome.jsonc for syntax, preset paths, rule conflicts, performance
migration-assistant - Guide ESLint/Prettier migrations with rule mapping and gap analysis

See README.md for complete interactive features documentation.

Choosing a Provider

Ultracite v7 supports three linting providers. Choose based on your needs:

🚀 Biome (Default) - Recommended for most projects

Speed : Fastest (10-100x faster than ESLint)
Setup : Zero-config with 200+ preset rules
Best for : New projects, TypeScript-first development, performance-critical builds
Limitations : Fewer rules than ESLint, basic CSS/SCSS support

🔧 ESLint + Prettier + Stylelint - Recommended for maximum compatibility

Speed : Slower but mature ecosystem
Setup : Requires more configuration
Best for : Projects with existing ESLint plugins, advanced CSS/SCSS linting needs
Limitations : JavaScript-based (slower), requires multiple tools

⚡ Oxlint + Oxfmt - Recommended for maximum speed

Speed : Fastest linting (even faster than Biome for linting only)
Setup : Type-aware linting with TypeScript integration
Best for : Large TypeScript codebases, type-safety-critical projects
Limitations : Newer ecosystem, fewer rules than ESLint

Provider selection during init:

bun x ultracite init --linter biome   # Default
bun x ultracite init --linter eslint  # ESLint + Prettier + Stylelint
bun x ultracite init --linter oxlint  # Oxlint + Oxfmt

Load provider-specific documentation :

Biome: references/provider-biome.md
ESLint: references/provider-eslint.md
Oxlint: references/provider-oxlint.md

Version Migration Guide

Upgrading from v6 to v7

Breaking Change : Preset paths have changed in v7.

v6 paths (old) :

{
  "extends": ["ultracite/core", "ultracite/react"]
}

v7 paths (new) :

{
  "extends": ["ultracite/biome/core", "ultracite/biome/react"]
}

Migration steps :

Update ultracite package: bun update ultracite
Update preset paths in biome.jsonc (add /biome/ segment)
Run npx ultracite doctor to validate configuration
Test linting: npx ultracite check .

New v7 features :

Multi-provider support (Biome, ESLint, Oxlint)
MCP server integration for AI assistants
AI hooks (auto-format after AI edits)
Type-aware linting (Oxlint)
ultracite doctor diagnostics command

Load full v7 migration guide : references/v7-migration.md

Upgrading from v5 to v6

Key Change : Framework-specific presets introduced.

v5 approach (old) :

{
  "extends": ["ultracite/core"]
}

v6 approach (new) :

{
  "extends": ["ultracite/core", "ultracite/react"]  // Framework preset
}

Load full v6 migration guide : references/v6-migration.md

Project Suitability Assessment

When this skill is invoked, scan the project and assess:

Check existing tooling:

Check for ESLint

ls -la .eslintrc* eslint.config.* package.json | grep eslint

# Check for Prettier
ls -la .prettierrc* prettier.config.* package.json | grep prettier

# Check for Biome
ls -la biome.json* package.json | grep biome

2. Identify framework:

 * Check `package.json` for `react`, `next`, `vue`, `svelte`, etc.
 * Recommend appropriate preset

3. Assess project size:

 * Large projects (1000+ files) benefit most from Rust performance
 * Small projects may not notice speed difference

4. Check TypeScript config:

 * If `tsconfig.json` exists, note that Ultracite requires `strictNullChecks: true`
 * Warn if disabled (will generate many warnings)

5. Recommend or warn:

    ✅ RECOMMENDED: This TypeScript + React project is ideal for Ultracite
- 500+ files will benefit from Rust performance
- React preset available
- Can replace existing ESLint + Prettier setup

⚠️ CONSIDER: This project uses advanced ESLint plugins
- Custom rule: eslint-plugin-custom-security
- May need to retain ESLint for these specific rules
- Could use Ultracite for formatting only

Installation & Setup

Prerequisites

Node.js v14.18+ (v18+ recommended)
Package manager: Bun (preferred), npm, pnpm, or yarn
package.json file in project root

Quick Start (Interactive)

# Using Bun (preferred for speed)
bun x ultracite init

# With provider selection (v7+)
bun x ultracite init --linter biome   # Default, fastest
bun x ultracite init --linter eslint  # ESLint + Prettier + Stylelint
bun x ultracite init --linter oxlint  # Oxlint + Oxfmt (type-aware)

# Using npm
npx ultracite init

# Using pnpm
pnpm dlx ultracite init

# Using yarn
yarn dlx ultracite init

The interactive setup will:

Prompt for provider selection (Biome, ESLint, Oxlint) - v7+ only
Install Ultracite and provider dependencies
Prompt for framework selection (React, Next.js, Vue, etc.)
Ask about editor setup (VS Code, Cursor, etc.)
Offer AI agent rules installation (Cursor, Claude Code, Copilot)
Prompt for Git hook integration (Husky, Lefthook, lint-staged)
Offer to migrate from existing tools (ESLint, Prettier)
Create/merge configuration file (biome.jsonc, .eslintrc.js, etc.)
Update .vscode/settings.json for editor integration
Enable strictNullChecks in tsconfig.json (if TypeScript)

Non-Interactive Setup (CI/Automation)

# Auto-detect settings, skip prompts
bunx ultracite init --quiet

# Specify options explicitly (v7+)
bunx ultracite init \
  --linter biome \
  --pm bun \
  --frameworks react,next \
  --editors vscode \
  --agents cursor,claude \
  --integrations husky \
  --migrate eslint,prettier \
  --quiet

Available flags:

--linter: Provider selection (biome, eslint, oxlint) - v7+ only
--pm: Package manager (bun, npm, pnpm, yarn)
--frameworks: react, next, solid, vue, qwik, angular, remix, svelte
--editors: vscode, zed
--agents: cursor, claude, cline, copilot, windsurf, etc.
--integrations: husky, lefthook, lint-staged
--migrate: eslint, prettier, biome
--quiet: Skip all prompts (auto-enabled when CI=true)

Manual Setup (Advanced)

# 1. Install dependencies
bun add -D ultracite @biomejs/biome

# 2. Create biome.jsonc
cat > biome.jsonc << 'EOF'
{
  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
  "extends": ["ultracite/core"]
}
EOF

# 3. Create VS Code settings
mkdir -p .vscode
cat > .vscode/settings.json << 'EOF'
{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "quickfix.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  }
}
EOF

# 4. Enable TypeScript strict mode
# Add to tsconfig.json:
{
  "compilerOptions": {
    "strictNullChecks": true
  }
}

Verify Installation

# Check installation
bunx ultracite doctor

# Expected output:
# ✔ Biome is installed
# ✔ Configuration file found: biome.jsonc
# ✔ Editor integration configured
# ✔ TypeScript strict mode enabled

Configuration

Basic Configuration

File structure:

project-root/
├── biome.jsonc              # Main configuration
├── .vscode/settings.json    # VS Code integration
├── tsconfig.json            # TypeScript config (strictNullChecks required)
└── package.json

Minimal biome.jsonc:

{
  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
  "extends": ["ultracite/core"],

  // Optional: Add framework preset
  // "extends": ["ultracite/core", "ultracite/react"],

  // Optional: Customize rules
  "linter": {
    "rules": {
      "suspicious": {
        "noConsoleLog": "off"  // Disable specific rule
      }
    }
  },

  // Optional: Exclude files
  "files": {
    "ignore": ["dist", "build", "coverage", "**/*.generated.ts"]
  }
}

Framework Presets

ultracite/react : React Hooks, JSX a11y, component best practices
ultracite/nextjs : React + Next.js App Router, image optimization, document structure
ultracite/vue : Vue 3 Composition API, template syntax, reactivity
ultracite/svelte : Svelte 4/5 syntax, reactive declarations

Usage :

{
  "extends": ["ultracite/core", "ultracite/react"]
}

Core Preset

The ultracite/core preset includes 200+ rules across 7 categories:

Accessibility : ARIA validation, semantic HTML, keyboard navigation
Correctness : Type safety, unused code removal, exhaustive dependencies
Performance : Code optimization, barrel file warnings
Security : Prevents eval(), XSS risks, unsafe patterns
Style : Consistent patterns, const preference, import organization
Suspicious : Catches loose equality, debugger statements, typos
Complexity : Cognitive complexity limits

Formatting defaults : 2 spaces, 80 chars/line, LF endings, single quotes

For detailed framework presets, rule descriptions, and advanced configuration, see : references/configuration-guide.md

Usage

IDE Integration (Recommended)

VS Code Setup:

Install Biome extension: biomejs.biome
Verify .vscode/settings.json:

{ "editor.defaultFormatter": "biomejs.biome", "editor.formatOnSave": true, "editor.codeActionsOnSave": { "quickfix.biome": "explicit", "source.organizeImports.biome": "explicit" } }
Disable conflicting extensions (ESLint, Prettier)

Features:

Auto-format on save
Auto-fix on save (removes unused imports, fixes order, applies strict equality)
Format on paste
Problems panel for unfixable issues
Quick fixes via lightbulb indicators

CLI Usage

Check code (lint only) :

bunx ultracite check
bunx ultracite check src/
bunx ultracite check --diagnostic-level error  # Only errors

Fix code (auto-fix) :

bunx ultracite check --write
bunx ultracite check --write src/

Format code (format only) :

bunx ultracite format --write
bunx ultracite format --write src/

Package.json scripts :

{
  "scripts": {
    "lint": "ultracite check",
    "lint:fix": "ultracite check --write",
    "format": "ultracite format --write"
  }
}

Git Hook Integrations

Ultracite auto-detects and integrates with:

Husky : Node.js-based hook manager
Lefthook : Fast Go-based hook manager
lint-staged : Runs linters on staged files only

Quick setup :

# Husky
bunx ultracite init --integrations husky

# Lefthook
bunx ultracite init --integrations lefthook

# lint-staged
bunx ultracite init --integrations lint-staged

Example.husky/pre-commit:

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

ultracite check --staged --write

For complete Git hook setup guides (Husky, Lefthook, lint-staged), see : references/git-hooks-setup.md

AI Editor Rules

Ultracite generates AI editor rules that teach AI assistants about your linting/formatting standards.

Supported editors:

Cursor (.cursorrules)
Claude Code (.windsurfrules)
GitHub Copilot (.github/copilot-instructions.md)
Continue.dev (.continuerules)
Codeium (.codeiumrules)
Zed (.zedrules)

Generate rules :

bunx ultracite generate-ai-rules
bunx ultracite generate-ai-rules --all  # All editors
bunx ultracite generate-ai-rules --editor=cursor  # Specific editor

For complete AI editor integration guide and customization, see : references/ai-editor-integration.md

Monorepo Support

Ultracite optimizes for monorepos with:

Shared base configurations
Package-specific overrides
Turborepo/Nx caching integration
Performance optimization for large workspaces

Example monorepo structure :

monorepo/
├── biome.json              # Shared base config
├── apps/
│   └── web/
│       └── biome.json      # Next.js-specific overrides
└── packages/
    └── ui/
        └── biome.json      # React-specific overrides

For complete monorepo setup, Turborepo/Nx integration, and performance tips, see : references/monorepo-configuration.md

Migration from ESLint/Prettier/Biome

Automatic migration :

bunx ultracite migrate eslint
bunx ultracite migrate prettier
bunx ultracite migrate biome

Manual migration:

Analyze current configuration
Map rules to Biome equivalents
Create biome.json with equivalent rules
Update package.json scripts
Remove old dependencies
Test thoroughly

For complete migration guides with detailed rule mappings, see : references/migration-guides.md

Known Limitations

CSS/SCSS : Biome does not lint CSS. Workaround: Use Stylelint Framework gaps : Limited Angular/Astro support. Workaround: Use ultracite/core + manual rules ESLint plugins : Many ESLint plugins have no Biome equivalent. Workaround: Run ESLint alongside Ultracite for specific plugins File types : No Markdown, YAML, HTML linting. Workaround: Use dedicated tools (markdownlint, yamllint, htmlhint)

For complete list of limitations and detailed workarounds, see : references/limitations-and-workarounds.md

Troubleshooting

Common issues:

VS Code not formatting on save → Install Biome extension, configure settings
ESLint conflicts → Disable ESLint or run selectively
Parse errors → Configure JSX support in biome.json
Pre-commit hooks failing → Use bunx instead of global install
CI failures → Pin Bun/Node versions, increase memory limit

For complete troubleshooting guide, see : references/troubleshooting.md

Templates & Scripts

Initial Setup Script

See scripts/install-ultracite.sh for automated setup.

Migration Script

See scripts/migrate-to-ultracite.sh for ESLint/Prettier migration.

Example Configurations

See references/ directory for:

configuration-guide.md: Framework presets and rule details
git-hooks-setup.md: Husky, Lefthook, lint-staged setup
ai-editor-integration.md: Cursor, Claude Code, Copilot rules
monorepo-configuration.md: Turborepo, Nx, pnpm workspaces
migration-guides.md: ESLint, Prettier, Biome migration
troubleshooting.md: Common issues and solutions
limitations-and-workarounds.md: Known gaps and fixes

Package Versions

Current versions (verified 2025-11-27):

ultracite: latest
@biomejs/biome: >=1.9.0

Check for updates:

npm view ultracite version
npm view @biomejs/biome version

Update:

bun update ultracite @biomejs/biome

Resources

Official Documentation:

Examples:

https://www.ultracite.ai/examples

Troubleshooting:

Community:

GitHub Issues: https://github.com/ultracite/ultracite
Biome Discord: https://discord.gg/biome

When to Load References

Load reference files on-demand based on user questions or task requirements:

references/provider-biome.md : When user asks about:

Biome provider specifics
Biome-only configuration
Biome performance optimization
Biome preset paths (v7: ultracite/biome/*)
Biome rule customization

references/provider-eslint.md : When user asks about:

ESLint provider setup
ESLint + Prettier + Stylelint integration
ESLint plugin configuration
ESLint migration to Ultracite
Advanced CSS/SCSS linting

references/provider-oxlint.md : When user asks about:

Oxlint provider setup
Type-aware linting features
Oxlint performance benefits
Oxlint vs Biome comparison
TypeScript integration

references/v6-migration.md : When user asks about:

Upgrading from v5 to v6
Framework preset introduction
v6 configuration changes
v6 breaking changes

references/v7-migration.md : When user asks about:

Upgrading from v6 to v7
Preset path migration (ultracite/core → ultracite/biome/core)
Multi-provider setup
v7 breaking changes
ultracite doctor command

references/mcp-integration.md : When user asks about:

MCP server setup
AI assistant integration via MCP
Model Context Protocol
MCP server configuration

references/ai-hooks.md : When user asks about:

AI hooks setup (distinct from AI rules)
Auto-format after AI edits
Editor hook configuration
Post-edit formatting automation

references/configuration-guide.md : When user asks about:

Framework presets (React, Next.js, Vue, Svelte)
Core preset rules (200+ rules breakdown)
Rule customization methods
File exclusion patterns
Advanced configuration

references/git-hooks-setup.md : When user asks about:

Pre-commit hooks
Husky integration
Lefthook integration
lint-staged setup
CI/CD integration
Hook troubleshooting

references/ai-editor-integration.md : When user asks about:

AI editor rules generation
Cursor integration
Claude Code integration
GitHub Copilot setup
Custom AI rules
Editor-specific setup

references/monorepo-configuration.md : When user asks about:

Monorepo setup
Turborepo integration
Nx integration
Package-specific overrides
Workspace configuration
Performance optimization

references/migration-guides.md : When user asks about:

ESLint migration
Prettier migration
Biome migration
Rule mapping
Migration checklist
Post-migration steps

references/troubleshooting.md : When user asks about:

VS Code issues
ESLint/Prettier conflicts
Parse errors
Pre-commit hook failures
CI failures
TypeScript strictness errors
Installation issues
Performance problems

references/limitations-and-workarounds.md : When user asks about:

CSS linting
Framework support gaps
ESLint plugin ecosystem
File type support
Editor integration
Migration limitations

Summary

Ultracite provides a unified linting and formatting solution with multi-provider support:

✅ Use when:

Starting new projects
Building with React/Next/Vue/Svelte
Working in monorepos
Want consistent formatting without configuration
Performance matters (Biome/Oxlint providers)
Need ESLint compatibility (ESLint provider)
Using AI coding assistants
Require type-aware linting (Oxlint)

⚠️ Consider alternatives when:

Need specific ESLint plugins not supported by any provider
Advanced CSS linting required (though ESLint provider includes Stylelint)
Legacy framework support needed

Key advantages:

Multi-provider : Choose Biome (fastest), ESLint (most compatible), or Oxlint (type-aware)
Version 7 : Preset path migration, MCP server, AI hooks, multi-provider architecture
Version 6 : Framework-specific presets (React, Next.js, Vue, Svelte, etc.)
10-100x faster than traditional ESLint + Prettier (Biome/Oxlint)
Zero configuration (200+ rules preconfigured for Biome)
Framework-specific presets
AI editor integration + AI hooks
Git hook support
TypeScript strict mode enforced

Installation:

bun x ultracite init --linter biome   # Default (v7+)
bun x ultracite init --linter eslint  # ESLint provider (v7+)
bun x ultracite init --linter oxlint  # Oxlint provider (v7+)

Most common workflow:

Install with bun x ultracite init
Select framework preset (React, Next.js, etc.)
Choose Git hook integration (Husky, Lefthook, lint-staged)
Enable AI editor rules (Cursor, Claude Code, Copilot)
Optionally migrate from ESLint/Prettier
Code with auto-formatting on save
Commit with pre-commit hooks ensuring quality

Remember:

Always check for existing Git hook managers before installing
Assess project suitability (scan for ESLint/Prettier/frameworks)
Recommend or warn based on project characteristics
Enable strictNullChecks in TypeScript projects
Use framework-specific presets for best results
Load reference files on-demand based on user questions

Weekly Installs

Repository

secondsky/claude-skills

GitHub Stars

First Seen

Jan 25, 2026

Security Audits

Gen Agent Trust HubWarn SocketPass SnykPass

Installed on

gemini-cli73

claude-code72

codex72

opencode72

github-copilot69

amp65

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

120,000 周安装

Ultracite：现代JS/TS项目零配置代码检查与格式化工具，比ESLint快100倍

🇨🇳中文介绍

Ultracite Skill

概述

核心目标

与替代方案相比的主要优势

相关 Skills

何时使用此技能

✅ 理想项目

⚠️ 考虑替代方案的情况

交互式组件

命令

代理

选择提供程序

🚀 Biome（默认）- 推荐用于大多数项目

🔧 ESLint + Prettier + Stylelint - 推荐用于最大兼容性

⚡ Oxlint + Oxfmt - 推荐用于最大速度

版本迁移指南

从 v6 升级到 v7

从 v5 升级到 v6

项目适用性评估

检查 ESLint

安装与设置

先决条件

快速开始（交互式）

非交互式设置（CI/自动化）

手动设置（高级）

验证安装

配置

基础配置

框架预设

核心预设

使用

IDE 集成（推荐）

CLI 使用

Git 钩子集成

AI 编辑器规则

Monorepo 支持

从 ESLint/Prettier/Biome 迁移

已知限制

故障排除

模板与脚本

初始设置脚本

迁移脚本

示例配置

包版本

资源

何时加载参考文档

总结

🇺🇸English

Ultracite Skill

Overview

Core Goals

Key Benefits vs Alternatives

When to Use This Skill

✅ Ideal Projects

⚠️ Consider Alternatives When

Interactive Components

Commands

Agents

Choosing a Provider

🚀 Biome (Default) - Recommended for most projects

🔧 ESLint + Prettier + Stylelint - Recommended for maximum compatibility

⚡ Oxlint + Oxfmt - Recommended for maximum speed

Version Migration Guide

Upgrading from v6 to v7

Upgrading from v5 to v6

Project Suitability Assessment

Check for ESLint

Installation & Setup

Prerequisites

Quick Start (Interactive)

Non-Interactive Setup (CI/Automation)

Manual Setup (Advanced)

Verify Installation

Configuration

Basic Configuration

Framework Presets

Core Preset

Usage