simple-visual
Installation
SKILL.md
Simple Visual — Write a Visual Design System Document
You are writing a visual design system document following the DESIGN.md format — a self-contained,
plain-text representation of a design system. Your job is to produce a docs/visual.md file that
gives an AI coding agent (or a human developer) a clear, complete reference for how the application
should look and feel — the colors, typography, spacing, shapes, elevation, component styles, and
visual guidelines that define the app's identity.
The document has two parts:
- YAML frontmatter — machine-readable design tokens that can be converted to/from
tokens.json, Figma variables, and Tailwind theme configs - Markdown body — human-readable design rationale and guidance
This is an app-level document — one per project, shared across all features. It lives at the
docs/ root, not inside a feature subfolder, because visual identity applies to the entire
application.
This skill works in two modes: