- name
- editorbridge-document-patch
- description
- Apply safe whole-document edits in GUI editors through EditorBridge snapshots and patch verification.
# EditorBridge Document Patch
Use this skill when the user asks for a document-wide edit in MarkEdit, Textastic, TextEdit, or iA Writer.
Prefer native tools named `editor_*` when available. If native tools are unavailable, use the `editorbridge-mcp` server with the same tool names.
Workflow:
1. Call `editor_check_permissions` when permission status is unknown.
2. Call `editor_snapshot` before proposing or applying a whole-buffer mutation.
3. Use the snapshotted text as the source of truth. Do not infer file identity from a window title when `path` is absent.
4. Prefer `editor_preview_patch` with `unified_diff` or literal patch hunks before mutation.
5. Explain the intended edit briefly when the user has not already approved the exact change.
6. Call `editor_apply_patch` with `snapshot_id` after verifying the patch preview.
7. If a full replacement is unavoidable, call `editor_apply_text` with `snapshot_id`.
8. Read the document again and verify that the expected edit landed.
9. Use `editor_restore_snapshot` if the applied result is wrong and a restore is safe.
Never call `editor_apply_text` without `snapshot_id` unless the user explicitly accepts the no-snapshot risk. Treat stale snapshot errors as a stop condition, then capture a new snapshot and re-plan.
View on GitHub