Visual Plan

85TrustedInstructions only

Diagrams, 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.

bash
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-plan

Install 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.

bash
cp -r /tmp/skills/skills/visual-plan .claude/skills/visual-plan

If 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