Visual Plan
85TrustedInstructions onlyDiagrams, component maps, and UI prototypes for complex development project reviews.
What it does
Visual Plan transforms standard coding documentation into interactive, structured documents. It enables your assistant to present technical strategies through mixed media, incorporating architectural diagrams, code snippets, and interface previews directly into the planning workflow. By organizing complex tasks into visual components, it clarifies logic flows and structural dependencies that are difficult to convey through text alone.
This approach is designed to foster alignment before implementation begins. It provides a standardized space for you and the assistant to review potential changes, critique design directions, or resolve open technical questions using a clear, scannable format. The result is a more deliberate development process where large, risky, or ambiguous changes are vetted through a dedicated review surface.
When it earns its place
Reach for it when…
Apply this for tasks requiring stakeholder alignment or deeper technical validation, such as defining new API shapes, designing multi-state UI surfaces, or mapping complex backend workflows. It is most effective when you need to weigh options, compare architectural alternatives, or ensure a feature's core logic is sound before committing code changes.
Look elsewhere when…
Do not employ this for straightforward maintenance tasks or trivial updates that require no architectural deliberation. If you can clearly define the scope in one or two sentences, adding this structured layer introduces unnecessary overhead rather than clarity.
What to say to use it
You never invoke a skill directly — the assistant picks it up when your request matches what it covers. These are the kinds of things that do that.
- sketch out an architecture plan for this new feature
- let us review the design and flow for the user settings page
- create a visual overview of how these two components should interact
- draft a project roadmap with a prototype mockup
Install it
Install for all your projects
Copy the skill directory into your personal skills folder. Claude picks it up on its own the next time your request matches what it does — there is nothing to enable.
git clone --depth 1 --branch main https://github.com/BuilderIO/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/visual-plan ~/.claude/skills/visual-planInstall for one project only
Put it in the project's own skills folder instead, so it can be committed and shared with everyone working on that repository.
cp -r /tmp/skills/skills/visual-plan .claude/skills/visual-planIf a skill of the same name exists in both places, the personal one wins.
Installing on Claude.ai or through the API instead? The full guide covers every surface.
Pair it with an MCP server
Visual Plan changes how the work is done. These servers change what Claude can reach while doing it.
- Miro AI MCP Server78The skill carries the visual judgement; Miro AI MCP Server gives Claude access to the design files that judgement applies to.
- File System MCP Server46Add File System MCP Server so generated images and assets can be written somewhere useful rather than only described.
- Playwright MCP Server46With Playwright MCP Server, a design can be rendered and looked at rather than assessed from the markup alone.