Codex Visio Replica Workflow

What it does

This skill guides an agent to recreate reference diagrams (screenshots, whiteboards, system diagrams) as editable Microsoft Visio (.vsdx) files. It covers environment checks, mapping pixel coordinates to Visio units, building an editable plan, optional PowerShell-driven Visio automation, preview export, and preparing a step-by-step recording or tutorial package for hand-off. The skill also includes practical checks and fallbacks for font, export, and COM automation issues on Windows.

When to use it

Use this skill when a user wants a faithful, editable Visio version of an existing diagram, needs an automated Visio generation pipeline, or requests a polished recording/tutorial showing how the diagram was reconstructed. It is appropriate for designers, docs engineers, or automation workflows that must produce .vsdx deliverables and validated previews.

What's included

• Scripts: references to environment-check and generator scripts (repo provides PowerShell helpers).
• References: guidance on COM automation, export fallbacks, and recording best practices.
• Instructions: stepwise process for collecting inputs, decomposing the reference image, creating a JSON plan, generating or hand-building the Visio file, exporting previews, and preparing recording steps.

Compatible agents

Best used with agents capable of producing structured plans and calling automation scripts (Codex-style agents, Copilot/Copilot-like automation runners). The guidance assumes a Windows environment with Visio installed.