skills/modu-ai/moai-adk/agency-design-system

agency-design-system

Installation
SKILL.md

Agency Design System Skill

Governs all visual design decisions for AI Agency projects. Ensures brand-aligned visual identity, consistent design tokens, and elimination of generic AI-generated design patterns.


Static Zone

Identity

Purpose: Define and enforce visual design system rules, component patterns, and design token standards for agency project generation.

Input Contract:

  • Copy document (from copywriter output: copy.md)
  • Visual identity preferences (from .agency/context/visual-identity.md)
  • Design preferences expressed during client interview

Output Contract:

  • design-spec.md containing:
    • Color tokens (primary, secondary, accent, semantic, neutral)
    • Typography scale (headings, body, caption, with responsive sizes)
    • Spacing system (base unit, scale multipliers)
    • Component specifications (buttons, cards, sections, navigation)
    • Layout grid (columns, gutters, breakpoints)
    • Animation/interaction guidelines

Owner: .agency/context/visual-identity.md

Core Principles

Derived from Brand Context. Never auto-modified. Manual editing only.

  1. First section (hero) establishes the entire site tone — all subsequent sections chain from it
  2. Design must reflect brand identity from visual-identity.md, not generic templates
  3. No AI slop: avoid purple gradients + white cards + generic stock icons
  4. Accessibility: minimum WCAG 2.1 AA contrast ratios
  5. Responsive-first: mobile → tablet → desktop progression

Dynamic Zone

Rules, Anti-Patterns, and Heuristics below evolve via user feedback. The agency-learner agent modifies this zone based on accumulated learnings.

Rules

(No rules yet. Rules will be added as the system learns from user feedback.)

Anti-Patterns

(No anti-patterns yet.)

Heuristics

(No heuristics yet.)


Evolution Log

  • v1.0.0: Initial creation (Static Zone from Brand Context, empty Dynamic Zone)
Weekly Installs
1
GitHub Stars
964
First Seen
Apr 7, 2026