skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mroxso/artcraft-skills57 installs

wordcraft

Create and edit documents, text, styles, tables, comments, and print jobs or automate workflows in the WordCraft application using its control protocol, MCP bridge, or headless CLI. Use when the user asks to work in WordCraft.

How do I install this agent skill?

npx skills add https://github.com/mroxso/artcraft-skills --skill wordcraft
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The WordCraft skill allows an AI agent to automate document editing and application control. It requires reading a local session key from the user's configuration folder to authenticate with the application's control port. While this is the intended mechanism for the software's automation interface, it gives the agent access to a local secret. Additionally, the skill's ability to inspect document content and take screenshots creates an attack surface for indirect prompt injection and data exfiltration if the agent is used to process untrusted or highly sensitive documents.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

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.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/mroxso/artcraft-skills/wordcraft">View wordcraft on skillZs</a>