design

Generates wireframes and component specs for new UI features using a token-based design system.

3|Updated May 2, 2026
One-click install
npx skills add https://github.com/JuanTrujilloDev/agent-config-template --skill design-juantrujillodev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/JuanTrujilloDev/agent-config-template/tree/main/codex/skills/design
Command: npx skills add https://github.com/JuanTrujilloDev/agent-config-template --skill design-juantrujillodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new UI feature without a shared design system leads to inconsistent colors, ad-hoc components, and rework. This Skill structures the design phase so wireframes and component specs are produced from a single semantic token source before any code is written. ## Core Features & Use Cases - Design system bootstrap: Reads or creates docs/design-system/MASTER.md and tokens.json with ten standard sections covering colors, typography, spacing, and accessibility. - Stack-native theme sync: Maps semantic tokens to one code target such as CSS custom properties, Flutter ThemeData, Unity ScriptableObject, or JSON, and records SHA-256 hashes in tokens.lock.json. - Gated design workflow: Spawns a ui-designer role to produce wireframes and component specs, then pauses for user approval before handing off to frontend implementation. - Use Case: You want to add a settings page to a Flutter app. Run the design workflow to load the brand tokens, generate wireframes and component specs, approve them, and hand off to implementation with a consistent theme. ## Quick Start Ask the agent to run the design workflow for your feature, for example: start the design workflow for a new dashboard settings page.

Frequently Asked Questions about design

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

FAQPage Schema
How do I start the design workflow for a new UI feature?▼

Invoke the design command with a feature description, such as /design add a settings page. The workflow gathers requirements, loads the design system, generates wireframes and component specs, then pauses for your approval before implementation.

What files does the design system use for tokens?▼

The workflow reads docs/design-system/MASTER.md as the human-readable source and docs/design-system/tokens.json as the machine-readable value source. Page-level overrides live in docs/design-system/pages/<page>.md, and every spec cites semantic tokens.

Does the design workflow support Flutter or Unity projects?▼

Yes. Token synchronization maps to one stack-native target: CSS custom properties for web, ThemeExtension or ThemeData for Flutter, ScriptableObject for Unity, a native theme facility for desktop, or JSON-only for unknown stacks.

What is tokens.lock.json used for?▼

tokens.lock.json records schema_version, adapter, source and target paths, and their SHA-256 hashes. It verifies that the generated theme target exactly matches the token source so drift between design tokens and code is detectable.

What happens if the design system files are missing?▼

The workflow creates MASTER.md and tokens.json from template sections, leaving TODO markers where values cannot be inferred from the codebase. Every TODO used by the feature must be resolved before implementation begins.