Agent Friendly Code
← back to leaderboard

microsoft/AIGitHub

https://github.com/microsoft/AI
Stars:
2.8k
Language:
Python
Default branch:
master
Last scored:
15h ago
Overall

At a glance

Rank
#368 of 371
#56 of 57 Python repos
Checks passed
3 of 16
Full list below
Best set up for
Devin
Score 26.5
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

  1. 1
    GEMINI.md
    Add a GEMINI.md at the repo root covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
    +11.4 pts
  2. 2
    Test suite
    Add a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.
    +10.2 pts
  3. 3
    Type configuration
    Add a type config (tsconfig.json for JS/TS, mypy.ini or pyrightconfig.json for Python). Rust/Go/JVM/Scala/Swift/C#/OCaml/Haskell/Zig are typed by default.
    +10.2 pts

Score for each AI agent

Each agent looks for different things in a repo, based on its own docs. Under each score are the three checks it cares about most.

Devin
26.5
GPT-5 Codex
26.0
OpenHands
25.3
Kimi CLI
24.8
Claude Code
24.3
Cursor
23.6
Gemini CLI
23.3
Pi
23.2
Aider
20.6

Similar repos

Scored for Gemini CLI. Same language and host as this repo, scoring near it.

All Python repos →

All checks

AGENTS.md / CLAUDE.md· 0% pass
No agent instructions file found
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 0% pass
No CI config found
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 0% pass
No dependency manifest found
Reproducible dev env· 0% pass
No Makefile / devcontainer / Docker / equivalent found
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 0% pass
No linter/formatter config found
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (12587 chars)
README.md
Manageable size· 90% pass
9 files — very small
Test suite· 0% pass
No test directory or test files found
Type configuration· 0% pass
No type config found

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/microsoft/AI
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/microsoft/AI.svg)](https://agentfriendlycode.com/repo/github/microsoft/AI)

Check the score on every pull request

Add this file to your repo. On each pull request, it posts one comment showing how the score changed and why. It runs in your own CI, with no outside server involved.

# .github/workflows/agent-friendly.yml
name: Agent-friendly score diff

on:
  pull_request:
    branches: [master]

permissions:
  contents: read
  pull-requests: write

jobs:
  score-diff:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - uses: hsnice16/agent-friendly-action@v0
        with:
          agents-badge-token: ${{ secrets.AGENTS_BADGE_TOKEN }}

Add AGENTS_BADGE_TOKENto the repo's secrets to turn the comment on. Without it, the action does nothing. Where do I add it?