ai-audit-docs skillA
ai-audit-docs is agent-read markdown (skill) from arcasilesgroup/ai-engineering: Audits documentation files against actual repo state. Detects dead references (links to nonexistent files/URLs), false claims (doc says feature X exists but the code doesn't), outdated version numbers, and references to commands that don't exist. Input: path to docs dir or specific files (defaults to docs/ README.md AGENTS.md). Output: ranked markdown table of findings with severity and location. Report-only, NO auto-fix. Trigger phrases: "audit docs", "check documentation", "verify docs", "docs.
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
# Audit docs against repo reality
## Lifecycle
Lane: light
Writes: nothing — report-only, never modifies files
Read by: humans (consumed as a findings table)
Dies: on completion
Next: ai-verify (to validate fixes if user acts on findings)
## What it produces
A ranked markdown table of findings. Every finding names the doc file, the line, the
severity, and the broken claim.
| Severity | Meaning |
|----------|---------|
| critical | Doc points users at something that does not exist — they will hit a wall |
| warning | Claim is outdated or inaccurate but the doc is still roughly usable |
| info | Cosmetic: stale version number, unused anchor, minor nit |
## Steps
1. **Determine scope.** If the user gave a path, audit that. Otherwise default to
`README.md`, `AGENTS.md`, and any `docs/` directory at the repo root. Glob for
`**/*.md` under docs if the directory exists. Never audit vendored or generated files
(`node_modules/`, `dist/`, `*.generated.*`).
2. **Read every target doc.** Extract all of these per file:
- **File links:** markdown links pointing at local paths (e.g. `./path`,
`../path`, `path/to/file`). Skip anchors (`#section`) and
…Read the whole file at its exact version.
How to install
mdr add arcasilesgroup/ai-engineering/ai-audit-docs@git:20260923.5ad45c5mdr add arcasilesgroup/ai-engineering/ai-audit-docs@sha256:2753344016c49ffePin 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_q3b3lbto6gzg6a6s)
0 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260923.5ad45c5 latest | 2026-09-23 | 5ad45c5 | 6,445 B | A | view · diff |
| git:20260923.767162b | 2026-09-23 | 767162b | 6,464 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 (6445 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
arcasilesgroup/ai-engineering · 58 stars · license Apache-2.0 · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_q3b3lbto6gzg6a6s GET https://markdownregistry.com/api/v1/resolve?ref=arcasilesgroup/ai-engineering/ai-audit-docs GET https://markdownregistry.com/api/v1/blob/2753344016c49ffe55d2926d24e6d32f3a96fdab67b0ab61be608c86e93475b0
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.