hart-agency-design

Align Hart Agency UI work with the canonical design system and token source.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/rafaeelricco/Hartopsprototype --skill hart-agency-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hart-agency-design
Source: https://github.com/rafaeelricco/Hartopsprototype/tree/main/.claude/skills/hart-agency-design
Command: npx skills add https://github.com/rafaeelricco/Hartopsprototype --skill hart-agency-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill prevents Hart Agency UI work from drifting away from the canonical design system and token truth, while still letting you build or review screens quickly using the right layout and component patterns.

Core Features & Use Cases

  • UI build + review for Hart’s two surfaces: Supports Hart Web Platforms and the Brand Ambassador Mobile App, including screens, pages, and components.
  • Token-first conflict detection: Flags conflicts between the design system, mental model, and prototype sources so the output stays consistent with globals.css and the design-system rules.
  • Guided intake and plan-before-build: Runs a short intake to define scope and surface, then proposes a plan before making changes.
  • Design-system extension support: Helps extend the design system by clarifying what’s being added (token, primitive, or pattern) and where it should live.

Quick Start

Ask the hart-agency-design skill to “Review this Hart Web Platforms screen for design-system compliance and propose the exact token-based fixes.”

Frequently Asked Questions about hart-agency-design

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

FAQPage Schema
How do I align my front-end UI with a canonical design system during component building?

To align front-end UI with a canonical design system, enforce token-only color usage via globals.css, reuse component primitives, apply 4px spacing and radius scales, and detect conflicts between prototype and design sources. A plan-first workflow proposes fixes before implementation.

What is the best way to review UI for design system compliance and token alignment?

Reviewing UI for design system compliance involves checking token alignment against a live token source of truth, flagging conflicts across mental model and prototype sources, and proposing exact token-based fixes to maintain consistency with globals.css rules.

How does token-first conflict detection work when extending a design system?

Token-first conflict detection flags inconsistencies between the design system, mental model, and prototype sources before extending it. It clarifies whether you are adding a token, primitive, or pattern, ensuring the output stays consistent with globals.css and existing design-system rules.

Can I use this UI review approach for both web platforms and mobile apps?

Yes, this UI review and component building approach supports both Hart Web Platforms and the Brand Ambassador Mobile App. It handles screens, pages, components, and layouts driven by prototype and mental-model context across both surfaces.

Why should I run a guided intake before building UI components?

Running a guided intake before building UI components defines the project scope and target surface. It enforces a plan-before-build workflow that proposes structural changes and token-based fixes, preventing design system drift during rapid UI development.

Do I need to use 4px spacing and radius scales for design system token alignment?

Yes, applying 4px spacing and radius scales is required for design system token alignment. Enforcing these specific scales alongside token-only color usage from globals.css ensures that built components and layouts match the canonical design system.