KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #claude-code #mcp #rust #deepseek-harness #ai-agent #cli

brand-identity-generator

★ 1 Open GitHub ↗

Free open source Claude Code skill that generates complete brand identities: brand guidelines deck, logo system, colors, typography, voice and real AI product mockups

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Brand Identity Generator

**A Claude Code skill that designs a complete, agency-grade brand identity — logo system, colors, typography, voice, and real AI product mockups — delivered as a polished 16:9 brand guidelines deck (HTML + PDF).**

[Website & brief builder](https://abdulkareemkr.github.io/brand-identity-generator/) ·
[The skill](skill/SKILL.md) ·
[Example output](examples/terra/)

</div>

---

## What it makes

Give it a logo (or nothing at all) and a short brief. It produces:

| Deliverable | Details |
|---|---|
| **Brand guidelines deck** | 10 to 45 slides, landscape 16:9, self-contained HTML exported to PDF |
| **Logo system** | Wordmark, symbol, app badge, white/dark variants, clear space and misuse rules |
| **Color system** | Swatches with HEX / RGB / CMYK, roles (primary, tint, text, base, accent) |
| **Typography** | Display + body pairing, specimens, bilingual (e.g. Arabic + Latin) support |
| **Voice & values** | Personality sliders, say / don't say, values typography |
| **Real product mockups** | AI-photographed applications: cups, packaging, storefronts, business cards, uniforms, billboards — with **your actual logo composited in**, never redrawn |

Every image below was generated by the skill for **terra**, a fictional demo coffee brand — from logo to storefront in one session:

Full example deck: [`examples/terra/Terra-Brand-Guidelines.pdf`](examples/terra/Terra-Brand-Guidelines.pdf)

## How it works

1. **Brief** — You tell Claude the brand name, market, audience, and vibe (or use the [brief builder](https://abdulkareemkr.github.io/brand-identity-generator/) to compose one). Upload a logo, or let the skill design one and show you 6 to 8 options.
2. **Foundations** — The skill locks the logo, samples/derives a palette, picks a type pairing, and confirms direction with you *before* building 30+ slides.
3. **Mockups** — Real product photos are generated with your actual logo passed as a reference image (Gemini 2.5 Flash Image), plus flat illustrations and patterns (gpt-image-1). Guards prevent redrawn letters and AI-invented gibberish text.
4. **Deck & review** — Everything is composed into one self-contained HTML deck, printed to PDF via headless Chrome, then every page is rasterized and visually reviewed before delivery.

## Install

```bash
git clone https://github.com/AbdulkareemKR/brand-identity-generator.git \
  ~/.claude/skills/brand-identity
```

Then in [Claude Code](https://claude.com/claude-code):

```
create a brand identity for my coffee shop "terra" — earthy, artisanal, warm
```

The skill triggers on: *brand identity, brand guidelines, design system, brand book, style guide, brand deck, logo design*.

## Keys

| Env variable | Used for | Required? |
|---|---|---|
| `GEMINI_API_KEY` | Logo-bearing product mockups (Gemini 2.5 Flash Image) — [get one](https://aistudio.google.com/apikey) | Optional, recommended |
| `OPENAI_API_KEY` | Flat illustrations, seamless patterns, illustrated scenes (gpt-image-1) — [get one](https://platform.openai.com/api-keys) | Optional |

```bash
export GEMINI_API_KEY="..."   # add to ~/.zshrc or ~/.bashrc
export OPENAI_API_KEY="..."
```

No keys? The deck still builds — logo, colors, type, voice, and vector slides render free via headless Chrome. You only lose the AI photo mockups.

Also needed locally: Google Chrome (PDF export), Python 3 with Pillow (`pip install pillow`, used for logo processing and the review pass).

## Repo layout

```
skill/SKILL.md            the skill — copy of what runs in Claude Code
skill/scripts/            process_logo.py (logo → clean PNG set + palette)
                          gen_mockups.py  (AI mockup generation template)
examples/terra/           full demo: assets, deck HTML, PDF, mockups
docs/                     the website (GitHub Pages)
```

## Why the output doesn't look AI-generated

The skill encodes hard-won craft rules: one product per application page with multiple angles, ghost mannequins instead of people, "absolutely no text" guards against gibberish, real logo compositing instead of redrawing, print-safe CSS, a mandatory page-by-page visual review, and an anti-slop test — *"could someone tell an AI made this?"* If yes, it pushes harder.

## License

[MIT](LICENSE) — use it for client work, commercial brands, anything.

brand-identity-generator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README