docs-as-definition-of-done SKILL.md skillA

docs-as-definition-of-done from corvinlabs/corvinos is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add corvinlabs/corvinos/docs-as-definition-of-done@git:20260915.459047e

Pins git:20260915.459047e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
corvinlabs/corvinos
Path
corvin_operator/bundle/skills/ldd/docs-as-definition-of-done/SKILL.md
Versions recorded
1
Latest version
git:20260915.459047e, committed Sep 15, 2026
Size
10,522 bytes
Repository stars
24
License
Apache-2.0

Use when finishing any code change that modifies behavior, public API, CLI flags, config shape, defaults, error messages, or anything a reader-of-the-docs would model — before committing, pushing, or declaring "done." Forbids deferring doc updates to a follow-up commit, ticket, or "cleanup later.".

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-as-Definition-of-Done

## Overview

Docs describe code **exactly, but at the conceptual level**. A reader of the markdown must get a faithful, current mental model of the code without reading the code.

**Core principle:** A code change is **not done** until every documentation statement that the change invalidated has been updated **in the same logical task**. No "I'll fix the docs later." No separate doc-cleanup commits. No stub TODOs.

**Why:** Stale docs are worse than missing docs. They confidently mislead readers — future-you, reviewers, new teammates, AI coding assistants loading them as context — into building on a model that no longer matches reality. Each stale statement silently compounds: every downstream decision made against it is already wrong.

## When to Use

Invoke before you `git commit` / `git push` / say "done" for any change that touches:

- Public API shape (signatures, return types, error types, exceptions raised)
- CLI surface (commands, flags, defaults, exit codes)
- Config shape (YAML / TOML / JSON keys, types, defaults, required/optional)
- Behavior under any documented condition (retries, rate limits, timeouts, fallbacks)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add corvinlabs/corvinos/docs-as-definition-of-done@sha256:4908fcf14ee3022d

The line at the top of this page pins the label git:20260915.459047e, 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_645lgpoiy6okst4y.svg)](https://markdownregistry.com/a/art_645lgpoiy6okst4y)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 15, 2026.

versioncommittedcommitsizeaudit
git:20260915.459047e latest2026-09-15 459047e 10,522 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 (10522 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

corvinlabs/corvinos · 24 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_645lgpoiy6okst4y
GET https://markdownregistry.com/api/v1/resolve?ref=corvinlabs/corvinos/docs-as-definition-of-done
GET https://markdownregistry.com/api/v1/blob/4908fcf14ee3022df0c64481bb32958d324c1a80dab88781e24f9f4e183a77a7

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 corvinlabs/corvinos

CLAUDE.md CLAUDE.md file
corvinlabs/corvinos · CLAUDE.md
git:20261105.74f2594 · audit B · 24 stars
market_analyst SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/dag_complex/src/skills/market_analyst/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
news_analyst SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/dag_simple/src/skills/news_analyst/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
code_reviewer SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/delegation/src/skills/code_reviewer/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
data_analysis SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/data_analysis/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
quality_assessment SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/quality_assessment/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
report_writing SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/report_writing/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
quant_trading SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/mixed/src/skills/quant_trading/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
risk_management SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/mixed/src/skills/risk_management/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
os.delegation_router SKILL.md skill
corvinlabs/corvinos · core/skills/bundled/os_delegation_router_v1.0/SKILL.md · Route tasks to native OS, ACS, or TDE
v1.0.0 · audit A · 24 stars
adr_gate SKILL.md skill
corvinlabs/corvinos · corvin_operator/bundle/skills/ldd/adr_gate/SKILL.md · ADR Gate — evaluates after non-trivial tasks whether an ADR is warranted; creates it in the tenant knowledge base…
git:20261103.0105fa8 · audit A · 24 stars
concept_gate SKILL.md skill
corvinlabs/corvinos · corvin_operator/bundle/skills/ldd/concept_gate/SKILL.md · Concept Gate — evaluates after non-trivial tasks whether a reusable WORKING METHOD (not a decision, not a bug fix) is…
git:20261103.0105fa8 · audit A · 24 stars

Every file in corvinlabs/corvinos

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