agent-readiness-report skillA
agent-readiness-report is agent-read markdown (skill) from openhands/extensions: Evaluate how well a codebase supports autonomous AI-assisted development. Analyzes repositories across five pillars (Agent Instructions, Feedback Loops, Workflows & Automation, Policy & Governance, Build & Dev Environment) covering 74 features. Use when users want to assess how agent-ready a repository is..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Agent Readiness Report Evaluate how well a repository supports autonomous AI-assisted development. ## What this does Assess a codebase across five pillars that determine whether an AI agent can work effectively in a repository. The output is a structured report identifying what's present and what's missing. ## Five Pillars | Pillar | Question | Features | |--------|----------|----------| | **Agent Instructions** | Does the agent know what to do? | 18 | | **Feedback Loops** | Does the agent know if it's right? | 16 | | **Workflows & Automation** | Does the process support agent work? | 15 | | **Policy & Governance** | Does the agent know the rules? | 13 | | **Build & Dev Environment** | Can the agent build and run the project? | 12 | 74 features total. See `references/criteria.md` for the full list with descriptions and evidence examples. ## How to run ### Step 1: Run the scanner scripts Five shell scripts gather filesystem signals — file existence, config patterns, directory structures. They surface what's present so you don't have to run dozens of `find` commands manually. ```bash bash scripts/scan_agent_instructions.sh /path/to/repo …
Read the whole file at its exact version.
How to install
mdr add openhands/extensions/agent-readiness-report@git:20260701.599cc4dmdr add openhands/extensions/agent-readiness-report@sha256:e11eafa6fa0be079Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_hlzz2djoowvy5ik6)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260701.599cc4d latest | 2026-07-01 | 599cc4d | 4,477 B | A | view · diff |
| git:20260408.eb2947b | 2026-04-08 | eb2947b | 4,315 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4477 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
openhands/extensions · 150 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_hlzz2djoowvy5ik6 GET https://markdownregistry.com/api/v1/resolve?ref=openhands/extensions/agent-readiness-report GET https://markdownregistry.com/api/v1/blob/e11eafa6fa0be079680bf49d7376dddff7261ec353e35a1a070d8d3c9f10b3b1
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.