document-review SKILL.md skillA
document-review from iliaal/ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add iliaal/ai-skills/document-review@git:20261003.39b82efPins git:20261003.39b82ef in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- iliaal/ai-skills
- Path
skills/document-review/SKILL.md- Versions recorded
- 8
- Latest version
- git:20261003.39b82ef, committed Oct 3, 2026
- First version recorded
- Apr 27, 2026
- Size
- 9,778 bytes
- Repository stars
- 45
- License
- MIT
Structural and accuracy review of documents: gaps, clarity, completeness, organization, and claims checked against the code. Use when a brainstorm, plan, spec, ADR, or any doc needs polish before the next workflow step. For exploring new ideas from scratch, use brainstorming instead.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Document Review Improve brainstorm or plan documents through structured review. ## Working rules - Assess before editing, preserve implementation-relevant constraints and rationale, and distinguish minor edits from substantive decisions. - A review-only request authorizes findings, not file edits. Apply changes only when the user has requested editing or approved the proposed changes; do not ask again for changes already authorized. ## Step 1: Get the Document **If a document path is provided:** Read it, then proceed to Step 2. **If no document is specified:** Ask which document to review (via `AskUserQuestion` in Claude Code, `request_user_input` in Codex, or numbered options in chat as the fallback), or look for the most recent brainstorm/plan in `docs/brainstorms/` or `docs/plans/`. ## Step 2: Assess Read through the document and ask: - What is unclear? - What is unnecessary? - What decision is being avoided? - What assumptions are unstated? - Where could scope accidentally expand? - Is this technically feasible with the current architecture? …
Read the whole file at its exact version.
How to install
mdr add iliaal/ai-skills/document-review@sha256:f46cf7008179fad2The line at the top of this page pins the label git:20261003.39b82ef, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_tkdsr6u7z3ca4abj)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Apr 27, 2026 and Oct 3, 2026, about one every 23 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261003.39b82ef latest | 2026-10-03 | 39b82ef | 9,778 B | A | view · diff |
| git:20260926.7b0520a | 2026-09-26 | 7b0520a | 9,641 B | A | view · diff |
| git:20260918.0754cc3 | 2026-09-18 | 0754cc3 | 9,036 B | A | view · diff |
| git:20260908.6c9fed1 | 2026-09-08 | 6c9fed1 | 8,828 B | A | view · diff |
| git:20260810.eee1e9c | 2026-08-10 | eee1e9c | 9,881 B | A | view · diff |
| git:20260727.3ddf2a2 | 2026-07-27 | 3ddf2a2 | 9,457 B | A | view · diff |
| git:20260707.d9619d9 | 2026-07-07 | d9619d9 | 6,895 B | A | view · diff |
| git:20260427.b5b60f0 | 2026-04-27 | b5b60f0 | 6,948 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 (9778 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
iliaal/ai-skills · 45 stars · license MIT · pushed 2026-10-31 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_tkdsr6u7z3ca4abj GET https://markdownregistry.com/api/v1/resolve?ref=iliaal/ai-skills/document-review GET https://markdownregistry.com/api/v1/blob/f46cf7008179fad211e864004503813bab19b1efa1b9d6dadb5bfb4b2b401904
Your AI assistant 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.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from iliaal/ai-skills
Every file in iliaal/ai-skills