Files
Gaudenz Alder 516965c7c4 feat(plugin): author diagrams as Mermaid + ELK --layout via desktop CLI
The draw.io desktop CLI (30.2.6+) can convert Mermaid to native .drawio
and run ELK auto-layout on XML, so the Claude Code plugin now uses both.

- SKILL.md rewritten around a "produce a .drawio first, then deliver"
  pipeline: prefer Mermaid for standard diagram types when the CLI is
  present, XML for custom styling / precise positioning / no-CLI fallback.
- Adds an ELK layout section (preset names + custom-layout JSON schema)
  and links shared/mermaid-reference.md.
- Mermaid exports go two-step (convert to .drawio, then export) to embed
  editable XML and sidestep the direct Mermaid->PNG embed bug in current
  released desktop apps.
- README.md / DEVELOPING.md / root CLAUDE.md updated to match; plugin.json
  description refreshed and version bumped to 1.1.0.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-01 08:53:26 +02:00
..

AI Assistant Plugins

This directory groups assistant-side integrations by host — one subdirectory per AI assistant. Each subdirectory is the plugin root for its host, packaging the draw.io skill in whatever format that host expects (manifest schema, file layout, invocation convention).

Directory Host Status
claude-code/ Claude Code Available

The Claude Code plugin is published through a marketplace manifest at the repo root (.claude-plugin/marketplace.json), so users can install it with:

/plugin marketplace add jgraph/drawio-mcp
/plugin install drawio@drawio

Adding a plugin for another host

If support for another assistant (Cursor, Codex, etc.) is added later, it lands as a sibling directory at this level:

plugins/
└── claude-code/              ← Claude Code plugin

The draw.io guidance itself — how to generate .drawio files, embed XML in PNG/SVG/PDF, and produce app.diagrams.net URLs — is shared. Only the wrapping (manifest format, file layout, invocation prefix) differs per host, and each host has its own plugin/skill model, so the wrapping is not assumed to be uniform.

The single source of truth for draw.io XML generation guidance lives at ../shared/xml-reference.md — every plugin references that file rather than duplicating its contents.

Other delivery mechanisms in this repo

Plugins are one of four ways to integrate draw.io with AI assistants. See the root README for the full comparison with the MCP App Server, MCP Tool Server, and Claude Project Instructions approaches.