docs-cleanup SKILL.md skillA
docs-cleanup from amramos/game-ai-sdlc is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add amramos/game-ai-sdlc/docs-cleanup@git:20261103.160789cPins git:20261103.160789c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- amramos/game-ai-sdlc
- Path
plugins/game-sdlc/skills/docs-cleanup/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261103.160789c, committed Nov 3, 2026
- First version recorded
- Oct 20, 2026
- Size
- 4,407 bytes
- Repository stars
- 3
- License
- MIT
Keep a game project's documents true and short so they guide agents without blocking ideas — after an epic, check the status snapshot, GDD markers, ADRs and agent instructions against the code and the owner's rulings, delete stale text instead of appending beside it, and flag rules that police creative calls rather than protect the repository. Run at the end of every epic (team-lead calls it before its report), or when the user asks to clean, reconcile or tidy the docs.
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
# Docs cleanup Documents written for agents decay in a particular way: they grow, they keep describing things that no longer exist, and old sentences start acting as rules nobody decided. Agents then cite them to narrow or refuse what the owner asks. This skill is the regular sweep that stops that. Two principles decide every edit: - **The owner beats the docs.** A direct instruction from the owner is the approval; a document that says otherwise is out of date, not a reason to resist. - **Mechanism, not taste.** A rule may protect the repository (branch discipline, typing, file formats, data shapes, tests). A rule that decides a creative call — which scenes exist, who speaks, what the player may learn when, what a screen must look like — is a design note at most, and gets flagged. ## 1. Scope it Start from what the epic changed: `git diff <epic base>...HEAD --stat`, the plan and ledger, and the epic's issue comments (owner rulings live there). Clean what that work touched, not the whole repository, unless the owner asks for a full sweep. ## 2. Check each document against the code and the rulings | Document | What to check | What to do | |---|---|---| …
Read the whole file at its exact version.
How to install
mdr add amramos/game-ai-sdlc/docs-cleanup@sha256:6a54d8061c458411The line at the top of this page pins the label git:20261103.160789c, 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_juttmrn5tzvvwo7x)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Oct 20, 2026 and Nov 3, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261103.160789c latest | 2026-11-03 | 160789c | 4,407 B | A | view · diff |
| git:20261103.f0c1ef7 | 2026-11-03 | f0c1ef7 | 4,399 B | A | view · diff |
| git:20261103.bd3ee26 | 2026-11-03 | bd3ee26 | 4,298 B | A | view · diff |
| git:20261031.0486df1 | 2026-10-31 | 0486df1 | 4,054 B | A | view · diff |
| git:20261020.0182e97 | 2026-10-20 | 0182e97 | 3,725 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 (4407 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
amramos/game-ai-sdlc · 3 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_juttmrn5tzvvwo7x GET https://markdownregistry.com/api/v1/resolve?ref=amramos/game-ai-sdlc/docs-cleanup GET https://markdownregistry.com/api/v1/blob/6a54d8061c45841176f1ecf0f44f5134674cc8ec5b687419bf0c7d24569da760
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.