opengfx-logo

name	opengfx-logo
description	Generate complete logo systems with icon + wordmark + lockups. Creates production-ready SVG vector logos from natural language prompts. Use when a user requests a logo, brand mark, icon design, or visual identity foundation.
version	1.3.0
note	This is the INTERNAL implementation skill for OpenGFX. For the external SERVICE documentation (ACP/x402 API), see clawhub.com/skills/opengfx.

OpenGFX Logo System

Generate production-ready logo systems from natural language input.

What This Skill Produces

Every logo system includes:

1. Icon — Single-color vector path in square container (1:1)
2. Wordmark — Typography-based name, single-color vector
3. Stacked Lockup — Icon above wordmark, centered
4. Horizontal Lockup — Icon left, wordmark right
5. Logo System JSON — Machine-readable metadata

All outputs are SVG vectors optimized for scalability (16px → billboard).

Icon Container Rule (Critical)

The icon SVG is ALWAYS a square container (1:1 aspect ratio).

• If the icon shape is not square, add negative space to make the container square
• NEVER stretch or distort the icon to fill a square
• The icon floats within the square with appropriate padding

---

Generation Pipeline

Step 1: Parse User Input

Extract from prompt:

• Brand Name (required)
• Icon Direction (emoji, concept, or abstract reference)
• Style Direction (minimal, playful, corporate, tech, etc.)
• Typeface Direction (sans-serif, serif, geometric, humanist, etc.)

If missing, ask clarifying questions before proceeding.

Step 2: Conceptualize Icon

Apply geometric construction principles:

1. Select Base Shape — Circle, triangle, square, or compound
2. Apply Concept — Map user's icon direction to geometric form
3. Simplify — Reduce to single vector path that works at 16px
4. Test in Black — No color until form is solid

Reference: GEOMETRY.md for shape meanings and construction.

Step 3: Select Typeface

Match typeface to brand personality:

Style	Typeface Families
Tech/Modern	Inter, SF Pro, Söhne, Geist, Manrope
Minimal/Apple	SF Pro Display, Helvetica Neue, Avenir
Geometric	Futura, Century Gothic, Proxima Nova
Humanist	Gill Sans, Frutiger, Myriad Pro
Elegant	Didot, Bodoni, Playfair Display
Playful	Quicksand, Poppins, Nunito
Corporate	IBM Plex Sans, Roboto, Open Sans

Convert wordmark to single-path SVG (outlined, not live text).

Reference: TYPOGRAPHY.md for type selection.

Step 4: Construct Lockups

Generate two SVG lockups with consistent proportions:

Stacked (1:1)

┌─────────────────┐
│      ICON       │
│                 │
│    WORDMARK     │
└─────────────────┘

Horizontal (3:1 to 4:1)

┌─────────────────────────────┐
│  ICON  │     WORDMARK       │
└─────────────────────────────┘

Reference: LOCKUPS.md for spacing ratios.

Step 5: Output Package

Generate output files:

output/
├── icon.svg           # Icon in square container (1:1)
├── wordmark.svg       # Isolated wordmark
├── stacked.svg        # Icon + wordmark vertical
├── horizontal.svg     # Icon + wordmark horizontal
└── logo-system.json   # Metadata + tokens

---

Design Principles (Enforce Always)

The One Thing Rule

Every logo must have exactly ONE memorable feature. Not two, not three. One.

Black First

Design in solid black (#000000). Color comes last. If the logo doesn't work in black, it doesn't work.

Geometric Foundation

All icons derive from the five universal shapes. Even organic forms should be constructed on a geometric grid.

Scalability Test

Every logo must pass:

• 16px (favicon)
• 32px (app icon)
• 64px (small UI)
• 256px+ (print/display)

Single Path Principle

Icon should be reducible to a single compound path. Wordmark should be outlined (no live text).

---

Quality Checklist

Before delivering any logo:

• Icon works in solid black
• Icon works at 16px without detail loss
• Wordmark is outlined (paths, not text)
• All three lockups have consistent spacing
• One memorable feature, not multiple
• Appropriate to industry/context
• SVG is optimized (no unnecessary groups, transforms)

---

Example Prompt → Output

Input:

"I need a logo for my new company called OpenGFX, it should be a paint palette like this emoji 🎨 paired with a clean sans serif font, think Apple / Steve Jobs design style"

Parsed:

• Brand Name: OpenGFX
• Icon Direction: Paint palette (🎨)
• Style: Apple-minimal, Steve Jobs aesthetic
• Typeface: Clean sans-serif (SF Pro Display, Helvetica Neue)

Generated:

• Icon: Simplified paint palette derived from circle + 3 dots
• Wordmark: "OpenGFX" in SF Pro Display (or Helvetica Neue), tracked -10
• Lockups: All three variants with Apple-style generous whitespace

---

References

• GEOMETRY.md — Shape meanings, construction grids
• TYPOGRAPHY.md — Type selection, pairing, tracking
• LOCKUPS.md — Spacing ratios, safe areas
• MODERNISM.md — Logo Modernism principles

---

Anti-Patterns (Never Do)

• ❌ Multiple competing visual ideas in one icon
• ❌ Gradients or effects in primary logo
• ❌ Live text in SVG (always outline)
• ❌ Icons that lose detail at small sizes
• ❌ Trendy effects (drop shadows, 3D, bevels)
• ❌ Literal representations (restaurant logo = fork, dental = tooth)
• ❌ Generic shapes without conceptual connection