mdedit agent skills
mdedit skills give compatible AI agents a concise, repeatable workflow for working with your durable Markdown documents. The launch catalog contains four focused skills: Save, Find, Revise, 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. |
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 | What remains |
|---|---|---|
| Portable Agent Skills | Release candidate | CLI-backed skills generated for the open Agent Skills format. Public installation begins with mdedit-cli 0.4.0. |
| ChatGPT and Codex plugin | Release candidate | Package and live workflow qualification are complete; directory submission and publication remain human-gated. |
| Claude Code plugin | Release candidate | The package validates locally; production OAuth and marketplace publication remain release gates. |
| Cursor plugin | Planned | A generated candidate package exists, but IDE and CLI authentication and upstream acceptance are not yet verified. |
| Gemini CLI extension | Planned | A generated API-key candidate exists; OAuth compatibility and public extension distribution remain unverified. |
“Release candidate” means the artifacts exist and pass repository validation but are not yet claimed as publicly installable. “Available” is reserved for a version whose public installation and signed-in create, read, edit, publish, and unpublish workflow have been verified. Follow Install mdedit skills for commands, authentication, migration, and troubleshooting.
Why there are no individual skill pages
Each skill is a small procedural contract and its catalog section is the human-facing reference. A skill receives a dedicated page only when it develops substantial independent setup, troubleshooting, or reference material—or demonstrated search and support demand that the catalog cannot serve clearly.