bundles/workspace/skills/biome-validator/SKILL.md
Validate Biome 2.3+ configuration and detect outdated patterns. Ensures proper schema version, domains, assists, and recommended rules. Use before any linting work or when auditing existing projects.
npx skillsauth add shipshitdev/library biome-validatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
python3 scripts/validate.py --root .
python3 scripts/validate.py --root . --strict
| Check | Good (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 config | linter.rules.recommended: true | missing or legacy rules shape |
| Assist actions | assist.actions.source.organizeImports | top-level organizeImports.enabled |
| Domains | linter.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 | Replacement (2.3+) |
|------------|-------------------|
| organizeImports.enabled | assist.actions.source.organizeImports |
| Schema < 2.0 | Schema 2.3.11+ |
| @biomejs/biome < 2.3 | @biomejs/biome@latest |
| No domains config | Use linter.domains for frameworks |
See references/full-guide.md (§ Validation Output) for a sample validation report.
@biomejs/biome@latestbunx biome initbunx biome migrate eslint --writepackage.json lint/format scripts to call biome.eslintrc* / .prettierrc* / .eslintignore / .prettierignoreSee references/full-guide.md (§ Migration from ESLint) for the exact commands per step, plus VS Code editor settings and a CI/CD workflow snippet.
linter-formatter-init - Sets up Biome from scratchnextjs-validator - Validates Next.js (enable next domain)bun-validator - Validates Bun workspacedevelopment
TypeScript refactoring and modernization guidelines from a principal specialist perspective. This skill should be used when refactoring, reviewing, or modernizing TypeScript code to ensure type safety, compiler performance, and idiomatic patterns. Triggers on tasks involving TypeScript type architecture, narrowing, generics, error handling, or migration to modern TypeScript features.
tools
Resolves TypeScript and JavaScript problems across type-level programming, performance, monorepo management, migration, and modern tooling. Invoke when diagnosing "type instantiation excessively deep" errors, migrating JS to TS, configuring strict tsconfig, debugging module resolution, or choosing between Biome/ESLint/Turborepo/Nx.
tools
Turborepo monorepo build system guidance. Triggers on: `turbo.json`, task pipelines, `dependsOn`, caching, remote cache, the `turbo` CLI, `--filter`, `--affected`, CI optimization, environment variables, internal packages, monorepo structure, and package boundaries. Use when the user configures tasks or workflows, creates packages, sets up a monorepo, shares code between apps, runs changed packages, debugs cache behavior, or works in an `apps/` plus `packages/` workspace.
tools
Provides Tailwind CSS v4 performance optimization and best practices guidelines. Triggers when writing, reviewing, or refactoring Tailwind CSS v4 code; when working with Tailwind configuration, @theme directive, utility classes, responsive design, dark mode, container queries, or CSS generation optimization.