Install mdedit agent skills

Install the five mdedit skills as a plugin with an MCP connection, or as instructions for an agent that uses the CLI.

Portable Agent Plugin combines the shared MCP-backed skills and hosted mdedit MCP connection in one repository.
CLI-backed skills remain available for hosts that support Agent Skills but cannot load an MCP-backed plugin.

Let your agent set itself up

Copy this prompt into your assistant:

Fetch and follow the appropriate instructions to connect this agent to mdedit.ai from https://mdedit.ai/agent-setup/prompt.md

The setup instructions (opens in a new tab) guide your agent through the appropriate installation, browser sign-in, and a read-only connection check. Hosts that need a UI installation will show you the next action. Setup does not create or publish documents.

Quickstart

ChatGPT or Codex: install Markdown by mdedit.ai (opens in a new tab) and connect your mdedit.ai account when prompted.

Agents with terminal access: with Node.js 20 or newer installed, run these commands from your project directory:

npm install -g mdedit-cli
mdedit auth login
mdedit skill install
mdedit skill doctor

Sign in through your browser and approve workspace access. For CI or unattended agents, use a scoped API key instead. The default install adds all five CLI-backed skills to .agents/skills in the current project. For other host directories, use the targets below.

Channel 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.

Channels marked Available can be installed publicly today. For release-candidate channels, the marketplace listing is not live yet — use the source install or CLI-backed setup shown for the host below.

Recommended setup by host

Host	Recommended setup	Notes
ChatGPT and Codex	Install Markdown by mdedit.ai from the ChatGPT Store (opens in a new tab).	Available in the ChatGPT Store.
Claude Code	Load the shared repository with its Claude Code adapter, or use CLI-backed skills in `.claude/skills`.	Marketplace listing not yet available; install from source.
Cursor	Install the shared Agent Plugin repository from source; use `mdedit skill install --target cursor` when only local skills are wanted.	Marketplace listing not yet available; install from source.
Gemini CLI	Install the shared repository as a Gemini extension; use `mdedit skill install --target gemini` when only local skills are wanted.	Gallery listing not yet available; install with the repository URL.
Other Agent Plugins clients	Install the shared repository through the host's source or local-plugin flow.	The host manages OAuth discovery and credentials for the portable MCP connection.

Perplexity does not currently support mdedit skills.

Portable Agent Plugin

The public package is available at:

https://github.com/mdedit-ai/mdedit-agent-plugin

The repository includes all five skills, the hosted MCP connection, and setup files for Gemini CLI, Cursor, and Claude Code.

In VS Code, run Chat: Install Plugin From Source and enter the repository URL. For Gemini CLI:

gemini extensions install https://github.com/mdedit-ai/mdedit-agent-plugin

After installation, sign in through your host and approve workspace access. For clients without browser sign-in, use a scoped API key. See MCP authentication.

Portable Agent Skills

Compatible Agent Skills installers can discover the catalog and five raw skill files from mdedit.ai:

npx skills add https://mdedit.ai

The public index is https://mdedit.ai/.well-known/skills/index.json. Its SKILL.md files are CLI-backed and declare mdedit-cli as a compatibility requirement.

Install with mdedit-cli

The native installer defaults to all five CLI-backed skills, project scope, and .agents/skills:

mdedit skill list
mdedit skill install
mdedit skill doctor

Choose individual skills, transport, scope, or host directory explicitly:

mdedit skill show revise-mdedit-document --via mcp
mdedit skill install save-mdedit-document revise-mdedit-document --via cli
mdedit skill install --via mcp --target claude --scope user
mdedit skill install publish-mdedit-document --via mcp --target cursor
mdedit skill install --via mcp --target gemini

Target	Project directory	User directory
`agents`	`.agents/skills`	`~/.agents/skills`
`claude`	`.claude/skills`	`~/.claude/skills`
`cursor`	`.cursor/skills`	`~/.cursor/skills`
`gemini`	`.gemini/skills`	`~/.gemini/skills`

Rerunning the installer updates unchanged mdedit skills. If a file was edited or installed by another tool, installation stops rather than replacing it. Use --force only if you want to discard that file. Uninstall removes only unchanged files installed by mdedit.

Authenticate the transport

CLI-backed skills

mdedit auth login
mdedit auth status

For CI or hosts without browser OAuth, create a scoped key in API Keys, then use MDEDIT_API_KEY or mdedit config login --api-key <key>. See the full CLI authentication reference.

MCP-backed skills

Host plugins connect to https://mcp.mdedit.ai/mcp. Use browser sign-in when your host supports it and approve workspace access. For hosts without browser sign-in or unattended workflows, use a scoped API key following MCP authentication. Do not put an API key in a committed plugin or skill file.

Update or change variants

Run the same install command after upgrading mdedit-cli. An unchanged mdedit-owned installation updates in place; an edited copy stops for review.

npm install -g mdedit-cli@latest
mdedit skill doctor --via cli
mdedit skill install --via cli

To use an existing MCP connection instead of the CLI, install the MCP variant:

mdedit skill doctor --via mcp --target claude
mdedit skill install --via mcp --target claude

Uninstall

mdedit skill uninstall
mdedit skill uninstall publish-mdedit-document --target cursor
mdedit skill uninstall --scope user --target claude

If a skill changed after installation, uninstall leaves it in place. Review the local changes and remove it manually only if you intend to discard them.

Migrate legacy instructions

Older CLI releases appended a monolithic mdedit section to CLAUDE.md, wrote .cursor/rules/mdedit.mdc, or appended Copilot instructions. New releases never mutate those files. Diagnose them with:

mdedit skill doctor --format json

Review and remove a reported legacy block manually, then install the focused skills in the host’s native skill directory. doctor does not rewrite or delete host instructions.

Troubleshooting

Symptom	What to do
`unowned` or `modified` collision	Inspect the existing skill. Use `--force` only when installing and only if replacement is intentional.
`stale` in `doctor`	Upgrade the CLI and rerun the matching `install --via ...` command.
Authentication denied	Verify the selected transport, active CLI profile or MCP connection, and the scopes listed in the skill catalog.
Ambiguous workspace or document	Supply the exact returned workspace and document identity; do not guess from names.
Publish result has no public URL	Treat the operation as unsuccessful and do not construct an `mded.it` URL.
Marketplace install is unavailable	Check the channel status above. If a host's marketplace listing is not live yet, install from source or use CLI-backed skills for that host.

For CLI command behavior, see CLI. For public visibility semantics, see Public links and publishing.

Skill catalog Overview

Last reviewed October 8, 2026