mdedit agent skills
mdedit skills give compatible AI agents a concise, repeatable workflow for working with your durable Markdown documents. The launch catalog contains five focused skills: Save, Find, Revise, Review, and Publish.
Skills are instructions, not credentials or remote operations. A CLI-backed skill tells the agent how to use mdedit-cli; an MCP-backed skill tells it how to use the hosted mdedit MCP tools. A host plugin can bundle the MCP connection and these skills together. See installation and host compatibility for the currently verified channels.
The skills intentionally link to the authoritative document guide, public-link guide, CLI reference, and MCP authentication guide instead of duplicating product reference material.
Save a document
Use Save when the user explicitly asks to save, persist, archive, or turn conversation content into a durable mdedit document.
| Contract | Behavior |
|---|---|
| Example prompt | “Save this conversation as a private Markdown document in mdedit.” |
| Does | Resolves the destination workspace, creates the document once, and verifies the saved result. |
| Does not | Handle generic Markdown writing, local-file creation, or public publishing. |
| Required permissions | workspaces:read, articles:write |
| Success result | The saved title and the exact document identity returned by mdedit. |
| Critical safety | The new document stays private. Saving never implies permission to publish, and identifiers or URLs are never invented. |
Find a document
Use Find when the user asks to locate, open, retrieve, quote, summarize, or inspect a document already stored in mdedit.
| Contract | Behavior |
|---|---|
| Example prompt | “Find my project brief in mdedit and summarize the saved version.” |
| Does | Resolves a workspace, matches returned document metadata, and reads the selected saved content. |
| Does not | Search local files, web pages, or unsaved conversation content. |
| Required permissions | workspaces:read, articles:read |
| Success result | An answer grounded in returned saved content, with summaries distinguished from exact text. |
| Critical safety | Find is read-only and stops when workspace or document matching is ambiguous. |
Revise a document
Use Revise when the user asks to update, rewrite, correct, insert, remove, or reorganize content in a saved mdedit document.
| Contract | Behavior |
|---|---|
| Example prompt | “Revise the introduction in my saved launch brief without overwriting concurrent changes.” |
| Does | Reads current durable content, applies the smallest anchored edit, and verifies the returned revision. |
| Does not | Edit unsaved local Markdown, guess between repeated anchors, or provide generic editing advice. |
| Required permissions | workspaces:read, articles:read, articles:write |
| Success result | Revised durable content or revision information with no unresolved conflict. |
| Critical safety | The skill uses current content-hash or anchored-edit protection, never overwrites ambiguity, and stops to reconcile conflicts. |
Review a document
Use Review when the user asks to critique, proofread, or suggest improvements to a document already stored in mdedit.
| Contract | Behavior |
|---|---|
| Example prompt | “Review my launch brief in mdedit and leave suggestions for anything unclear.” |
| Does | Reads the saved document, checks existing feedback, and adds anchored comments or suggestions. |
| Does not | Directly edit the writer's Markdown, enable collaboration, publish, or review local and unsaved content. |
| Required permissions | workspaces:read, articles:read, reviews:read, reviews:write |
| Success result | Focused review items plus a concise summary of their count and themes. |
| Critical safety | Review leaves source Markdown unchanged, never guesses ambiguous anchors, and does not expose internal IDs by default. |
Publish a document
Use Publish when the user explicitly asks to inspect publication status, publish, update, or unpublish an existing mdedit public link.
| Contract | Behavior |
|---|---|
| Example prompt | “Check my document’s publication status, then ask before making it public.” |
| Does | Resolves the document, reads current status, confirms the visibility change, performs it, and returns the exact successful result. |
| Does not | Treat a private editor link as public, infer publishing from saving or editing, or offer generic sharing advice. |
| Required permissions | workspaces:read, articles:read, publishing:read, publishing:write |
| Success result | The exact public URL and publication state supplied by a successful mdedit operation. |
| Critical safety | Publishing and unpublishing require explicit confirmation. The skill never fabricates a URL or claims success after a failed result. |
Distribution status
| Channel | Status | Notes |
|---|---|---|
| Portable Agent Plugin | Available | Install the shared Agent Plugins 1.0 repository from source in any compatible host; it bundles the hosted MCP connection and all five skills. |
| ChatGPT and Codex plugin | Available | Available in the ChatGPT Store as Markdown by mdedit.ai. |
| Claude Code plugin | Release candidate | The plugin is ready and awaiting marketplace listing. Until then, load it from the shared repository or use CLI-backed skills. |
| Cursor plugin | Release candidate | The plugin is ready and awaiting marketplace listing. Until then, install the shared repository from source. |
| Gemini CLI extension | Release candidate | The extension is ready and awaiting gallery listing. Until then, install it with the repository URL. |
Available channels can be installed publicly today. Release candidate means the package is finished but not yet listed in that host's public marketplace — install it from source or use the CLI-backed skills for that host in the meantime. Follow Install mdedit skills for commands, authentication, migration, and troubleshooting.