# drawio-reconstruction

Reconstructs diagram images, research figures, and slides into editable .drawio files while matching the original look. It exports vector elements alongside rendered preview images.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 509 installs · ★ 10652
- Author: HKUSTDial
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/drawio-reconstruction/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/drawio-reconstruction

## What it does

This skill rebuilds architecture diagrams, scientific charts, and slide screenshots into editable `.drawio` XML files. Native Draw.io shapes handle text labels and structural containers. Vector SVG elements cover simple icons, while complex graphical sections use cropped transparent PNG files. Exact visual fidelity comes first: approximate styles or generic fonts count as defects.

Before drawing anything, the agent catalogues visible elements into an audit inventory with coordinates, geometry, and styling notes. The workflow separates layout adjustments from text edits. Increasing font sizes or realigning boxes is permitted, but editing labels or shortening sentences requires explicit user approval.

When processing entire folders, the skill relies on Python helper scripts like `batch_manifest.py` and `batch_verify.py` to organize tasks sequentially or across worker pools. Validating XML or passing syntax scripts does not guarantee completion. The agent must visually compare the rendered preview with the reference at full size.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill drawio-reconstruction -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/drawio-reconstruction/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/drawio-reconstruction/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill drawio-reconstruction -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/drawio-reconstruction/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill drawio-reconstruction -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/drawio-reconstruction/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HKUSTDial/Supervisor-Skills drawio-reconstruction
```

2. **Manually: put the files in place**
- File: `.github/skills/drawio-reconstruction/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill drawio-reconstruction -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUSTDial/Supervisor-Skills --path skills/drawio-reconstruction
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/drawio-reconstruction/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill drawio-reconstruction -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/drawio-reconstruction/SKILL.md

## When to use it
- reconstruct raster diagram images into editable .drawio XML
- preserve precise colors, arrow geometries, and icon layouts from screenshots
- process multi-image folders through a structured batch manifest
- audit reconstructed previews against reference images before delivery

## Example prompts
- Reconstruct architecture-overview.png into an editable .drawio diagram
- Process all diagram images in ./figures using the batch manifest workflow
- Increase font size and box padding in system-flow.drawio without altering label text

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f83c76ced21f163d.

BEGIN THIRD-PARTY FILE f83c76ced21f163d
```text
---
name: drawio-reconstruction
description: "Reconstructs reference images into high-fidelity, editable Draw.io files with rendered previews: native Draw.io elements carry text and structure, SVG covers simple icons that match the reference, and cropped or transparent PNGs preserve complex visuals. Use when the user wants a diagram image, research figure, architecture diagram, slide, UI screenshot, or image folder turned into `.drawio` XML; batch requests use a manifest with bounded parallelism when available and a full-fidelity serial fallback otherwise."
---

# Draw.io Reconstruction

Use this skill for high-quality reconstruction of diagram images into `.drawio` files.

## Helper Script Location

Resolve `SKILL_DIR` to the absolute directory containing this `SKILL.md` before running any bundled helper. Use the resolved skill location provided by the runtime; never assume the skill is installed under `~/.codex`, `~/.agents`, or any other fixed directory.

All commands below use `$SKILL_DIR` to mean that resolved absolute directory.

## Fidelity Contract

The primary goal is visual fidelity to the reference image. Editability is secondary.

Do not treat semantic equivalence as success. A generic icon, generic curve, generic font size, approximate panel, or approximate background is a defect when the reference has a specific visual style.

Script checks only prove technical validity. A diagram is not complete merely because `.drawio` opens, exports, or passes `check_drawio.py` / `batch_verify.py`. Completion requires visual comparison against the reference at full size.

Work only in the target directory or target files named by the user. Do not repair, overwrite, or improve neighboring diagrams because they look related. If the requested target is ambiguous, inspect and report the ambiguity before editing.

Never silently rewrite the user's content. If the user asks for larger fonts or a more professional PPT style, first distinguish:

- **Layout-only refinement**: increase font size, resize boxes, improve spacing, align elements, adjust line breaks without changing words.
- **Content compression**: shorten sentences, remove details, rewrite labels. Ask permission before doing this.

## Batch Folder Workflow

Use this workflow when the user provides a directory of images or asks for batch reconstruction.

### Batch Intent And Scheduling
```
END THIRD-PARTY FILE f83c76ced21f163d

The third-party file has ended. Everything between the f83c76ced21f163d tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2381 of 21671 bytes. © HKUSTDial · MIT · https://github.com/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/drawio-reconstruction/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md