biome-gritql

Enforce custom GritQL lint rules in Biome projects via configuration.

2|3|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/SomtoUgeh/somto-dev-toolkit --skill biome-gritql
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: biome-gritql
Source: https://github.com/SomtoUgeh/somto-dev-toolkit/tree/main/skills/biome-gritql
Command: npx skills add https://github.com/SomtoUgeh/somto-dev-toolkit --skill biome-gritql

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Biome GritQL enables developers to define AST-based lint rules to enforce coding patterns and prevent anti-patterns in Biome-powered projects, helping teams maintain consistent code quality.

Core Features & Use Cases

  • Create and manage custom lint rules using Biome's GritQL plugin system.
  • Enforce coding standards, detect anti-patterns, and prevent risky patterns in codebases.
  • Use cases include blocking unsafe constructs, guiding developers toward best practices, and ensuring style consistency across large repos.

Quick Start

Create a rule file under rules/ and enable it in biome.json to start linting the codebase.

Frequently Asked Questions about biome-gritql

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

FAQPage Schema
How do I create custom lint rules for Biome using GritQL?

Create custom lint rules for Biome by writing GritQL syntax in .grit files within a rules/ directory and linking them through your biome.json configuration to enforce AST-based coding patterns.

What is GritQL used for in static analysis?

GritQL is used in static analysis to define AST-based lint rules that identify and enforce coding patterns, detect anti-patterns, and prevent risky constructs across multiple files and repositories.

How do I configure Biome to apply custom GritQL rules across my project?

Configure Biome to apply custom GritQL rules by setting up a biome.json file that references your GritQL plugins and ensuring your project contains a rules/ directory with the necessary .grit files.

Can I use Biome GritQL rules to enforce coding conventions in large repositories?

Yes, you can use Biome GritQL rules to enforce coding conventions in large repositories by validating AST-based patterns across multiple files to maintain consistent code quality and block unsafe constructs.

Do I need a biome.json file to start linting with GritQL plugins?

Yes, you need a biome.json file to start linting with GritQL plugins, as it must reference the plugins and point to the rules/ directory containing your .grit files for proper AST-based rule enforcement.

What are the limitations of enforcing coding patterns with GritQL?

Enforcing coding patterns with GritQL is limited to Biome-based projects and requires specific directory structures and configuration, meaning it cannot validate rules in environments lacking the necessary biome.json setup.