Agent Friendly Code

github/spec-kit

GitHub
https://github.com/github/spec-kit

💫 Toolkit to help you get started with SDD or any other process!

  • ai
  • copilot
  • development
  • engineering
  • prd
  • spec
  • spec-driven
Stars:
142.8k
Language:
Python
Default branch:
main
Last scored:
Overall

At a glance

Rank
#79 of 401
Top 20% · #20 of 57 Python repos
Checks passed
9 of 17
Full list below
Best set up for
Claude Code
Score 87.2
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
    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.
    +7.9 pts
  2. 2
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +3.6 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.
    +1.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
#58 of 401
87.2
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Reproducible dev env
Pi
#75 of 401
82.9
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Linter / formatter config
Kimi Code CLI
#77 of 401
82.8
  • AGENTS.md / CLAUDE.md
  • Test suite
  • Dependency manifest
Codex
#90 of 401
82.2
  • AGENTS.md / CLAUDE.md
  • README
  • Test suite
Devin
#65 of 401
80.7
  • Reproducible dev env
  • Dependency manifest
  • Test suite
OpenHands
#58 of 401
76.6
  • CI configuration
  • Dependency manifest
  • Reproducible dev env
Aider
#68 of 401
75.6
  • .aider.conf.yml
  • Linter / formatter config
  • Test suite
Gemini CLI
#105 of 401
71.6
  • GEMINI.md
  • README
  • Test suite
Cursor
#129 of 401
69.8
  • Cursor rules (.cursor/rules)
  • README
  • Type configuration

Does github/spec-kit 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) · 3,746 characters
Agent-specific files
None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
28 of 57 Python repos · 217 of 401 repos on the leaderboard · See examples →

All 17 checks · 9 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (3,746 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
20 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
pyproject.toml
Reproducible dev env· 70% pass
Has .devcontainer/devcontainer.json
.devcontainer/devcontainer.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Configured in pyproject.toml
pyproject.toml
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
.pre-commit-config.yaml
README· 100% pass
README detailed (13,501 characters)
README.md
Manageable size· 80% pass
926 files
Test suite· 100% pass
Found /tests
tests
Type configuration· 0% pass
No type config found

How github/spec-kit compares

vs leaderboard average
12.0 pts above
Average 66.8
vs Python average
7.9 pts above
Average 70.9
Stars among Python repos
#7 of 57

Missing here, and how many repos have it

  • Type configuration · passed by 68% of leaderboard repos, 58% of Python repos
  • Skills (.agents/skills) · passed by 16% of leaderboard repos, 18% of Python repos
  • Cursor rules (.cursor/rules) · passed by 4% of leaderboard repos, 7% of Python repos

Passes checks most repos miss

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

One fix for the most agents: Type configuration would raise the score for all 9 agents, by up to 11.5 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/github/spec-kit
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/github/spec-kit.svg)](https://agentfriendlycode.com/repo/github/github/spec-kit)

Check the score on every pull request

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