Agent Friendly Code

hsnice16/agent-friendly-code

GitHubBadge(this site's own repo)
https://github.com/hsnice16/agent-friendly-code

Scores how ready a repo is for AI coding agents, per agent. Ranked public repos, a live score for any GitHub URL, and the scorer behind the agent skill and GitHub Action.

  • agent-friendly-code
  • agent-readiness
  • agents-md
  • ai
  • ai-code-rank
  • ai-coding-agents
  • bun
  • claude-code
  • cursor
  • dashboard
  • leaderboard
  • nextjs
Stars:
2
Language:
TypeScript
Default branch:
main
Last scored:
Overall

At a glance

Rank
#13 of 401
Top 3% · #2 of 82 TypeScript repos
Checks passed
11 of 17
Full list below
Best set up for
Claude Code
Score 95.3
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
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +4.7 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
#7 of 401
95.3
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ~Reproducible dev env
Pi
#11 of 401
91.5
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Linter / formatter config
Codex
#17 of 401
91.4
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ✓Test suite
Kimi Code CLI
#17 of 401
90.9
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Dependency manifest
Devin
#20 of 401
86.9
  • ~Reproducible dev env
  • ✓Dependency manifest
  • ✓Test suite
Aider
#7 of 401
83.1
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ✓Test suite
OpenHands
#9 of 401
82.0
  • ✓CI configuration
  • ✓Dependency manifest
  • ~Reproducible dev env
Gemini CLI
#21 of 401
81.7
  • ✗GEMINI.md
  • ✓README
  • ✓Test suite
Cursor
#26 of 401
81.6
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration

Does hsnice16/agent-friendly-code 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) · 13,340 characters
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
62 of 82 TypeScript repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 11 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (13,340 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
5 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 13 scripts
package.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Config detected
biome.json
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
lefthook.yml
README· 100% pass
README detailed (5,866 characters)
README.md
Manageable size· 100% pass
393 files
Test suite· 100% pass
Found /tests
tests
Type configuration· 100% pass
Type config present
tsconfig.json

How hsnice16/agent-friendly-code compares

vs leaderboard average
20.4 pts above
Average 66.8
vs TypeScript average
16.0 pts above
Average 71.2
Stars among TypeScript repos
#81 of 82

Missing here, and how many repos have it

  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 30% of TypeScript repos
  • Cursor rules (.cursor/rules) · passed by 4% of leaderboard repos, 13% of TypeScript repos

Passes checks most repos miss

  • Pre-commit / git hooks · only 29% of repos pass it
  • Manageable size · only 16% of repos pass it

One fix for the most agents: Reproducible dev env would raise the score for all 9 agents, by up to 4.8 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/hsnice16/agent-friendly-code
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/hsnice16/agent-friendly-code.svg)](https://agentfriendlycode.com/repo/github/hsnice16/agent-friendly-code)

Check the score on every pull request

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