openwriter 0.6.11 → 0.7.0

package/skill/SKILL.md

@@ -16,7 +16,7 @@ description: |
   Requires: OpenWriter MCP server configured. Browser UI at localhost:5050.
 metadata:
   author: travsteward
-  version: "0.2.7"
+  version: "0.2.8"
   repository: https://github.com/travsteward/openwriter
 license: MIT
 ---
@@ -96,6 +96,8 @@ Every document has an immutable **docId** (8-char hex, e.g. `a1b2c3d4`) in its Y
 - Two documents can have the same title — the docId disambiguates
 - Filenames contain UUIDs unrelated to docIds — the first segment of a filename UUID looks like a docId but is not
 
+**MCP params:** `metadata`, `changes`, `content` are objects — never stringify them.
+
 ## MCP Tools Reference (36 core + 21 publish platform)
 
 ### Document Operations
@@ -147,7 +149,7 @@ Every document has an immutable **docId** (8-char hex, e.g. `a1b2c3d4`) in its Y
 | `delete_container` | Delete a container from a workspace (doc files stay on disk) |
 | `tag_doc` | Add a tag to a document by docId (stored in doc frontmatter) |
 | `untag_doc` | Remove a tag from a document by docId |
-| `move_doc` | Add a doc to a workspace, or move it within the workspace (by docId) |
+| `move_item` | Move or reorder a doc, container, or workspace (type: doc/container/workspace) |
 | `rename_item` | Rename a workspace, container, or document (type: workspace/container/document) |
 
 ### Agent Marks
@@ -228,7 +230,7 @@ create_document({
 - **`container`** (string) — container name within the workspace (e.g. "Chapters", "Notes", "References"). Auto-creates if not found. Requires `workspace`.
 - Both are optional — omit for standalone docs outside any workspace.
 
-This eliminates the need for separate `create_workspace`, `create_container`, and `move_doc` calls when building up a workspace.
+This eliminates the need for separate `create_workspace`, `create_container`, and `move_item` calls when building up a workspace.
 
 ## Workflow
 
@@ -440,6 +442,16 @@ After creating a thread, use `read_pad` to get node IDs, then `insert_image` to
 
 All `insert_image` calls can run **in parallel** — no dependencies between them. Images appear with green pending decorations for user review.
 
+### Inserting Existing Images (from disk)
+
+Copy to `~/.openwriter/profiles/Default/_images/`, then use TipTap JSON in `write_to_pad`:
+
+```
+content: { "type": "image", "attrs": { "src": "/_images/my-image.png", "alt": "..." } }
+```
+
+**Markdown `![alt](path)` does NOT work** — creates an empty paragraph. Always use TipTap JSON.
+
 ## Review Etiquette
 
 1. **Share the URL.** Always tell the user: http://localhost:5050