SkillInstalls cleanly
Plans as one clickable page
visual-plan
Free Apache-2.0 skill that turns the plan for one change into a single HTML page: a clickable map, your open decisions as options, and a lock button.
- Works with
- Claude Code, Codex CLI
- Good for
- Build an app
What it does
Coding assistants often answer "plan this" with a ten-page document, and the two decisions that are really yours are buried on page seven. visual-plan writes the design for one change as a single page you open in your browser instead.
The page has a map of how the finished design fits together; click a box to zoom in. Each open decision is shown on the part it affects, with short options, the recommended one first, and the gains, costs and effort of each. Nothing is preselected. When you have picked, press Respond: the page gives you one Markdown message to paste back into the chat. The assistant answers in the chat and updates the page. When the page has no open decision left, a Lock button appears, and the skill tells the assistant to write the task list only after the lock.
The skill tells the page builder to write in ASD-STE100 Simplified Technical English and to keep code out of the plan. The pack checks part of this: it stops on some code shapes (code fences, <pre>, def, arrow functions) outside the places where code references are allowed, and it warns on a short list of non-STE words, contractions, long sentences and one passive pattern.
Example prompts
- "/visual-plan for adding "send later" to the composer"
- "Make a visual plan for moving login to the new gateway."
- "Make a visual plan before you change the checkout page."
How to install
git clone https://github.com/AlmogBaku/visual-plan ~/.claude/skills/visual-planHow to use it
Ask for it by name in the session where you plan a change, for example /visual-plan for adding "send later" to the composer, then open the plan.html it writes.
Check it works
Ask for a visual plan of a small change. The assistant should tell you the path of a plan.html file and list the open decisions. Open the file in a browser; you should see the map and the decision controls.
Common problems
- "node: command not found" — install Node.js; the pack needs it — https://github.com/AlmogBaku/visual-plan
- The page builder runs in your main chat — assistants without subagents build the page inline, which uses more of the conversation — https://github.com/AlmogBaku/visual-plan
- Lock button missing — it appears only when the page has no open decision, so paste your answers and let the assistant rebuild the page first — https://github.com/AlmogBaku/visual-plan
Other assistants
- Codex: the README says to clone the repo "wherever your agent loads skills from" and names no exact path. Its other route is
npx skills add AlmogBaku/visual-plan(Vercel's skills CLI). That command asks which agents to install for and, without-g, installs into the current project only. The skills CLI collects anonymous usage data unless you setDISABLE_TELEMETRY=1orDO_NOT_TRACK=1— https://github.com/AlmogBaku/visual-plan - Gemini CLI: not named in the README and not in the Gemini CLI extensions gallery (checked 2026-11-05) — https://geminicli.com/extensions/
What to watch out for
- The assistant runs a bundled Node.js script, runtime/pack.mjs, on your computer. It uses only Node's own modules and a vendored copy of js-yaml 4.1.1, so there is nothing to npm install, and it makes no network calls
- pack.mjs reads plan.yaml (or plan.json, or plan.js, which it runs in Node's vm module; that is not a security sandbox) and any mockup file the plan names, and writes plan.html beside it or to the --out path
- A page builder subagent writes plan.yaml and plan.html at the path the assistant picks; at the lock the skill tells it to save the final page beside the plan in your repository
- The page's own script loads nothing from the network. It keeps your picks and comments in the browser's localStorage, and your answers reach the assistant only when you paste them into the chat
- The skill sets no disable-model-invocation, so the assistant or another planning skill can start it without you typing /visual-plan
- Uses about 15k tokens in the subagent on the bundled example (README)
- No releases or tags yet (as of 2026-11-05); update with git pull in the skill folder
Licence and author
- Licence
- Apache-2.0
- Author
- Almog Baku (AlmogBaku)
- Source code
- github.com/AlmogBaku/visual-plan
How we tested it
We installed it on an empty test computer on 5 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.
The intake sandbox cannot run git clone install lines, so this test was done by hand. We did not run the skill on a project. Not yet used on real work.
Technical details of the test
- Date
- 5 Nov 2026
- Method
- Manual sandbox run on 2026-11-05 in a clean container (oexp-sandbox image) with no account: ran the README install line git clone https://github.com/AlmogBaku/visual-plan ~/.claude/skills/visual-plan and checked that SKILL.md with its name and description is in place (commit 0d5dd76).
Checked again on 5 Nov 2026
Alternatives
- Superpowers — asks design questions one at a time and writes a design and a plan in Markdown
- Planning with Files — keeps plans and progress in Markdown files
FAQ
- Q: Does it write code? A: The skill tells the assistant to write the design only and to keep code out of the plan, and the pack stops on some code patterns in it. Nothing in the tool stops the assistant from editing code in the same session. The skill says the task list comes after you lock the plan.
- Q: Can I share the plan? A: Yes. It is one self-contained HTML file you can open from disk or host anywhere. Your picks stay in your own browser until you paste them back, and the page can name files from your code.
- Q: Does it work without subagents? A: Yes, it builds the page in the main conversation instead.
Sources
- github.com/AlmogBaku/visual-plan
- github.com/AlmogBaku/visual-plan/blob/0d5dd7608adcf33db76813b195cc881378a5e942/SKILL.md
- github.com/AlmogBaku/visual-plan/blob/0d5dd7608adcf33db76813b195cc881378a5e942/runtime/pack.mjs
- github.com/AlmogBaku/visual-plan/blob/0d5dd7608adcf33db76813b195cc881378a5e942/runtime/visualplan.js