- Home
- Skills
- Frontend & Web Apps
- visual architect
visual architect
Translate website ideas into build-ready design specifications and tokens through visual previews and a decision ledger.
Free
Works with the AI Agents you already use
visual architect
Example session with this skill installed
/visual-architect create a dark-themed dashboard for a developer metrics tool. Direct me through the process.
- Read your context and instructions
- Compiled the visual architect
- Generated the UI component
I have initialized the project brief for the Developer Metrics Dashboard. I am operating in
I'll direct it mode to capture your specific intent.
Initial Design Direction: Dark Developer Metrics
I have created the initial project files in docs/design/ and mapped out the core visual identity. Below are the primary directions based on a "Dark Developer" aesthetic.
| Attribute | Direction A: Terminal Glow | Direction B: Modern Slate |
|---|---|---|
| Primary Color | #00FF41 (Matrix Green) | #6366F1 (Indigo Neon) |
| Background | #080808 (True Black) | #0F172A (Deep Navy) |
| Typography | JetBrains Mono / Inter | Roboto Mono / Geist |
| Surface | High contrast, thin borders | Soft blurs, glassmorphism |
| Motion | Snap-to-grid, instant | Fluid, eased transitions |
Decision Ledger Status
- D-001 (Theme): Assumption — needs validation (Dark Mode)
- D-002 (Audience): Assumption — needs validation (Software Engineers)
- D-003 (Mode): Confirmed by user (Direct Input)
Design Preview (Direction A: Terminal Glow)
<div style="background:#080808; padding:20px; border:1px solid #00FF41; color:#00FF41; font-family:monospace;">
<div style="font-size:12px; opacity:0.7;">git_commit_frequency</div>
<div style="font-size:24px; font-weight:bold;">142 / day</div>
<div style="width:100%; height:4px; background:#111; margin-top:8px;">
<div style="width:70%; height:100%; background:#00FF41;"></div>
</div>
</div>
Next steps
- Choose between Direction A (High-contrast terminal) or Direction B (Modern glassmorphism).
- Define the "Signature Move" (e.g., a specific hover effect or data visualization style).
- Review the generated
docs/design/project-brief.md.
visual-architect.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Design-to-code handoffs often fail because of vague visual requirements and missing tokens. Developers spend hours guessing at spacing, motion curves, and typography intent, only to have to refactor when the result doesn't match the vision. This skill bridges that gap by acting as a creative director that translates ideas into build-ready specifications.
What it does
- Visual Previews generates rendered options for layouts and palettes so you can see before you decide.
- Decision Ledger tracks every design choice with statuses like
ConfirmedorDelegatedto prevent scope creep and rework. - Design Tokens exports CSS variables for colors, typography, and spacing that map directly to your components.
- Handoff Generation produces a structured prompt and specification for coding agents to build from.
- Code Audits reviews existing sites to refine responsiveness, motion, and interaction patterns.
How it works
- Initialize a project brief using
/visual-architect createto define the core identity and scope. - Direct or Delegate design choices using visual previews to confirm themes, layouts, and typography.
- Refine specific areas like
motionorresponsiveto add depth and interaction logic. - Handoff by generating a
builder-handoff-prompt.mdcontaining all validated decisions and token paths.
Frameworks & tools
Outputs standard design tokens as .css files and project documentation as Markdown. Compatible with any IDE or agent that reads local file structures.
Why this beats prompting it yourself
Generic prompts yield generic "SaaS-blue" interfaces. This skill enforces a "Distinctive by default" rule, maintains a persistent ledger of choices, and provides the visual evidence needed to ensure a coding agent doesn't have to guess.
Use cases
- Drafting a build-ready specification for a new landing page.
- Auditing an existing UI to improve accessibility and interaction design.
- Creating a design system from scratch with standardized tokens.
- Refactoring a site's layout or motion design based on visual previews.
Known limitations
Requires file system access to docs/design/ for persistent logging. Design previews require an environment capable of rendering HTML.
Requires write access to docs/design/ in your repository. Design previews require a viewer capable of rendering HTML snippets.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed today
- Free with an Agensi account