What is vision-builder?

A guided conversation process for turning a vague project idea into a structured project vision document. It asks questions about the project type and progressively refines the idea.

Defining a new web app, CLI tool, API, desktop or mobile app, library, or other project and producing an actionable project.vision.md file.

It helps turn an incomplete concept into a clearer plan that can guide implementation.

How YougLin-dev/Aha-Loop configures Claude Code and Codex

Reuse

Borrowing it

Nothing to install: this file belongs to YougLin-dev/Aha-Loop. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/YougLin-dev/Aha-Loop/main/.agents/skills/vision-builder/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/YougLin-dev/Aha-Loop

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/youglin-dev/aha-loop/vision-builder/github.svg)](https://agentmods.dev/skills/youglin-dev/aha-loop/vision-builder)

Your own site

<a href="https://agentmods.dev/skills/youglin-dev/aha-loop/vision-builder"><img src="https://agentmods.dev/badge/skills/youglin-dev/aha-loop/vision-builder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/youglin-dev/aha-loop/vision-builder"><img src="https://agentmods.dev/badge/skills/youglin-dev/aha-loop/vision-builder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,777 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00040	$0.01777
Opus 5.5	$0.00016	$0.00711
Sonnet 5.5	$0.00008	$0.00355
Haiku 4.5	$0.00004	$0.00178

Measured 2mo ago against content hash ecebf5f952cb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

vision-builder scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/vision-builder/SKILL.md · 358 lines

How it starts

The opening of the file, as written. The whole thing — 358 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Vision Builder Skill

Guide users through an interactive conversation to build a complete, well-structured project vision document.

The Job

Detect when user has a vague project idea
Engage in structured dialogue using AskQuestion tool
Progressively refine the vision through targeted questions
Generate a complete project.vision.md document
Validate the vision is actionable

When to Use

Activate this skill when user says things like:

"I have an idea for..."
"Help me build a project vision"
"I want to create something that..."
"Build a project vision for me"
"I have an idea..."
Any vague project description without clear structure

Conversation Flow

Phase 1: Project Type

Start by understanding what kind of project this is.

Question: What type of project is this?

Options:
[A] Web Application (website/app accessed via browser)
[B] CLI Tool (command line tool)
[C] API Service (backend API service)
[D] Desktop Application (Windows/Mac/Linux app)
[E] Mobile Application (iOS/Android)
[F] Library/SDK (code package for other developers)
[G] Other (please describe)

If user selects [G], follow up with open-ended question.

Phase 2: Core Problem

Understand the problem being solved.

Question: What problem does this project solve?

Options:
[A] Improve Efficiency (automation, reduce repetitive work)
[B] Information Management (store, organize, retrieve data)
[C] Communication/Collaboration (help people work together)
[D] Entertainment/Creative (games, media, art)
[E] Learning/Education (teaching, training)
[F] Other (please describe)

Allow multiple selections: true

Follow up: "Can you describe the problem you want to solve in more detail?"

Phase 3: Target Users

Identify who will use the product.

Question: Who will use this product?

Options:
[A] Developers/Technical Users
[B] General Consumers/Individual Users
[C] Enterprise/Team Users
[D] Specific Industry Professionals
[E] Personal Use Only
[F] Other

Allow multiple selections: true

Read the full file on GitHub · 358 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 358 lines · 40 tokens per session scan A ecebf5f952cb

Subscribe to this mod's changes

vision-builder is a skill published in the GitHub repository YougLin-dev/Aha-Loop (178 stars, last pushed 9mo ago), licensed MIT. It adds 40 tokens to every session and 1,777 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Planning

vision-builder next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
vision-builderYougLin-dev/Aha-Loop	Skill	178	9mo ago	MIT	A	40	Claude Code, Codex
imagegenopenai/codex	Skill	133k	yesterday	Apache-2.0	A	113	Codex
playwright-climicrosoft/playwright	Skill	99k	yesterday	Apache-2.0	A	19	Claude Code
local-ai-agentsmicrosoft/ai-agents-for-beginners	Skill	79k	4d ago	MIT	A	200	Claude Code, Codex
systematic-debuggingobra/superpowers	Skill	313k	3d ago	MIT	A	21	Claude Code
next-cache-components-adoptionvercel/next.js	Skill	143k	today	MIT	A	95	Claude Code
next-partial-prefetching-adoptionvercel/next.js	Skill	143k	today	MIT	A	103	Claude Code

Aha-Loop: Skill for Claude Code