design-consultation

Generates a complete design system proposal and writes DESIGN.md for a project.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill design-consultation-trobias
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-consultation
Source: https://github.com/trobias/portfolio-nextjs-v2/tree/main/.agents/skills/design-consultation
Command: npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill design-consultation-trobias

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new product's UI without a design system leads to inconsistent fonts, ad-hoc colors, and generic AI-slop aesthetics. This Skill runs a structured design consultation that researches the product context, proposes a coherent design system, previews it visually, and records the result as a DESIGN.md source of truth. ## Core Features & Use Cases - Complete design system proposal: Covers aesthetic direction, decoration level, layout, color palette with hex values, typography roles, spacing scale, and motion approach, with explicit SAFE/RISK breakdowns so the product keeps category literacy while gaining a distinct identity. - Visual preview generation: Produces AI-rendered mockup variants with a browser-based comparison board and feedback loop, or falls back to a self-contained HTML preview page with font specimens, palette swatches, and realistic product mockups. - DESIGN.md authoring: Writes a structured DESIGN.md (product context, typography, color, spacing, layout, motion, decisions log) and appends design-system rules to CLAUDE.md so future UI work stays consistent. - Use Case: You are starting a new web app and have no brand guidelines. Invoke the skill, answer a few product-context questions, review three visual directions on the comparison board, and ship a DESIGN.md your whole team codes against. ## Quick Start Ask the assistant to run the design-consultation skill to create a design system and DESIGN.md for your project.

Frequently Asked Questions about design-consultation

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

FAQPage Schema
How do I create a design system for a new web project?▼

Invoke the design-consultation skill, which interviews you about product context, proposes a full system covering aesthetic, typography, color, spacing, layout, and motion, then writes the approved result to DESIGN.md in your repo root.

What does the design preview step generate?▼

It generates either AI-rendered mockup variants shown on a browser comparison board with a feedback loop, or a self-contained HTML preview page with font specimens, color swatches, sample UI components, and a light/dark toggle.

Can I adjust individual parts of the design proposal?▼

Yes. Phase 4 drill-downs let you revise fonts, colors, aesthetic direction, layout, spacing, or motion individually. After each change the skill re-checks coherence with the rest of the system and flags mismatches without blocking your choice.

Does the skill work in plan mode or headless sessions?▼

Yes. In plan mode it writes the proposed DESIGN.md content into the plan file instead of the repo. In headless sessions it blocks when interactive questions are unavailable; in spawned sessions it auto-chooses recommended options.

What fonts does the skill avoid recommending?▼

It blacklists fonts like Papyrus, Comic Sans, and Lobster, and treats overused fonts such as Inter, Roboto, and Space Grotesk as non-recommendable unless you explicitly request them, to avoid generic convergent design.