sqlfluff/sqlfluff

GitHub
https://github.com/sqlfluff/sqlfluff

A modular SQL linter and auto-formatter with support for multiple dialects and templated code.

  • hacktoberfest
  • pypi
  • sql
  • sql-linter
Stars:
10k
Language:
Python
Default branch:
main
Last scored:
Overall

At a glance

Rank
#26 of 401
Top 6% · #8 of 56 Python repos
Checks passed
11 of 17
Full list below
Best set up for
Claude Code
Score 94.7
Needs most work for
Cursor
Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    Manageable size
    If possible, split into smaller modules or carve out a focused entry path. Document where to start in AGENTS.md.
    +5.3 pts

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Claude Code
#17 of 401
94.7
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Reproducible dev env
Kimi Code CLI
#31 of 401
90.4
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Dependency manifest
Codex
#32 of 401
89.9
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ✓Test suite
Pi
#33 of 401
89.3
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Linter / formatter config
Devin
#28 of 401
86.0
  • ✓Reproducible dev env
  • ✓Dependency manifest
  • ✓Test suite
Aider
#18 of 401
81.4
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ✓Test suite
Gemini CLI
#34 of 401
80.4
  • ✗GEMINI.md
  • ✓README
  • ✓Test suite
OpenHands
#30 of 401
80.4
  • ✓CI configuration
  • ✓Dependency manifest
  • ✓Reproducible dev env
Cursor
#40 of 401
80.2
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration

Does sqlfluff/sqlfluff have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
AGENTS.md (new tab) · 11,495 characters
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
29 of 56 Python repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 11 passed

No .agents/skills/<name>/SKILL.md
Substantive (11,495 characters)
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
15 GitHub Actions workflows
CONTRIBUTING guide· 100% pass
Guide present
No .cursor/rules/*.mdc or .cursorrules
Manifest present
4 env artifacts (Makefile, Dockerfile)
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
Configured in pyproject.toml
No .openhands/setup.sh
Hook framework configured
README· 100% pass
README detailed (9,835 characters)
Manageable size· 20% pass
6232 files — very large
Test suite· 100% pass
Found /test
Type configuration· 100% pass
Configured in pyproject.toml

How sqlfluff/sqlfluff compares

vs leaderboard average
19.1 pts above
Average 66.8
vs Python average
14.9 pts above
Average 71.0
Stars among Python repos
#55 of 56

Missing here, and how many repos have it

  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 20% of Python repos
  • Cursor rules (.cursor/rules) · passed by 4% of leaderboard repos, 7% of Python repos

Passes checks most repos miss

  • Reproducible dev env · only 22% of repos pass it
  • Pre-commit / git hooks · only 29% of repos pass it

One fix for the most agents: Manageable size would raise the score for all 9 agents, by up to 5.7 points.

Similar repos

Same language and host as this repo, closest in overall score.

All Python repos →

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/sqlfluff/sqlfluff
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/sqlfluff/sqlfluff.svg)](https://agentfriendlycode.com/repo/github/sqlfluff/sqlfluff)

Check the score on every pull request

A GitHub Action posts one comment per pull request with how the score changed and why.