← ClaudeAtlas

roughdraftlisted

Put a Markdown file in front of the user for review in a browser, then read their comments and suggested edits back and reply inside the document. Use when the user wants to review, comment on, or mark up a document, when handing over a plan or draft for feedback, or when they say "open this in roughdraft" or "rd". Covers opening the document, waiting for Done Reviewing without losing the signal, and the CriticMarkup shapes that actually render.
moiri-gamboni/roost · ★ 0 · Data & Documents · score 69
Install: claude install-skill moiri-gamboni/roost
# Roughdraft A local Markdown review app. You open one `.md` file, the user reads it in a browser and leaves comments and suggested changes, clicks **Done Reviewing**, and you read their feedback back out of the same file and reply in it. The Markdown file on disk is the only state — there is no separate review database. The user may call it `rd`. That is shorthand in conversation only: never create a shell alias, executable, symlink, or command named `rd`. When the user asks for a plan, write the plan to disk as Markdown first, then open it. Do not paste a plan into chat and ask for comments. ## Open a document and wait ```bash roughdraft open "/absolute/path/to/file.md" ``` Run this with `run_in_background: true`. The command blocks until the user clicks Done Reviewing, and that exit is your signal to resume — backgrounding it keeps the process alive across turns and re-invokes you when it exits, instead of dying on a tool timeout. **Never interrupt, kill, or "tidy up" the waiting process.** `roughdraft open` starts the server if it is not already running. The server is global and long-lived on port 7373; it does not need starting per document, and there is no systemd unit. What *is* per document is the waiter: each `open` registers one, and if it dies the page stays live and the user's click still queues server-side, but nothing is listening. Re-attach by opening the file again. One file at a time — opening a second document replaces the first in the UI. ## Give t