The visual-plan skill · a visual explainer

Stop staring at walls of text full of jargon and gobbledygook.

The visual-plan skill turns a task into a plan you can see. You answer it before you write any code.

Follow one ticket: “Add CSV export to the Reports page”

01The whole flow at once

The process as a wiring diagram. Hover a box to see what it does. Custom instructions feed the completeness gate. The challenge is a side loop.

taskticket or one lineno question loop starts AI plannerreads real codepins the baseline commit visual HTML plandrawn in one passintent gaps become cards you reviewanswer in the browseroverride only to disagree recordwhere you track workticket, file, or nothing custom instructionsoptional · sets "done" challenge-planoptional · only cuts

02You are not alone.

No one understands AI these days.

Swole-doge versus crying-cheems meme: Opus 5 coding versus Opus 5 communicating what it is doing.
Four-panel comic: an agent asks an incomprehensible jargon question, the human shrugs, and the agents ratify the shrug as a ruling carved in stone.
r/ClaudeAI mod-bot summary after 320 comments: the jargon drives everyone up the wall, with a Jargon Hall of Shame list.
r/ClaudeAI post titled: How do I prompt Claude to talk like a normal person? The author says plain-language preferences do not stick.
r/ClaudeAI post: Opus 5 feels like talking to Jordan Peterson. The author keeps the human docs in ASD-STE100 Simplified Technical English.
r/ClaudeAI post: Is anyone else finding Claude really hard to follow lately? It names context whiplash, cryptic shorthand, and thinking brain leak.
the wall the plan, drawn one plain question, default picked

1 · Strong at code, weak at the report

The model codes like a champion. Then it reports like this.

03Anatomy of a decision card

This is a real card from the CSV-export plan. Click an option. Notice the recommended default and the "Other" escape hatch.

Very large reports could outrun the 30-second timeout. How do we handle them?

Most reports are small and stream in under a second. A few have tens of thousands of rows. rows_to_csv() could hold the request open past the gateway timeout.

Stream now, cap at 50,000 rowsrecommendedAbove the cap, ask the user to narrow filters. No queue or worker is built. The seam to go async stays open.
Background job + emailed linkRobust for any size. It adds a queue, a worker, storage, and email. None of those exist yet.
OtherNone of these fit. Type what to do instead.

Selected: Stream now, cap at 50,000 rows (the default)

  • Recommended default. The AI pre-selects its answer. To agree, do nothing.
  • Plain question. It asks the practical choice, not the mechanism.
  • Grounded. It names the real function, rows_to_csv(), from your code.
  • Other. Every card ends with a free-text escape hatch.
  • Copy decisions. In the real plan, one button copies every answer back to chat.

04Install the skills

The skills are plain SKILL.md folders. Clone the repo once. Then copy the folders to where your agent loads skills.

git clone https://github.com/parthjshah95/visual-planning-skills
cd visual-planning-skills

Claude Codeplugin

claude plugin marketplace add parthjshah95/visual-planning-skills
claude plugin install visual-planning-skills@visual-planning-skills

Codex / ChatGPTglobal

cp -R skills/* ~/.codex/skills/

Cursorglobal

cp -R skills/* ~/.cursor/skills/

OpenCodeglobal

cp -R skills/* ~/.config/opencode/skills/

OpenClawglobal

cp -R skills/* ~/.openclaw/skills/

Hermesper profile

cp -R skills/* ~/.hermes/profiles/<profile>/skills/

Windsurfper project

cp -R skills/* <project>/.windsurf/skills/

Antigravityper workspace

cp -R skills/* <workspace>/.agents/skills/

05Credits