ui-to-ascii

Convert UI design screenshots into ASCII layout diagrams with numbered annotation tables.

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/HACK-WU/skills --skill ui-to-ascii-hack-wu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-to-ascii
Source: https://github.com/HACK-WU/skills/tree/main/skills/ui-to-ascii
Command: npx skills add https://github.com/HACK-WU/skills --skill ui-to-ascii-hack-wu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? UI design mockups and screenshots are only readable by vision-capable models, are too large for version control, and cannot be diffed or reviewed as text. This Skill converts them into plain-text ASCII wireframes with structured annotation tables so any model or teammate can read, diff, and commit the design. ## Core Features & Use Cases - Image-to-ASCII conversion: A vision-capable AI reads the design and reproduces component positions, nesting, and relative proportions as box-drawing ASCII art, saved to .ui-ascii/{slug}.md. - Annotation extraction: Sizes, spacing, colors, fonts, and interactions visible on the mockup are captured as numbered anchors plus a structured annotation table, with uncertain values marked [待确认] instead of guessed. - Multi-screen flows: Multiple screens are organized into one file with chapters and a Mermaid flowchart linking navigation between screens. - Description mode: Generate an ASCII sketch directly from a text description of an interface, output to the conversation without writing files. - Use Case: Paste a login page mockup and ask to archive it as text; the Skill produces a versionable Markdown file with the ASCII layout and an annotation table that a non-vision model can later use to implement the page. ## Quick Start Paste a UI design screenshot and ask the AI to convert this design into an ASCII text layout saved as a Markdown file.

Frequently Asked Questions about ui-to-ascii

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a UI design screenshot to ASCII text?

Paste the design image to a vision-capable AI and request the conversion. The Skill identifies regions and components, draws a box-drawing ASCII layout, extracts visible annotations into a numbered table, and saves the result to .ui-ascii/{slug}.md.

How to generate an ASCII wireframe from a text description?

Describe the interface in text, such as "draw an ASCII sketch of a login page". The Skill uses description mode to produce the ASCII layout directly in the conversation without writing files, applying reasonable defaults for unspecified standard components.

Can ASCII UI conversion work without a vision-capable model?

No. Image-to-ASCII conversion requires the AI to actually see the image content. Without vision capability the Skill stops and asks you to use a vision model or switch to text-description mode instead of guessing the layout.

Where are the converted ASCII design files stored?

Converted designs are written to the .ui-ascii/ directory in the project root, named by a kebab-case slug such as login-page.md. Multi-screen flows become a single file with per-screen chapters and a Mermaid flowchart.

What happens when design annotations are unclear or missing?

Values not visible in the image are never guessed. They are marked as [待确认] (to be confirmed) in the annotation table and collected in a pending-items section at the end of the file for the user to fill in.