Install mdedit agent skills

Start with the five-skill catalog. Choose one transport for the agent doing the work:

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.

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

Its root plugin.json, mcp.json, and skills/ directory follow Agent Plugins 1.0. Gemini CLI, Cursor, and Claude Code compatibility manifests live in the same repository and reuse those skills rather than carrying separate copies.

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

The package does not contain an API key, client secret, authorization code, or token. Compatible clients manage authentication for the portable connection; the thin host adapters contain only public OAuth client registration and bounded scopes.

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`

Installations are atomic and idempotent. Each installed skill has mdedit ownership metadata and a content checksum. The installer refuses to overwrite an unowned or edited skill without --force; uninstall removes only unchanged mdedit-owned files.

Authenticate the transport

CLI-backed skills

Interactive browser OAuth is rolling out gradually and may not be enabled for your account yet. Where available, use:

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 OAuth only in hosts where the production flow is marked verified. Other supported runtimes can 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

Switching from CLI-backed to MCP-backed instructions is explicit:

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