How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/mroxso/artcraft-skills --skill wordcraftBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
WordCraft
Operate WordCraft through its structured automation interface. Preserve the user's requested document, styles, and editable content.
Protocol reference
Read the relevant sections of references/control-protocol.md before constructing calls. This is the downloaded upstream protocol, captured on 2026-11-15.
Source: WordCraft control protocol. The documentation is distributed under the bundled MIT license. Relative links inside the snapshot (e.g. mcp.md, recovery.md) resolve against https://github.com/storytold/wordcraft/blob/main/docs/. Discover command ids and parameter docs through engine.commands instead of inventing them.
Select the session and authenticate
Start the app with a control port: wordcraft --control 7981 (or WORDCRAFT_CONTROL_PORT=7981); it listens on 127.0.0.1 only. Every request needs the window's key: a random hex value the app writes to <settings>/control-key.local-<port> (macOS ~/Library/Application Support/WordCraft, Linux $XDG_CONFIG_HOME/wordcraft, Windows %APPDATA%\WordCraft; WORDCRAFT_PROFILE_DIR isolates the profile). Send it as top-level "key" on every request, or once per connection with {"method": "auth", "key": "…"}. A missing or wrong key answers unauthorized and closes the connection; an unauthenticated connection is dropped after 30 s. wordcraft-cli mcp --connect reads the key itself (or WORDCRAFT_CONTROL_KEY) and only sends it to 127.0.0.1; to drive a remote app, forward the port and set the key explicitly. Discover executables and running sessions first; this skill does not install WordCraft or configure MCP servers.
Transport
Send one JSON object per line; each gets one reply line, matched by id; check ok. A failed command leaves the document unchanged. A non-JSON line gets one error reply and closes the connection; lines over 1 MiB are refused the same way. Any method name that is a command id works directly ({"method": "format.bold"}).
Documents and targeting
Several documents can be open, each with a stable id. ui.inspect reports document and documents (id, title, path, dirty, active). file.new and file.open open a document in its own window and make it active (file.open on an already-open file returns alreadyOpen: true); view.switchWindows {id} activates one, or {window: key} selects a specific window directly (for Side by Side an id from ui.inspect → windows.others, for Switch Windows an open window's key); file.closeDocument {id?, force?} closes one. engine.execute, document.inspect, and ui.render take doc to work on a background document without changing the active window; window and input methods act on the active window only. file.close never shows a Save prompt: with unsaved changes it errors — save first or pass {"force": true} deliberately.
Inspect, edit, and verify
Inspect before editing: document.inspect {text?, doc?} for blocks, styles, runs, lists, tables, parts, sections, selection, and pages; engine.commands for the catalog with enablement. Edit through engine.execute {command, params} — text.insert, format.*, para.*, styles.modify, table and comment commands. Positions are {"story": "body" | {"part": n}, "path": [block, row, cell, …], "off": byteOffset}; CharProps/ParaProps shapes are documented in upstream mcp.md. UI commands such as ui.dialog, ui.backstage, ui.theme, ui.language, and ui.fileBrowser drive chrome; dialogs and protection still apply to input.
Input methods (ui.click, ui.clickText with 0-based page and page-point coordinates, ui.press/ui.release, ui.wheel, ui.key, ui.text) go to the active window's focused widget and reply {"queued": true} when queued, not when applied — inspect the resulting state before dependent edits and never replay an edit just because its effect was not immediate.
Verify with ui.render {page?, scale?, doc?} (engine-rendered page PNG, no window needed) or ui.screenshot (window state, dialogs, balloons; with several document windows open it captures only the root-viewport window and errors on a secondary one, naming the root window key — select it with view.switchWindows {"window": root} and retry). Report saved and exported paths and material warnings.
Printing and export
Native printing: ui.printSettings inspects and configures the printer (refresh starts discovery; set printer, copies, duplex, grayscale), and ui.printSubmit submits the print-ready PDF without a dialog, accepting range, pages, parity, copies, collate, paper (Scale to Paper Size; the document's page size is unchanged), and pagesPerSheet (1/2/4/6/9/16-up or "booklet" / "bookletReverse" sheet layouts). Poll ui.printSettings until busy is false and check status/detail. file.printPdf exports PDF; invalid ranges submit no job.