superdoc-redlines

# SuperDoc Redlines Skill > **Full Reference:** See [README.md](./README.md) for complete API documentation, module API, and migration notes. ## Overview This tool allows AI agents to programmatically edit Word documents with: - **Tracked changes** (insertions/deletions visible in Word's review mode) - **Comments** (annotations attached to document blocks) Uses **ID-based editing** for deterministic, position-independent edits. --- ## Quick Workflow ### Step 1: Extract Document Structure ```bash node superdoc-redline.mjs extract --input contract.docx --output contract-ir.json ``` This produces `contract-ir.json` with block IDs like `b001`, `b002`, etc. ### Step 2: Read Document (for analysis) ```bash # Read entire document (or first chunk if large) node superdoc-redline.mjs read --input contract.docx # Read specific chunk for large documents node superdoc-redline.mjs read --input contract.docx --chunk 1 # Get document stats only node superdoc-redline.mjs read --input contract.docx --stats-only ``` Output is JSON to stdout - parse it to understand document structure. ### Step 3: Create Edits File Create `edits.json` referencing block IDs from the IR: ```json { "version": "0.2.0", "edits": [ { "blockId": "b025", "operation": "replace", "newText": "This Agreement shall be governed by Singapore law.", "comment": "Changed from English law per deal requirements" }, { "blockId": "b089", "operation": "delete", ...