Excalidraw Canvas Toolkit
lingzhi227/agent-research-skills
Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.
Navigate the UML-MCP repository and its documentation quickly.
Install Uml MCP Navigation
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .claude/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .claude/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .agents/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .agents/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .cursor/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .cursor/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/antoinebou12/uml-mcp.git --path .skill/skills/uml-mcp-navigation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .gemini/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .gemini/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .github/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .github/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .github/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install antoinebou12/uml-mcp uml-mcp-navigation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/antoinebou12/uml-mcp.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.skill/skills/uml-mcp-navigation .opencode/skills/uml-mcp-navigation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "uml-mcp-navigation" agent skill from https://github.com/antoinebou12/uml-mcp/tree/main/.skill/skills/uml-mcp-navigation into .opencode/skills/uml-mcp-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "uml-mcp-navigation", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
uml-mcp-navigation- GitHub stars
- 105
- Token cost
- ~1.1k tokens
- SKILL.md length
- 271 words
- Files
- 1
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- MIT
At a glance
Navigate the UML-MCP repository and its documentation quickly.
- Works in 3 steps: Read AGENTS.md (preferences, facts) and… → Check .plan/STATUS.md and… → Use the map below; open the test file…
- Tasks that involve Diagrams
- SKILL.md covers First steps, Feature map, Docs layout and Verify a change, plus 1 more section
- Calls uv
What it does
Uml MCP Navigation is an agent skill from antoinebou12/uml-mcp. Navigate the UML-MCP repository and its documentation quickly. Maps every feature (tools, rendering, auth, config file, audit, rate limits, lint, admin dashboard, Helm, docs) to its code, tests and docs, and lists the commands to verify a change. Use before editing UML-MCP code or docs, when answering "where is X", or when planning work from the .plan backlog.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Diagrams and MCP servers. It works with Model Context Protocol. The repository describes itself as: UML-MCP Server is a UML diagram generation tool based on MCP (Model Context Protocol), which can help users generate various types of UML diagrams through natural language…. The licence is MIT.
When your agent uses it
- Tasks that involve Diagrams
- Tasks that involve MCP servers
Example prompts
- “where is X”
- “/uml-mcp-navigation”
Requirements
- Python 3
- Docker
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Read AGENTS.md (preferences, facts) and SOUL.md (principles).
- Check .plan/STATUS.md and .plan/BACKLOG.md for current state and priorities.
- Use the map below; open the test file next to the code you change.
What it can do on your machine
Read from SKILL.md and the folder at commit b4413c7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Uml MCP Navigation loads about 1.1k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 271 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from antoinebou12/uml-mcp at commit b4413c7, republished under its MIT licence (© antoinebou12). 271 words, ~1,103 tokens.
Download SKILL.mdSave it as
.claude/skills/uml-mcp-navigation/SKILL.md (or your agent's skills folder).- name
- uml-mcp-navigation
- description
- Navigate the UML-MCP repository and its documentation quickly. Maps every feature (tools, rendering, auth, config file, audit, rate limits, lint, admin dashboard, Helm, docs) to its code, tests and docs, and lists the commands to verify a change. Use before editing UML-MCP code or docs, when answering "where is X", or when planning work from the .plan backlog.
Navigating UML-MCP
First steps
- Read
AGENTS.md(preferences, facts) andSOUL.md(principles). - Check
.plan/STATUS.mdand.plan/BACKLOG.mdfor current state and priorities. - Use the map below; open the test file next to the code you change.
Feature map
| Feature | Code | Tests | Docs |
|---|---|---|---|
MCP tools (generate_uml, validate_uml, …) | mcp_core/tools/diagram_tools.py, tool_decorator.py | tests/test_diagram_tools.py, test_tool_decorator.py | docs/api/tools.md |
| Resources / prompts | mcp_core/resources/diagram_resources.py, mcp_core/prompts/diagram_prompts.py | tests/test_diagram_resources.py, test_diagram_prompts.py | docs/reference/ |
| Rendering (Kroki, PlantUML, fallback) | tools/kroki/, mcp_core/core/utils.py | tests/test_kroki.py, test_fallback_mechanism.py | docs/fallback-mechanism.md |
| HTTP app (REST, AG-UI, /mcp mount) | app.py | tests/test_app.py, test_agui.py | docs/integrations/frontend.md |
| Stdio / CLI / subcommands | mcp_core/core/cli.py, commands.py, client_install.py | tests/test_cli.py, test_client_install.py | docs/installation-local.md |
Config file uml-mcp.yaml | mcp_core/core/settings_file.py, mcp_core/config_templates/ | tests/test_settings_file.py | docs/configuration/uml-mcp-yaml.md |
| Env settings | mcp_core/core/config.py | tests/test_config.py | docs/configuration.md |
| Audit, metrics, rate limits, logging | mcp_core/observability/, mcp_core/core/http_observability.py | tests/test_observability.py | docs/enterprise/operations.md |
Lint (uml-mcp lint) | mcp_core/quality/lint.py | tests/test_lint.py | docs/developers/linting.md |
| Enterprise auth (Entra / OAuth) | mcp_core/auth/ | tests/test_auth_*.py, tests/http/entra-auth.http | docs/enterprise/ |
| Admin dashboard | mcp_core/auth/admin/, mcp_core/observability/admin_api.py | tests/test_auth_admin.py, test_admin_dashboard.py | docs/enterprise/admin-ui.md |
| Admin console + Kroki page (playground, Docker stack) | mcp_core/admin/ (kroki_routes.py), mcp_core/kroki/, frontend/src/pages/Kroki.tsx, CLI uml-mcp kroki | tests/test_admin_kroki.py, test_real_journeys.py, test_e2e_playwright.py | docs/admin/ (install, user guide, tour) |
| Helm / Docker | deploy/helm/uml-mcp/, Dockerfile, docker-compose*.yml | tests/test_enterprise_packaging.py, test_compose_profiles.py | docs/enterprise/kubernetes.md, docs/deploy/docker.md |
| Smoke tests | scripts/run_mcp_smoke.py, tests/prompts/ | tests/test_chatgpt_mcp_smoke_prompt.py | tests/prompts/chatgpt_mcp_smoke_test.md |
| Diagram skills | .skill/skills/uml-mcp-diagrams/SKILL.md (canonical) | mirror test in test_enterprise_packaging.py | docs/integrations/cursor.md |
Docs layout
mkdocs.yml nav: is the table of contents. Sections: Tutorials · Diagram types ·
Reference (tools, resources, prompts, configuration, uml-mcp.yaml) · Deploy
(installation, local install, Docker, clients) · Enterprise (guide, architecture,
Entra, config, clients, Helm, admin, operations, security, troubleshooting) ·
Developers (testing, linting, contributing). New pages must be added to nav.
Verify a change
uv run ruff check . && uv run ruff format --check . && uv run ty check
uv run pytest -q # coverage gate 82%
UML_MCP_CONFIG=none uv run uml-mcp lint --strict
MKDOCS_SOCIAL=false uv run mkdocs build --strict
uv run python scripts/run_mcp_smoke.py --offlineLocal CI: act pull_request -W .github/workflows/ci.yml -j lint (see .plan/STATUS.md).
Rules that bite
- Keep
.skill/skills/uml-mcp-diagrams/SKILL.mdand.github/skills/uml-mcp-diagrams/SKILL.mdbyte-identical. - Version bumps touch many files:
tests/test_version_consistency.pylists them. - Never enable auth on Vercel; never forward client tokens; secrets never in YAML/JSON config.
- Stdio transport: log to stderr only.
© antoinebou12, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .skill/skills/uml-mcp-navigation of antoinebou12/uml-mcp.
Open the folder on GitHubat commit b4413c7
Compare with similar skills
Uml MCP Navigation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Uml MCP Navigation this skillantoinebou12/uml-mcp | 105 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Excalidraw Canvas Toolkitlingzhi227/agent-research-skills | 390 | — | ~3.8k | Automated safety check: Pass | None | |
| Mellos MappingGuangminJu/mellos-mapping | 103 | — | ~2.1k | Automated safety check: Pass | MIT | |
| At Visionkairyou/agent-tools | 178 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Siyuan MCP Markup Guideyangtaihong59/siyuan-plugins-mcp-sisyphus | 116 | — | ~405 | Automated safety check: Pass | MIT | |
| Dotnet Debuggingnovotnyllc/dotnet-artisan | 232 | — | ~2.1k | Automated safety check: Pass | MIT |
Similar skills
Mellos Mapping
GuangminJu/mellos-mapping
Create and resume persistent layered maps in Codex CLI and Codex App, and update them as implementation is verified.
At Vision
kairyou/agent-tools
Inspect screenshots, photos, diagrams, image paths, and image URLs when the task depends on visible content.
Siyuan MCP Markup Guide
yangtaihong59/siyuan-plugins-mcp-sisyphus
MCP SiYuan markup guide for rich Markdown written through block and document actions.
Dotnet Debugging
novotnyllc/dotnet-artisan
Debugs Windows and Linux/macOS applications (native, .NET/CLR, mixed-mode) with WinDbg MCP (crash dumps, !analyze, !syncblk, !dlk, !runaway, !dumpheap, !gcroot, BSOD), dotnet-dump, lldb with SOS…
Release
WebMCP-org/npm-packages
Release the @mcp-b monorepo with Changesets and pnpm, using npm trusted publishing in GitHub Actions.
More from antoinebou12/uml-mcp
Uml Diagramming
antoinebou12/uml-mcp
Produces Mermaid or PlantUML diagram code from user specifications for UML, architecture, and flow diagrams.
MCP Python
antoinebou12/uml-mcp
Create and extend MCP (Model Context Protocol) servers in Python using FastMCP and the official SDK.
Uml Diagrams
antoinebou12/uml-mcp
Create and validate diagrams with the uml-mcp MCP server (generateuml, generateumlimage, validateuml, listdiagramtypes, generateumlbatch).
Uml MCP Diagrams
antoinebou12/uml-mcp
Creates diagrams via the uml-mcp MCP server (generateuml, generateumlimage, validateuml, listdiagramtypes, generateumlbatch) and returns shareable Kroki URLs or inline chat images.
Modern Python
antoinebou12/uml-mcp
Modern Python tooling and best practices using uv, ruff, ty, and pytest.
Sequential Thinking
antoinebou12/uml-mcp
Step-by-step and reflective problem-solving for complex or multi-step tasks.
Related
Works with
Categories
Questions about Uml MCP Navigation
What does Uml MCP Navigation do?
Navigate the UML-MCP repository and its documentation quickly. Uml MCP Navigation is an agent skill from antoinebou12/uml-mcp. Navigate the UML-MCP repository and its documentation quickly.
When should I use Uml MCP Navigation?
Uml MCP Navigation fits situations like: tasks that involve Diagrams; tasks that involve MCP servers.
How do I install Uml MCP Navigation in Claude Code?
Run `npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a claude-code`. Or copy the skill folder (.skill/skills/uml-mcp-navigation in antoinebou12/uml-mcp) into .claude/skills/uml-mcp-navigation in your project. Claude Code loads it when a task matches its description.
How do I install Uml MCP Navigation in Codex?
Run `npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a codex`. Or copy the skill folder (.skill/skills/uml-mcp-navigation in antoinebou12/uml-mcp) into .agents/skills/uml-mcp-navigation in your project. Codex loads it when a task matches its description.
Can I use Uml MCP Navigation in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add antoinebou12/uml-mcp --skill uml-mcp-navigation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uml-mcp-navigation, .gemini/skills/uml-mcp-navigation, .github/skills/uml-mcp-navigation and .opencode/skills/uml-mcp-navigation in your project.
What does Uml MCP Navigation need to run?
Going by SKILL.md and its folder, Uml MCP Navigation needs the command-line tools its instructions call (uv). Our summary lists: Python 3; Docker.
Does Uml MCP Navigation access the network?
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Uml MCP Navigation safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Uml MCP Navigation use?
Uml MCP Navigation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Uml MCP Navigation use?
About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Uml MCP Navigation?
Skills that share tags, products or a category with Uml MCP Navigation: Excalidraw Canvas Toolkit (lingzhi227/agent-research-skills, 390 stars), Mellos Mapping (GuangminJu/mellos-mapping, 103 stars), At Vision (kairyou/agent-tools, 178 stars) and Siyuan MCP Markup Guide (yangtaihong59/siyuan-plugins-mcp-sisyphus, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Uml MCP Navigation?
antoinebou12 (a GitHub user) maintains it in antoinebou12/uml-mcp, which has 105 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 11, 2026.
Source: antoinebou12/uml-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.