ui-pro-forge-cli 2.5.0

package/assets/skills/design/references/logo-prompt-engineering.md

@@ -0,0 +1,158 @@
+# Logo AI Prompt Engineering
+
+## Core Prompt Structure
+
+```
+Professional logo design for [brand/industry]:
+[Visual description]
+Style: [style keywords]
+Colors: [color palette]
+Requirements: [technical specs]
+```
+
+## Effective Keywords by Style
+
+### Minimalist
+```
+minimalist, clean lines, simple geometric shapes, essential elements only,
+high white space, flat design, single color, modern, uncluttered,
+negative space, subtle, refined
+```
+
+### Vintage/Retro
+```
+vintage, retro, heritage, established, classic, nostalgic, weathered,
+distressed texture, badge style, hand-lettered, craft, artisan,
+sepia tones, muted colors, aged paper effect
+```
+
+### Luxury/Premium
+```
+luxury, elegant, sophisticated, premium, refined, exclusive, high-end,
+gold accents, metallic, minimal, tasteful, upscale, prestige,
+thin lines, serif typography, foil effect
+```
+
+### Modern/Tech
+```
+modern, innovative, digital, tech-forward, sleek, futuristic,
+gradient colors, geometric, abstract, dynamic, cutting-edge,
+clean sans-serif, circuit-like, data visualization
+```
+
+### Playful/Fun
+```
+playful, fun, colorful, friendly, approachable, cheerful, whimsical,
+bouncy, rounded shapes, bright colors, cartoon-like, energetic,
+bubbly, hand-drawn elements
+```
+
+### Organic/Natural
+```
+organic, natural, flowing, botanical, eco-friendly, sustainable,
+earth tones, leaf elements, hand-drawn, imperfect lines, growth,
+green, nature-inspired, biophilic
+```
+
+## Negative Prompts (What to Avoid)
+
+Always include to prevent unwanted results:
+```
+NOT: photorealistic, 3D render with realistic textures, photograph,
+stock image, clip art, multiple logos, busy background, text watermarks,
+low quality, blurry, distorted, complex detailed patterns
+```
+
+## Industry-Specific Prompts
+
+### Tech Startup
+```
+Modern tech company logo, abstract geometric mark, gradient blue to purple,
+clean minimal design, innovative feel, scalable vector style,
+professional quality, silicon valley aesthetic
+```
+
+### Healthcare
+```
+Healthcare medical logo, clean professional design, cross or heart symbol,
+calming blue and teal colors, trustworthy appearance, caring feel,
+simple scalable mark, HIPAA-appropriate conservative style
+```
+
+### Restaurant/Food
+```
+Restaurant logo, warm inviting colors, appetizing feel, vintage badge style,
+chef or utensil iconography, friendly welcoming design, rustic charm,
+established look, readable at small sizes
+```
+
+### Fashion Brand
+```
+Fashion brand logo, elegant sophisticated wordmark, luxury aesthetic,
+black and gold color scheme, thin refined typography, haute couture feel,
+minimal exclusive design, high-end positioning
+```
+
+### Eco/Sustainable
+```
+Eco-friendly sustainable brand logo, organic natural elements, leaf motif,
+earth green and brown colors, growth symbolism, environmental awareness,
+clean modern yet natural feel, recyclable-look design
+```
+
+## Technical Requirements to Include
+
+### Scalability
+```
+vector-style, scalable at any size, clear silhouette,
+works as favicon, recognizable small scale, simple shapes
+```
+
+### Versatility
+```
+works on light and dark backgrounds, single color version possible,
+horizontal and stacked layouts, brand mark can stand alone
+```
+
+### Quality
+```
+professional quality, print-ready, high resolution,
+crisp edges, balanced composition, centered design
+```
+
+## Prompt Templates
+
+### Quick Generation
+```
+Professional [industry] logo, [style] design, [color] colors,
+clean modern aesthetic, scalable vector style
+```
+
+### Detailed Brief
+```
+Professional logo design for [brand name], a [industry] company.
+
+Visual style: [style keywords]
+Primary colors: [hex codes]
+Mood: [emotional keywords]
+Symbols: [iconography hints]
+
+Technical: Vector-style illustration, scalable, works in single color,
+centered on plain background, no text unless specified.
+```
+
+### Variation Request
+```
+Alternative version of [brand] logo:
+Keep: [elements to preserve]
+Change: [elements to modify]
+Style direction: [new style keywords]
+```
+
+## Common Pitfalls
+
+1. **Too detailed** - AI generates complexity; request "simple"
+2. **Unclear background** - Specify "plain white background"
+3. **Text issues** - AI struggles with text; generate mark separately
+4. **Wrong aspect** - Specify "1:1 square" or "horizontal"
+5. **Realistic style** - Add "illustration, vector-style, not photorealistic"

package/assets/skills/design/references/logo-style-guide.md

@@ -0,0 +1,109 @@
+# Logo Style Guide
+
+## Core Logo Types
+
+### 1. Wordmark (Logotype)
+Text-only logo using custom typography.
+- **Best for:** Established brands, distinctive names
+- **Examples:** Google, Coca-Cola, FedEx
+- **Typography:** Custom letterforms, unique kerning
+- **Tip:** Name must be memorable and pronounceable
+
+### 2. Lettermark (Monogram)
+Initials or abbreviated letters.
+- **Best for:** Long company names, professional firms
+- **Examples:** IBM, HBO, NASA
+- **Typography:** Bold geometric sans-serif
+- **Tip:** Works well for brands with 2-4 letter abbreviations
+
+### 3. Pictorial Mark (Brand Mark)
+Standalone icon or symbol.
+- **Best for:** Global brands with recognition
+- **Examples:** Apple, Twitter, Target
+- **Design:** Simple, scalable, memorable shape
+- **Tip:** Requires brand equity to work alone
+
+### 4. Abstract Mark
+Non-representational geometric shapes.
+- **Best for:** Tech companies, differentiating brands
+- **Examples:** Pepsi, Airbnb, Spotify
+- **Design:** Unique shape conveying brand values
+- **Tip:** Can represent complex ideas simply
+
+### 5. Mascot
+Character representing the brand.
+- **Best for:** Family brands, sports teams, food
+- **Examples:** KFC, Pringles, Michelin
+- **Design:** Friendly, expressive, versatile
+- **Tip:** Can evolve with brand while maintaining recognition
+
+### 6. Emblem
+Symbol enclosed within a shape.
+- **Best for:** Traditional brands, organizations
+- **Examples:** Starbucks, Harley-Davidson, NFL
+- **Design:** Badge, seal, or crest style
+- **Tip:** May have scalability challenges
+
+### 7. Combination Mark
+Icon + text in unified design.
+- **Best for:** New brands, versatile applications
+- **Examples:** Burger King, Lacoste, Doritos
+- **Design:** Lockup with flexible arrangements
+- **Tip:** Most versatile, can separate elements later
+
+## Aesthetic Styles
+
+### Minimalist
+- Clean lines, essential elements only
+- High white space, simple geometry
+- Limited color palette (1-2 colors)
+- **Use:** Tech, professional services, modern brands
+
+### Vintage/Retro
+- Nostalgic, heritage feel
+- Distressed textures, muted colors
+- Script or slab serif typography
+- **Use:** Craft brands, artisan products
+
+### Luxury/Premium
+- Elegant, refined aesthetic
+- Gold, black, white color scheme
+- Thin serifs or sophisticated sans
+- **Use:** Fashion, jewelry, high-end services
+
+### Geometric
+- Mathematical precision
+- Circles, triangles, squares
+- Perfect symmetry
+- **Use:** Architecture, tech, modern brands
+
+### Organic/Natural
+- Flowing, imperfect lines
+- Earth tones, natural colors
+- Hand-drawn feel
+- **Use:** Eco brands, wellness, organic products
+
+### Gradient/Modern
+- Color transitions, vibrant palettes
+- Dimensional depth
+- Contemporary feel
+- **Use:** Apps, tech startups, digital products
+
+## Style Selection Matrix
+
+| Brand Type | Primary Style | Secondary Options |
+|------------|---------------|-------------------|
+| Tech Startup | Minimalist, Abstract | Geometric, Gradient |
+| Law Firm | Wordmark, Emblem | Lettermark |
+| Restaurant | Mascot, Badge | Vintage, Combination |
+| Fashion | Wordmark, Luxury | Monogram, Line Art |
+| Healthcare | Professional, Line Art | Abstract, Combination |
+| Non-Profit | Combination, Emblem | Organic, Hand-Drawn |
+
+## Scalability Checklist
+
+- [ ] Recognizable at 16x16 pixels (favicon)
+- [ ] Clear at business card size
+- [ ] Works in single color
+- [ ] Maintains clarity in black/white
+- [ ] No tiny details that disappear when scaled

package/assets/skills/design/references/slides-copywriting-formulas.md

@@ -0,0 +1,84 @@
+# Copywriting Formulas
+
+25 formulas for persuasive slide copy.
+
+## Core Formulas
+
+### PAS (Problem-Agitate-Solution)
+**Use:** Problem slides, pain points
+**Components:** Problem → Agitate → Solution
+**Template:** "[Pain point]? Every [time frame], [consequence]. [Solution] fixes this."
+
+### AIDA (Attention-Interest-Desire-Action)
+**Use:** CTAs, closing slides
+**Components:** Attention → Interest → Desire → Action
+**Template:** "[Bold statement]. [Benefit detail]. [Social proof]. [CTA]."
+
+### FAB (Features-Advantages-Benefits)
+**Use:** Feature slides, product showcases
+**Components:** Feature → Advantage → Benefit
+**Template:** "[Feature] lets you [advantage], so you can [benefit]."
+
+### Cost of Inaction
+**Use:** Agitation slides, urgency
+**Components:** Status Quo → Loss → Time Decay
+**Template:** "Without [solution], you're losing [amount] every [timeframe]."
+
+### Before-After-Bridge
+**Use:** Transformation slides, case studies
+**Components:** Before → After → Bridge
+**Template:** "[Pain point before]. [Desired state after]. [Your solution] is the bridge."
+
+## Formula-to-Slide Mapping
+
+| Slide Type | Primary Formula | Emotion |
+|------------|-----------------|---------|
+| Title/Hook | AIDA, Hook | curiosity |
+| Problem | PAS, Agitate | frustration |
+| Cost/Risk | Cost of Inaction | fear |
+| Solution | FAB, BAB | hope |
+| Features | FAB | confidence |
+| Traction | Proof Stack | trust |
+| Social Proof | Testimonial | trust |
+| Pricing | Value Stack | confidence |
+| CTA | AIDA, Urgency | urgency |
+
+## Headline Patterns
+
+### Power Words
+- "Stop [bad thing]"
+- "Get [desired result] in [timeframe]"
+- "The [adjective] way to [action]"
+- "Why [audience] choose [product]"
+- "[Number] ways to [achieve goal]"
+
+### Contrast Patterns
+- "[Old way] is dead. Meet [new way]."
+- "Don't [bad action]. Instead, [good action]."
+- "From [pain point] to [benefit]."
+
+### Social Proof Patterns
+- "[Number]+ [users/companies] trust [product]"
+- "Join [notable company] and [notable company]"
+- "As seen in [publication]"
+
+## Search Commands
+
+```bash
+# Find formula for slide type
+python .claude/skills/design-system/scripts/search-slides.py "problem agitation" -d copy
+
+# Get emotion-appropriate formula
+python .claude/skills/design-system/scripts/search-slides.py "urgency cta" -d copy
+```
+
+## Quick Reference
+
+| Need | Use Formula |
+|------|------------|
+| Create urgency | Cost of Inaction, Scarcity |
+| Build trust | Social Proof, Testimonial |
+| Show value | FAB, Value Stack |
+| Drive action | AIDA, CTA |
+| Tell story | BAB, Story Arc |
+| Present data | Proof Stack |

package/assets/skills/design/references/slides-create.md

@@ -0,0 +1,4 @@
+Invoke `slides` skill to create persuasive HTML slides using design tokens, Chart.js, and the slide knowledge database.
+
+## Task
+<task>$ARGUMENTS</task>

package/assets/skills/design/references/slides-html-template.md

@@ -0,0 +1,295 @@
+# HTML Slide Template
+
+Complete HTML structure with navigation, tokens, and Chart.js integration.
+
+## Base Structure
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Presentation Title</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>
+    <style>
+        /* Paste embed-tokens.cjs output here */
+        :root {
+            --color-primary: #FF6B6B;
+            --color-background: #0D0D0D;
+            /* ... more tokens */
+        }
+
+        /* Base slide styles */
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            background: var(--color-background);
+            color: #fff;
+            font-family: var(--typography-font-body, 'Inter', sans-serif);
+            overflow: hidden;
+        }
+
+        /* 16:9 Aspect Ratio Container (desktop) */
+        .slide-deck {
+            position: relative;
+            width: 100vw;
+            height: 100vh;
+            overflow: hidden;
+        }
+
+        @media (min-width: 769px) {
+            .slide-deck {
+                /* Lock to 16:9 — letterbox if viewport ratio differs */
+                max-width: calc(100vh * 16 / 9);
+                max-height: calc(100vw * 9 / 16);
+                margin: auto;
+                position: absolute;
+                inset: 0;
+            }
+        }
+
+        .slide {
+            position: absolute;
+            width: 100%; height: 100%;
+            display: flex;
+            flex-direction: column;
+            justify-content: center;
+            align-items: center;
+            text-align: center;
+            padding: 60px;
+            opacity: 0;
+            visibility: hidden;
+            transition: opacity 0.4s;
+            background: var(--color-background);
+            overflow: hidden; /* Prevent content overflow */
+        }
+
+        .slide.active { opacity: 1; visibility: visible; }
+
+        /* Slide inner wrapper — constrains content within safe area */
+        .slide-content {
+            width: 100%;
+            max-width: 100%;
+            max-height: 100%;
+            overflow: hidden;
+            display: flex;
+            flex-direction: column;
+            justify-content: center;
+            align-items: center;
+            gap: 16px;
+        }
+
+        /* Typography */
+        h1, h2 { font-family: var(--typography-font-heading, 'Space Grotesk', sans-serif); }
+        .slide-title {
+            font-size: clamp(32px, 6vw, 80px);
+            background: var(--primitive-gradient-primary, linear-gradient(135deg, #FF6B6B, #FF8E53));
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+            line-height: 1.1;
+        }
+
+        /* ===== RESPONSIVE BREAKPOINTS ===== */
+
+        /* Tablet (portrait) */
+        @media (max-width: 768px) {
+            .slide { padding: 32px 24px; }
+            .slide-title { font-size: clamp(28px, 5vw, 48px); }
+            h2 { font-size: clamp(20px, 4vw, 32px); }
+            p, li { font-size: clamp(14px, 2.5vw, 18px); }
+        }
+
+        /* Mobile */
+        @media (max-width: 480px) {
+            .slide { padding: 24px 16px; }
+            .slide-title { font-size: clamp(22px, 6vw, 36px); }
+            h2 { font-size: clamp(18px, 4.5vw, 28px); }
+            p, li { font-size: clamp(12px, 3vw, 16px); }
+            .nav-controls { bottom: 16px; gap: 12px; }
+            .nav-btn { width: 32px; height: 32px; font-size: 14px; }
+        }
+
+        /* Navigation */
+        .progress-bar {
+            position: fixed;
+            top: 0; left: 0;
+            height: 3px;
+            background: var(--color-primary);
+            transition: width 0.3s;
+            z-index: 1000;
+        }
+        .nav-controls {
+            position: fixed;
+            bottom: 30px;
+            left: 50%;
+            transform: translateX(-50%);
+            display: flex;
+            align-items: center;
+            gap: 20px;
+            z-index: 1000;
+        }
+        .nav-btn {
+            background: rgba(255,255,255,0.1);
+            border: none;
+            color: #fff;
+            width: 40px; height: 40px;
+            border-radius: 50%;
+            cursor: pointer;
+            font-size: 18px;
+        }
+        .nav-btn:hover { background: rgba(255,255,255,0.2); }
+        .slide-counter { color: rgba(255,255,255,0.6); font-size: 14px; }
+    </style>
+</head>
+<body>
+    <!-- Progress Bar -->
+    <div class="progress-bar" id="progressBar"></div>
+
+    <!-- Slide Deck Container (16:9 on desktop) -->
+    <div class="slide-deck">
+
+    <!-- Slides -->
+    <div class="slide active">
+        <div class="slide-content">
+            <h1 class="slide-title">Title Slide</h1>
+            <p>Subtitle or tagline</p>
+        </div>
+    </div>
+
+    <!-- More slides... (always wrap content in .slide-content) -->
+
+    </div><!-- /.slide-deck -->
+
+    <!-- Navigation -->
+    <div class="nav-controls">
+        <button class="nav-btn" onclick="prevSlide()">←</button>
+        <span class="slide-counter"><span id="current">1</span> / <span id="total">9</span></span>
+        <button class="nav-btn" onclick="nextSlide()">→</button>
+    </div>
+
+    <script>
+        let current = 1;
+        const total = document.querySelectorAll('.slide').length;
+        document.getElementById('total').textContent = total;
+
+        function showSlide(n) {
+            if (n < 1) n = 1;
+            if (n > total) n = total;
+            current = n;
+            document.querySelectorAll('.slide').forEach((s, i) => {
+                s.classList.toggle('active', i === n - 1);
+            });
+            document.getElementById('current').textContent = n;
+            document.getElementById('progressBar').style.width = (n / total * 100) + '%';
+        }
+
+        function nextSlide() { showSlide(current + 1); }
+        function prevSlide() { showSlide(current - 1); }
+
+        document.addEventListener('keydown', (e) => {
+            if (e.key === 'ArrowRight' || e.key === ' ') { e.preventDefault(); nextSlide(); }
+            if (e.key === 'ArrowLeft') { e.preventDefault(); prevSlide(); }
+        });
+
+        document.addEventListener('click', (e) => {
+            if (!e.target.closest('.nav-controls')) nextSlide();
+        });
+
+        showSlide(1);
+    </script>
+</body>
+</html>
+```
+
+## Chart.js Integration
+
+```html
+<div class="chart-container" style="width: min(80%, 600px); height: clamp(200px, 40vh, 350px);">
+    <canvas id="revenueChart"></canvas>
+</div>
+
+<script>
+new Chart(document.getElementById('revenueChart'), {
+    type: 'line', // or 'bar', 'doughnut', 'radar'
+    data: {
+        labels: ['Sep', 'Oct', 'Nov', 'Dec'],
+        datasets: [{
+            label: 'MRR ($K)',
+            data: [5, 12, 28, 45],
+            borderColor: '#FF6B6B',
+            backgroundColor: 'rgba(255, 107, 107, 0.1)',
+            borderWidth: 3,
+            fill: true,
+            tension: 0.4
+        }]
+    },
+    options: {
+        responsive: true,
+        maintainAspectRatio: false,
+        plugins: { legend: { display: false } },
+        scales: {
+            x: { grid: { color: 'rgba(255,255,255,0.05)' }, ticks: { color: '#B8B8D0' } },
+            y: { grid: { color: 'rgba(255,255,255,0.05)' }, ticks: { color: '#B8B8D0' } }
+        }
+    }
+});
+</script>
+```
+
+## Animation Classes
+
+```css
+/* Fade Up */
+.animate-fade-up {
+    animation: fadeUp 0.6s ease-out forwards;
+    opacity: 0;
+}
+@keyframes fadeUp {
+    from { opacity: 0; transform: translateY(30px); }
+    to { opacity: 1; transform: translateY(0); }
+}
+
+/* Count Animation */
+.animate-count { animation: countUp 1s ease-out forwards; }
+
+/* Scale */
+.animate-scale {
+    animation: scaleIn 0.5s ease-out forwards;
+}
+@keyframes scaleIn {
+    from { opacity: 0; transform: scale(0.9); }
+    to { opacity: 1; transform: scale(1); }
+}
+
+/* Stagger Children */
+.animate-stagger > * {
+    opacity: 0;
+    animation: fadeUp 0.5s ease-out forwards;
+}
+.animate-stagger > *:nth-child(1) { animation-delay: 0.1s; }
+.animate-stagger > *:nth-child(2) { animation-delay: 0.2s; }
+.animate-stagger > *:nth-child(3) { animation-delay: 0.3s; }
+.animate-stagger > *:nth-child(4) { animation-delay: 0.4s; }
+```
+
+## Background Images
+
+```html
+<div class="slide slide-with-bg" style="background-image: url('https://images.pexels.com/...')">
+    <div class="overlay" style="background: linear-gradient(135deg, rgba(13,13,13,0.9), rgba(13,13,13,0.7))"></div>
+    <div class="content" style="position: relative; z-index: 1;">
+        <!-- Slide content -->
+    </div>
+</div>
+```
+
+## CSS Variables Reference
+
+| Variable | Usage |
+|----------|-------|
+| `--color-primary` | Brand primary (CTA, highlights) |
+| `--color-background` | Slide background |
+| `--color-secondary` | Secondary elements |
+| `--primitive-gradient-primary` | Title gradients |
+| `--typography-font-heading` | Headlines |
+| `--typography-font-body` | Body text |