ui-visual-calibration

Translate aesthetic preferences into concrete visual decisions for UI specifications.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/ThorStarlord/interface-skills --skill ui-visual-calibration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-visual-calibration
Source: https://github.com/ThorStarlord/interface-skills/tree/main/skills/ui-visual-calibration
Command: npx skills add https://github.com/ThorStarlord/interface-skills --skill ui-visual-calibration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents mental-picture drift by translating vague design taste and product references into concrete, traceable visual decisions before any blueprint work starts.

Core Features & Use Cases

  • Aesthetic-to-Structure Translation: Converts words like clean, modern, minimal, and sleek into a locked set of visual dimensions (layout archetype, density, shape language, surface style, and palette guidance).
  • Spec Recovery Support: Captures Observed vs. Target visual language so an existing UI can be reconciled into an intentional target without silent changes.
  • Audit-Friendly Output: Produces a visual-calibration.md with a translation log, confirmed vs. assumed decisions, and explicit open questions to stop downstream conflicts.

Quick Start

Use ui-visual-calibration when a user says “make it feel like Notion but cleaner,” and generate visual-calibration.md that fixes layout, density, shape language, surface style, and palette guidance in one traceable contract.

Frequently Asked Questions about ui-visual-calibration

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

FAQPage Schema
How do I translate vague aesthetic preferences like 'clean and modern' into concrete UI specifications?

Visual calibration translates vague aesthetic preferences into a locked set of visual dimensions including layout archetype, density, shape language, surface style, and palette guidance to prevent mental-picture drift before blueprint work starts.

What is the best way to recover and reconcile an existing UI's visual language without silent changes?

Spec recovery captures Observed vs. Target visual language so an existing UI can be reconciled into an intentional target without silent changes, using a traceable contract to align your design system decisions.

How do I create a visual contract for traceable UI styling decisions?

You generate a visual-calibration.md file that satisfies traceability requirements by including a Translation Log with confirmed vs. assumed markers and explicit open questions to stop downstream conflicts.

Can I fix layout archetype and shape language from product references like 'make it feel like Notion'?

Yes, aesthetic-to-structure translation converts product references into exactly one resolved value for each visual dimension, fixing layout archetype, density, shape language, surface style, and palette guidance.

When do I need visual calibration for my design system workflow?

You need visual calibration when starting layout and styling work, or when recovering an existing UI without a visual-calibration sheet, ensuring all aesthetic translation decisions are documented and auditable.

How does the translation log handle assumed vs confirmed styling decisions in UI specifications?

The translation log explicitly marks each visual decision as confirmed or assumed, resolving exactly one value per dimension while documenting open questions to prevent silent drift during spec recovery.