Agent Friendly Code

vercel/ai

GitHub
https://github.com/vercel/ai

The AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents

Stars:
27.7k
Language:
TypeScript
Default branch:
main
Last scored:
Overall

At a glance

Rank
#202 of 401
Top 50% · #59 of 82 TypeScript repos
Checks passed
8 of 17
Full list below
Best set up for
Kimi Code CLI
Score 73.9
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    Linter / formatter config
    Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
    +7.9 pts
  2. 2
    README
    Expand your README to cover what the project does, how to install, the common commands, and the high-level layout.
    +6.4 pts
  3. 3
    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 →

Kimi Code CLI
#152 of 401
73.9
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Dependency manifest
Codex
#163 of 401
73.7
  • ✓AGENTS.md / CLAUDE.md
  • ~README
  • ~Test suite
Claude Code
#208 of 401
71.7
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ~Reproducible dev env
Devin
#174 of 401
71.0
  • ~Reproducible dev env
  • ✓Dependency manifest
  • ~Test suite
Pi
#180 of 401
70.7
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✗Linter / formatter config
OpenHands
#180 of 401
66.8
  • ✓CI configuration
  • ✓Dependency manifest
  • ~Reproducible dev env
Gemini CLI
#197 of 401
64.3
  • ✗GEMINI.md
  • ~README
  • ~Test suite
Cursor
#213 of 401
62.9
  • ✗Cursor rules (.cursor/rules)
  • ~README
  • ✓Type configuration
Aider
#316 of 401
54.4
  • ✗.aider.conf.yml
  • ✗Linter / formatter config
  • ~Test suite

Does vercel/ai 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) · 16,215 characters
Agent-specific files
.agents/skills (new tab) (12 skills)No GEMINI.md, .cursor/rules, .openhands/setup.sh or .aider.conf.yml
Repos that have one
62 of 82 TypeScript repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 8 passed

Skills (.agents/skills)· 100% pass
12 skills in .agents/skills/
.agents/skills/add-function-examples/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (16,215 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
12 GitHub Actions workflows
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 60% pass
package.json has 30 scripts
package.json
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· 100% pass
Hook framework configured
.husky
README· 30% pass
README thin (0 characters)
README.md
Manageable size· 20% pass
9646 files — very large
Test suite· 70% pass
Test files detected (.github/scripts/notify-released/notify-snapshot.test.mjs)
.github/scripts/notify-released/notify-snapshot.test.mjs
Type configuration· 100% pass
Type config present
tsconfig.json

How vercel/ai compares

vs leaderboard average
0.9 pts above
Average 66.8
vs TypeScript average
3.5 pts below
Average 71.2
Stars among TypeScript repos
#61 of 82

Missing here, and how many repos have it

  • Linter / formatter config · passed by 65% of leaderboard repos, 57% of TypeScript repos
  • Cursor rules (.cursor/rules) · passed by 4% of leaderboard repos, 13% of TypeScript repos

Passes checks most repos miss

  • Skills (.agents/skills) · only 17% of repos pass it
  • Pre-commit / git hooks · only 29% of repos pass it

One fix for the most agents: Linter / formatter config would raise the score for all 9 agents, by up to 14.1 points.

Similar repos

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

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

Check the score on every pull request

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