mdedit agent skills
Give your AI agent five workflows for documents saved in mdedit.ai: save, find, revise, review, and publish. Each skill explains when to use it, which permissions it needs, and how to check the result.
Quickstart
ChatGPT or Codex: install Markdown by mdedit.ai (opens in a new tab) from the ChatGPT Store and connect your mdedit.ai account when prompted. The plugin includes the MCP connection and all five skills.
Agents with terminal access: install the CLI and all five skills from your project directory. You need Node.js 20 or newer and a mdedit.ai account.
npm install -g mdedit-cli
mdedit auth login
mdedit skill install
mdedit skill doctorSign in through your browser and approve workspace access. For CI or unattended agents, use a scoped API key instead. The required permissions are listed for each skill below.
By default, the skills are installed in .agents/skills for the current project. For Claude Code, Cursor, or Gemini CLI, replace the install command with the matching target:
mdedit skill install --target claude
mdedit skill install --target cursor
mdedit skill install --target geminiRun only the command for your agent. Add --scope user to install across projects, or pass a skill name to install just one:
mdedit skill install save-mdedit-document --target claudeThen ask your agent:
Save this conversation as a private Markdown document in mdedit.
For source plugin installs, MCP setup, browser sign-in, updates, and troubleshooting, see Install mdedit skills.
Save a document (save-mdedit-document)
Save conversation content or a draft as a new private document in mdedit.ai.
| Detail | What to expect |
|---|---|
| Example prompt | “Save this conversation as a private Markdown document in mdedit.” |
| What it does | Finds the destination workspace, creates a private document, and checks that it was saved. |
| Outside its scope | Writing Markdown without saving it to mdedit.ai, creating local files, or publishing publicly. |
| Required permissions | workspaces:read, articles:write |
| Result | The saved document’s title and a confirmation that it was saved privately. |
| Safeguards | The document stays private. Publishing requires a separate request and confirmation. |
Find a document (find-mdedit-document)
Find a saved document by name, read it, quote from it, or summarize its content.
| Detail | What to expect |
|---|---|
| Example prompt | “Find my project brief in mdedit and summarize the saved version.” |
| What it does | Searches the workspace for matching documents and reads the selected document. |
| Outside its scope | Local files, web pages, and unsaved conversation content. |
| Required permissions | workspaces:read, articles:read |
| Result | An answer based on the saved content, with summaries distinguished from exact quotes. |
| Safeguards | Finding a document does not change it. The agent asks you to choose if multiple workspaces or documents match. |
Revise a document (revise-mdedit-document)
Update, rewrite, correct, or reorganize content in a saved document.
| Detail | What to expect |
|---|---|
| Example prompt | “Revise the introduction in my saved launch brief without overwriting concurrent changes.” |
| What it does | Reads the latest saved content, edits the requested text, and checks the result. |
| Outside its scope | Unsaved local Markdown and general editing advice. |
| Required permissions | workspaces:read, articles:read, articles:write |
| Result | A confirmation of the saved edit, or a conflict that needs your input. |
| Safeguards | The agent checks for concurrent changes and stops if the target text is ambiguous or the edit conflicts. |
Review a document (review-mdedit-document)
Ask for feedback on a saved document, or accept or reject an existing suggestion.
| Detail | What to expect |
|---|---|
| Example prompt | “Review my launch brief in mdedit and leave suggestions for anything unclear.” |
| What it does | Reads the document and existing feedback, adds comments or suggestions, or accepts or rejects a selected suggestion. |
| Outside its scope | Unrelated edits, publishing, and local or unsaved content. |
| Required permissions | workspaces:read, articles:read, reviews:read, reviews:write; accepting a suggestion also needs articles:write |
| Result | New feedback or a confirmation of the requested suggestion decision, with a concise summary. |
| Safeguards | Comments and suggestions leave the Markdown unchanged until accepted. The agent asks when the target text or suggestion is ambiguous. |
Publish a document (publish-mdedit-document)
Check a document’s public-link status, publish or update it, or disable its public link.
| Detail | What to expect |
|---|---|
| Example prompt | “Check my document’s publication status, then ask before making it public.” |
| What it does | Finds the document, checks its public-link status, confirms the requested visibility change, and returns the result. |
| Outside its scope | Private editor links and general sharing advice. |
| Required permissions | workspaces:read, articles:read, publishing:read, publishing:write |
| Result | The public URL and its status after a successful operation. |
| Safeguards | The agent asks for confirmation before publishing or disabling a public link. Saving or editing alone does not authorize publishing. |
Installation options
| 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. |
For channels marked Release candidate, use a source install or CLI-backed skills while the marketplace listing is unavailable. Follow Install mdedit skills for commands, authentication, migration, and troubleshooting.
Last reviewed