← all checks

GEMINI.md: the instructions file Gemini CLI reads

GEMINI.md is Gemini CLI's AGENTS.md: project goals, layout, setup commands and conventions, in markdown.

How many repos have a GEMINI.md?

Of the 401 repos on the leaderboard, 6 pass in full (1%), 2 pass in part (0.5%) and 393 fail (98%).

Why does Gemini CLI need a GEMINI.md?

Gemini CLI's docs describe GEMINI.md as layered, from a global file down to one per component, and sent with every prompt. Of the agents we score, Gemini CLI reads it (OpenHands only when it runs a Gemini model), so this check only affects the Gemini CLI score.

What makes a good GEMINI.md?

  • Full pass: GEMINI.md at the repo root with 800 or more characters, counting an AGENTS.md, CLAUDE.md or AGENT.md it imports with a line like @AGENTS.md.
  • 80%: 200 to 799 characters.
  • 50%: under 200 characters.
  • 20%: the file exists but is empty.
  • Fail: no GEMINI.md at the repo root.

How checks become a score: methodology.

How do I add a GEMINI.md to my repo?

Add a GEMINI.md at the repo root with what you would put in AGENTS.md, or a single @AGENTS.md line to reuse that file. We check only the root file, though Gemini CLI also reads them in subdirectories.

Which AI agents read GEMINI.md?

Pass rate by language

GEMINI.md vs AGENTS.md: which to use, and how to keep one source.

Top-scoring repos that pass

Popular repos that fail it

Every check, grouped into what to do first: how to make your repo ready for AI coding agents.