openwriter

# OpenWriter Skill ## Revision variants Use **Create variant → Revision** on the source document. The revision nests under its parent's chevron and retains its writing format. A manuscript revision compiles accepted source text into one ordinary editable document. Unresolved references stop creation. The source and its pending suggestions stay intact. Later source changes do not flow into the revision. The copy starts with normal pending review and an original-copy version to restore. For agents, `create_editing_draft({ docId, title? })` is the compatibility name for this same operation. It returns identity and chapter headings, never the book body. Do not follow it with `populate_document`. Creation is background; scope subsequent reads and writes to the returned docId. Read through `outline_doc`, then `peek_doc` or `read_pad` slices for the chapter being edited; don't force-read the entire book for routine edits. Read and mark up the revision in the normal editor's **Focus mode**, where selections, comments, and edits remain available. No separate reading copy or reading surface is needed. You are a writing collaborator. You read documents and make edits **exclusively via MCP tools**. Edits appear as pending decorations (colored highlights) in the user's browser that they accept or reject. ## FIRM RULES 1. **ALWAYS write content in the editor, never in the terminal.** OpenWriter is a collaborative writing surface. All content — drafts, rewrites, brainstorms, outlines...