roughdraft-review SKILL.md skillA

roughdraft-review from zby/commonplace is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zby/commonplace/roughdraft-review@git:20260925.7a01057

Pins git:20260925.7a01057 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zby/commonplace
Path
kb/instructions/roughdraft-review/SKILL.md
Versions recorded
4
Latest version
git:20260925.7a01057, committed Sep 25, 2026
First version recorded
Jun 10, 2026
Size
2,270 bytes
Repository stars
92
License
CC-BY-4.0

Open a Markdown file in Roughdraft, wait for the user's CriticMarkup review, then apply or respond to the feedback.

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

# Roughdraft review

Roughdraft is a single-file Markdown viewer/editor for inline review. The user may refer to it as `rd` in natural language; treat `rd` as shorthand, but do not create or modify any shell alias, executable, symlink, or command named `rd`.

When the user asks for a plan, write the plan as a Markdown file on disk before asking them to review it.

## Opening a file for review

```bash
roughdraft open "/absolute/path/to/file.md"
```

Open one `.md` file at a time. If Roughdraft is not running, `roughdraft open` starts it automatically.

**Leave the command running.** Do not interrupt, kill, background, detach, or treat the waiting process as cleanup. The wait is intentional: Roughdraft exits the command after the user clicks Done Reviewing, and that exit is the signal to resume — read the file from disk and respond to any CriticMarkup comments or suggested changes.

## CriticMarkup (Roughdraft-flavored)

Base markers:

- Comment: `{>>comment<<}`
- Insertion: `{++new text++}`
- Deletion: `{--old text--}`
- Substitution: `{~~old~>new~~}`
- Highlight: `{==text==}`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zby/commonplace/roughdraft-review@sha256:90f1f11715feb468

The line at the top of this page pins the label git:20260925.7a01057, 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_j7e3y52uz7e4hpus.svg)](https://markdownregistry.com/a/art_j7e3y52uz7e4hpus)

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

Versions

The registry has recorded 4 versions of this file, between Jun 10, 2026 and Sep 25, 2026, about one every 36 days.

versioncommittedcommitsizeaudit
git:20260925.7a01057 latest2026-09-25 7a01057 2,270 BA view · diff
git:20260925.e6103222026-09-25 e610322 2,261 BA view · diff
git:20260723.c8225362026-07-23 c822536 2,273 BA view · diff
git:20260610.9c49c572026-06-10 9c49c57 2,478 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 (2270 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

zby/commonplace · 92 stars · license CC-BY-4.0 · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j7e3y52uz7e4hpus
GET https://markdownregistry.com/api/v1/resolve?ref=zby/commonplace/roughdraft-review
GET https://markdownregistry.com/api/v1/blob/90f1f11715feb468711068411459bf84062e481b333ba4678dae0273a9590637

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 zby/commonplace

AGENTS.md AGENTS.md file
zby/commonplace · AGENTS.md
git:20261104.a00f07f · audit A · 92 stars
CLAUDE.md CLAUDE.md file
zby/commonplace · CLAUDE.md
git:20260312.4add502 · audit B · 92 stars
analyse-agentic-system SKILL.md skill
zby/commonplace · kb/agentic-system-analyses/instructions/analyse-agentic-system/SKILL.md · Use when asked to analyse, review, or refresh an external agent runtime, orchestration system, agent operating layer…
git:20261023.9c7563b · audit A · 92 stars
synthesize-agent-memory-landscape SKILL.md skill
zby/commonplace · kb/agentic-systems/instructions/synthesize-agent-memory-landscape/SKILL.md · Use when asked to write or refresh a public cross-system synthesis from retained analyse-agentic-system sets and their…
git:20261011.a36b2cb · audit A · 92 stars
cp-skill-add-collection SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-add-collection/SKILL.md · Add one new collection under kb/ with its binding COLLECTION.md, landing README, tag participation and routing, then…
git:20261023.6e80d13 · audit A · 92 stars
cp-skill-connect SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-connect/SKILL.md · Discover connections for a single artifact. Writes a connect-report under kb/reports/cache/connect/<collection>/…
git:20261023.f698aa9 · audit A · 92 stars
cp-skill-convert SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-convert/SKILL.md · Convert notes between types. Currently supports text to note by adding unverified structured frontmatter, renaming the…
git:20261023.f698aa9 · audit A · 92 stars
cp-skill-ground SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-ground/SKILL.md · Ground one source-side claim by retaining minimum verbatim quotes or requiring the pinned snapshot. Use when a note…
git:20260928.765df35 · audit A · 92 stars
cp-skill-health-check SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-health-check/SKILL.md · Diagnose Commonplace installation, skill discovery, command PATH, and workflows blocked by unavailable sub-agents…
git:20261030.c54939d · audit A · 92 stars
cp-skill-ingest SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-ingest/SKILL.md · Use when asked to ingest one URL or local snapshot into a tracked .ingest.md source analysis, or to execute a bounded…
git:20260926.c2c3a63 · audit A · 92 stars
cp-skill-library SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-library/SKILL.md · Find and follow a Commonplace library procedure, instruction, or type by name. Use when the user names a Commonplace…
git:20260925.f54a2e9 · audit A · 92 stars
cp-skill-revise-autoreason SKILL.md skill
zby/commonplace · kb/instructions/cp-skill-revise-autoreason/SKILL.md · Experimentally revise a note with fresh critic, author, synthesizer, and blind-judge agents while retaining the…
git:20261023.f698aa9 · audit A · 92 stars

Every file in zby/commonplace

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