document SKILL.md skillA

document from moonray/repoprompt-workflows is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add moonray/repoprompt-workflows/document@git:20260822.91c6099

Pins git:20260822.91c6099 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
moonray/repoprompt-workflows
Path
.agents/skills/document/SKILL.md
Versions recorded
2
Latest version
git:20260822.91c6099, committed Aug 22, 2026
First version recorded
Jul 10, 2026
Size
21,184 bytes
Repository stars
11
License
MIT

Use when reconciling documentation to code changes or auditing documentation drift in a repo. Applies whenever the user asks to update docs after code changes, check whether docs match code, run a documentation audit, or produce doc drift reports; also reviews accumulated work against the repo's mission/intent anchor for alignment; defaults to dry-run proposals and requires explicit apply before writing.

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

## Purpose

Keep documentation aligned with code without inventing facts or silently rewriting contracts, and keep accumulated work aligned with the repo's stated intent without ever landing an intent-anchor change.

Use this skill in two modes:

- **code**: reconcile docs ⇄ code truth, from two composable entry points — change-driven reconciliation (default: the working-tree diff) and a corpus drift scan.
- **intent**: review a bounded window of the work record against the repo's intent anchor and remediate the findings.

Documentation follows code. Do not modify code to match docs, create changelogs, bump versions, author brand-new documentation with no code or work basis, or perform git operations (commit, push, merge, PR) — remediation produces edits, drafts, and ledger items; the user lands them. Never land an intent-anchor edit, under any grant. `intent` mode does not re-check code facts — that is `code` mode's job; intent verdicts cite the work record and doc lines, not code internals. There is no combined code+intent mode and no overall repo health score — a bundle is a call-site invoking both modes, not a mode. No skill eval/benchmark machinery; steering…
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add moonray/repoprompt-workflows/document@sha256:47d52fab0def53b7

The line at the top of this page pins the label git:20260822.91c6099, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jxbft3ukaj3t6se4.svg)](https://markdownregistry.com/a/art_jxbft3ukaj3t6se4)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jul 10, 2026 and Aug 22, 2026, about one every 42 days.

versioncommittedcommitsizeaudit
git:20260822.91c6099 latest2026-08-22 91c6099 21,184 BA view · diff
git:20260710.161b2ae2026-07-10 161b2ae 6,420 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (21184 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

GitHub

moonray/repoprompt-workflows · 11 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jxbft3ukaj3t6se4
GET https://markdownregistry.com/api/v1/resolve?ref=moonray/repoprompt-workflows/document
GET https://markdownregistry.com/api/v1/blob/47d52fab0def53b7718105f8a9fd0256fe9409fdb24a4367c507bb066874a914

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 moonray/repoprompt-workflows

bot-wall SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/bot-wall/SKILL.md · Use whenever an HTTP fetch of an external site is blocked by a bot wall — 403/Access Denied/"Request unsuccessful" on a…
git:20261010.4e23de3 · audit A · 11 stars
chat-mining SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/chat-mining/SKILL.md · Use when asked to mine or analyze past agent session chats/transcripts (e.g. "what can we learn from workspace X's…
git:20261010.9ca2554 · audit A · 11 stars
chrome SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/chrome/SKILL.md · Use whenever driving or visiting a website with browser automation — the chrome-devtools MCP (dev chrometools…
git:20261010.4e23de3 · audit A · 11 stars
live-dryrun SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/live-dryrun/SKILL.md · Use when the user asks for "automated user testing", a "dry run", or "live verification" of a backend/API/provider…
git:20261010.d8782ee · audit A · 11 stars
maintainability-review SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/maintainability-review/SKILL.md · Use for a strict, quality-only structural review that hunts for dramatic simplifications, not local cleanup. Trigger on…
git:20260710.161b2ae · audit A · 11 stars
model-routing SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/model-routing/SKILL.md · Use when choosing an oracle model or effort level for spec, plan, or review consultations (ask_oracle, context_builder…
git:20261011.a5e82c5 · audit A · 11 stars
review-depth SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/review-depth/SKILL.md · Use when deciding how much review effort a change warrants — quick, standard, or deep — picked from the change's size…
git:20260710.161b2ae · audit A · 11 stars
review-quality SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/review-quality/SKILL.md · Use when producing, consuming, triaging, or revalidating code-review findings — review artifacts, P0/P1 findings, fix…
git:20261007.59c4e76 · audit A · 11 stars
rpce-tool-gotchas SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/rpce-tool-gotchas/SKILL.md · RepoPrompt CE workspace-tool boundaries that agents keep re-learning by failure. Use when an RPCE file/edit tool…
git:20261014.15616ea · audit A · 11 stars
spec-conformance SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/spec-conformance/SKILL.md · Use when closing a spec-driven feature/issue or auditing whether an implementation actually matches its spec. Given a…
git:20260710.161b2ae · audit A · 11 stars
spec-plan-readiness SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/spec-plan-readiness/SKILL.md · Use before implementation when a Spec and Deep Plan must be checked for coding readiness. Applies a deterministic…
git:20260710.161b2ae · audit A · 11 stars
spec-quality SKILL.md skill
moonray/repoprompt-workflows · .agents/skills/spec-quality/SKILL.md · Use when drafting, reviewing, repairing, or validating scenario-based specs, product specs, implementation specs…
git:20260710.161b2ae · audit A · 11 stars

Every file in moonray/repoprompt-workflows

Other files named document

document SKILL.md skill
oliver-kriska/claude-elixir-phoenix · plugins/elixir-phoenix/skills/document/SKILL.md · Use when asked to document Elixir code: add or fill in @moduledoc and @doc for modules and functions. Documents tested…
git:20260929.c08ad14 · audit A · 569 stars
document SKILL.md skill
serpro69/claude-toolbox · kodex-plugin/skills/document/SKILL.md · After implementing a new feature or fixing a bug, make sure to document the changes. Use when writing documentation…
git:20260930.85f9f82 · audit A · 151 stars
document SKILL.md skill
serpro69/claude-toolbox · klaude-plugin/skills/document/SKILL.md · After implementing a new feature or fixing a bug, make sure to document the changes. Use when writing documentation…
git:20260930.86c5e44 · audit A · 151 stars
document SKILL.md skill
archcore-ai/archcore · plugins/archcore/skills/document/SKILL.md · Record a decision, document existing code, or file a supplied research material, in free text; no first word is a mode…
git:20261016.6aafe90 · audit A · 71 stars
document SKILL.md skill
archcore-ai/plugin · plugins/archcore/skills/document/SKILL.md · Record a decision, document existing code, or file a supplied research material, in free text; no first word is a mode…
git:20261016.6aafe90 · audit A · 71 stars
document SKILL.md skill
nitinjain999/platform-skills · skills/document/SKILL.md · Generate, format, and validate code documentation — docstrings, JSDoc, OpenAPI/Swagger specs, documentation sites, and…
git:20261011.e8166a5 · audit A · 70 stars
document SKILL.md skill
nitinjain999/platform-skills · plugins/platform-skills/skills/document/SKILL.md · Generate, format, and validate code documentation — docstrings, JSDoc, OpenAPI/Swagger specs, documentation sites, and…
git:20261018.90b97a9 · audit A · 70 stars
document SKILL.md skill
bdsqqq/dots · modules/agents/skills/document/SKILL.md · apply documentation philosophy — explain why, not what. use for jsdocs, READMEs, inline comments.
git:20260825.12ce506 · audit A · 64 stars

Browse by kind, by grade A, or by owner.