doc-writer SKILL.md skillA

doc-writer from crewrig/crewrig is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add crewrig/crewrig/doc-writer@git:20260615.ac89ffc

Pins git:20260615.ac89ffc in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

crewrig/crewrig

Path

.claude/skills/doc-writer/SKILL.md

Versions recorded

3

Latest version

git:20260615.ac89ffc, committed Jun 15, 2026

First version recorded

May 14, 2026

Size

4,899 bytes

Repository stars

24

License

Apache-2.0

Documentation skill for ADRs, READMEs, in-code docstrings, and reference material. Activate when the user asks for documentation, when a public contract changes without docs, or when an ADR is needed per the architect skill's output. Optimized for documents that age well.

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

# Documentation Writer

A skill for writing documentation that survives the first refactor.
Bias toward documents the next reader will actually read.

## When to activate

- The user asks for a README, ADR, architecture doc, or in-code
  reference.
- A change shifts a public contract (CLI flags, API surface, config
  schema) and the existing docs no longer match.
- The architect skill produced a recommendation that warrants an ADR.
- A new module or component lacks a top-of-file docstring.

Do not activate for:

- Trailing summaries of "what I just did" — those belong in the PR
  body, not in standalone docs.
- Inline comments about *what* the code does — code already does that.
- Documentation that nobody asked for, just to look thorough.

## Operating mode

### 1. Identify the reader

Documents written for an unspecified reader become unread. Before
writing, name the reader concretely:

- **Future maintainer** — knows the codebase, needs the *why* and the
  invariants. Short, dense.
- **Onboarding contributor** — new to the codebase, needs the *what*
  and the *how to run it*. Longer, with examples.
- **External integrator** — does not have repo access, needs only the
…

Read the whole file at its exact version.

How to install

mdr add crewrig/crewrig/doc-writer@sha256:48c4f71da6d5d661

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

Versions

The registry has recorded 3 versions of this file, between May 14, 2026 and Jun 15, 2026, about one every 16 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_pqbwwqedtpg2ojco
GET https://markdownregistry.com/api/v1/resolve?ref=crewrig/crewrig/doc-writer
GET https://markdownregistry.com/api/v1/blob/48c4f71da6d5d6610ad0c3f4c9b9e31ed3825ef89727c383e26ac88672161a27

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 crewrig/crewrig

Every file in crewrig/crewrig

Other files named doc-writer

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