Where should I store my custom GritQL rules?

It is best practice to store all .grit rule files in a dedicated 'rules/' directory at the root of your project and reference them in your biome.json plugins array.

How does this skill help Claude maintain code quality?

By creating persistent linter rules, Claude can receive immediate feedback when it violates a project pattern, allowing it to self-correct without relying on instructions that might get lost in a long conversation context.

What is Biome GritQL?

GritQL is a powerful query language used by the Biome linter to perform Abstract Syntax Tree (AST) pattern matching, allowing for complex and precise code transformations and linting rules.

Can I use this skill for CSS files?

Yes, GritQL supports multiple languages including CSS, enabling you to enforce utility class patterns or ban specific explicit property values.

What is the difference between AST-based linting and regex?

AST-based linting understands the actual structure and logic of the code (like variables and scopes), whereas regex only sees text, making AST rules much more reliable and less prone to false positives.

Biome GritQL Lint Rules

Name: Biome GritQL Lint Rules
Author: SomtoUgeh

bySomtoUgeh

0•

Developer Tools

Configures and manages custom Biome lint rules using GritQL to enforce codebase standards and prevent anti-patterns via AST-based matching.

This skill empowers developers to implement advanced, AST-based linting rules using Biome's GritQL plugin system directly within Claude Code. It helps automate code quality by capturing specific patterns—such as banning console logs, enforcing specific React hook usage, or managing CSS patterns—and providing immediate, actionable diagnostic feedback. By codifying architectural decisions into the linter, it ensures that both human developers and AI assistants adhere to project-specific conventions, effectively preventing the context drift often seen with standard text-based instructions in long-running sessions.

Key Features

01Create AST-based custom lint rules using expressive GritQL syntax

02Support for multi-language linting including JavaScript, TypeScript, React, and CSS

03Enforce project-specific coding patterns and prevent common anti-patterns

04Provide actionable diagnostic messages with configurable severity levels (error, warn, info)

05Integrate custom rules seamlessly into Biome's plugin architecture

060 GitHub stars

Use Cases

01Automating code reviews by codifying common feedback into persistent, self-correcting lint rules

02Banning specific function calls or hooks like console.log or useEffect in favor of preferred alternatives

03Enforcing architectural patterns such as requiring Jotai atoms over standard useState for shared state

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add somtougeh/somto-dev-toolkit biome-gritql

For use in Claude.ai and ChatGPT

Download Skill