mcpField
B
biome-validator

biome-validator

github.com/shipshitdevTesting & quality38197 installsUpdated 2d ago
Repository

About biome-validator

biome-validator is a skill for setting up and auditing Biome configuration in JavaScript and TypeScript projects. It checks for current configuration patterns, deprecated settings, and CI/CD readiness.

Key features

  1. 01Validate Biome schema and package versions
  2. 02Check linter and assist configuration
  3. 03Review framework domain settings
  4. 04Detect deprecated configuration patterns
  5. 05Guide ESLint migration

Use cases

  1. 01Check a new Biome setup
  2. 02Audit an existing biome.json
  3. 03Review AI-generated Biome configuration
  4. 04Validate Biome before CI/CD

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill biome-validator

After installing, type/biome-validatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

plugin.json
references/
full-guide.md
scripts/
validate.py

Details

From the project README

Biome Validator

When This Activates

  • Setting up linting for a new project
  • Before any code quality work
  • Auditing existing Biome configurations
  • After AI generates biome.json
  • CI/CD pipeline validation

Quick Start

python3 scripts/validate.py --root .
python3 scripts/validate.py --root . --strict

What Gets Checked

CheckGood (2.3+)Bad (legacy)
Schema version"$schema": ".../2.3.12/schema.json".../1.9.0/schema.json or older
Package version"@biomejs/biome": "^2.3.0""^1.9.0" or 2.0-2.2
Linter configlinter.rules.recommended: truemissing or legacy rules shape
Assist actionsassist.actions.source.organizeImportstop-level organizeImports.enabled
Domainslinter.domains.react / .next: "on"no domains configured
Suppression comments// biome-ignore lint/<rule>: reason// eslint-disable, // @ts-ignore

Biome 2.0+ also adds type-aware linting (no TypeScript compiler required) and multi-file lint analysis.

See references/full-guide.md (§ What Gets Checked, § Biome 2.3+ Features, § Recommended Configuration) for full GOOD/BAD config examples and a complete recommended biome.json.

Deprecated Patterns

DeprecatedReplacement (2.3+)
organizeImports.enabledassist.actions.source.organizeImports
Schema < 2.0Schema 2.3.11+
@biomejs/biome < 2.3@biomejs/biome@latest
No domains configUse linter.domains for frameworks

See references/full-guide.md (§ Validation Output) for a sample validation report.

Migration from ESLint

  1. Remove ESLint/Prettier packages, add @biomejs/biome@latest
  2. Generate config: bunx biome init
  3. Port existing rules: bunx biome migrate eslint --write
  4. Update package.json lint/format scripts to call biome
  5. Delete old .eslintrc* / .prettierrc* / .eslintignore / .prettierignore

See references/full-guide.md (§ Migration from ESLint) for the exact commands per step, plus VS Code editor settings and a CI/CD workflow snippet.

Integration

  • linter-formatter-init - Sets up Biome from scratch
  • nextjs-validator - Validates Next.js (enable next domain)
  • bun-validator - Validates Bun workspace

Comments

Markdown supported