doc-visual-direction

Define a product's visual language for UI discovery and design documentation.

Updated May 19, 2026
One-click install
npx skills add https://github.com/TimeKast/AgendaInteligente --skill doc-visual-direction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-visual-direction
Source: https://github.com/TimeKast/AgendaInteligente/tree/main/.claude/skills/doc-visual-direction
Command: npx skills add https://github.com/TimeKast/AgendaInteligente --skill doc-visual-direction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents products from shipping with generic, mismatched UI by choosing a clear visual language early in discovery and documentation.

Core Features & Use Cases

  • Visual language decision: selects a product posture (precision/warmth/density/aspiration) and maps it to a specific skin family recommendation.
  • System-level guidance: defines surface behavior (base/panel/overlay), typography posture, iconography tier rules, and motion profile so the UI stays consistent.
  • Design risk control: lists anti-patterns to avoid and provides an optional fallback skin when the first choice is not viable.

Quick Start

Use the doc-visual-direction skill to write the visual direction section that will feed project/project/planning/15_DESIGN.md.

Frequently Asked Questions about doc-visual-direction

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

FAQPage Schema
How do I define a visual language for my product before building UI?

To define a visual language, select a skin family, surface rules, typography posture, iconography system, and motion profile. This establishes product identity and prevents shipping generic, mismatched UI during the discovery phase.

What is the best way to document UI design direction for a project kickoff?

Documenting UI design direction involves defining the product's visual posture, including density and trust-vs-novelty stance. It produces ordered outputs with anti-pattern constraints to feed directly into the project's design documentation file.

When do I need to establish a design system and product identity for my application?

You need to establish a design system when your product lacks identity or the UI feels generic. It applies to kickoff, discovery, and design-audit scenarios where choosing a coherent visual language early prevents mismatched interfaces.

How do I choose typography and surface rules for a new design system?

Choosing typography and surface rules requires mapping a product posture—precision, warmth, density, or aspiration—to a specific skin family. This defines base, panel, and overlay behaviors alongside iconography tier rules for consistent UI.

Can I specify anti-patterns and fallback options when setting visual direction?

Yes, setting visual direction includes listing anti-patterns to avoid and providing an optional fallback skin. This design risk control ensures your UI remains consistent if the first visual language choice proves not viable.