README

Logo Design Skill for Claude & AI Agents

  

!Twenty-eight example runs of the logo-design skill

A comprehensive logo-design skill that turns Claude — or any agent that supports Agent Skills, such as Gemini
CLI, Codex CLI, Cursor or GitHub Copilot — into a disciplined identity designer, from the first brief to
production-ready SVG files and brand guidelines.

- Principles & process — discovery and briefs, word mapping, choosing the right mark type, concepting,
  geometric construction, optical corrections (overshoot, bone effect, irradiation…), colour, typography, lockups,
  testing, presentation, delivery, redesigns and identity systems.
- A reference library of 1,400+ real-world SVG logos, each visually classified by mark type, technique,
  geometry, subject, typography, mood and industry — searchable from the command line and browsable in a local
  gallery. Used to study construction, map category conventions and avoid look-alikes (never to copy).
- Dependency-free Python tools — audit an SVG against logo principles, build concept overview sheets and test
  sheets (16 px pixel test, one-colour, reversed, squint, mirror, contexts, competitor shelf test), create client
  presentation boards with industry-specific mockups, render PNGs, and export a complete favicon / app-icon /
  web-manifest set.

Contents: How it works · Install · Examples ·
Tests · Use · What's inside · Library

---

 How it works

mermaid
flowchart LR
    A[Briefquestions or stated assumptions] -- B[Researchcategory conventions in the library]
    B -- C[Concepts8–12 one-liners → build 3 in SVG]
    C -- D[Test & refineaudit · 16 px · one-colour · shelf test]
    D -- E{{Checkpointshow concepts, recommend, stop}}
    E -- "you pick a directionand ask for the kit" -- F[Kitcolour · lockups · board · icons · guidelines]
    E -- "you want changes" -- C


The skill always stops at the checkpoint: it shows the concepts as one overview image with a recommendation and
offers the full kit. Nothing else is produced until you choose a direction — the kit is most of the work and only
makes sense for an approved idea.

---

 Install

 Claude Code — plugin marketplace (recommended)

/plugin marketplace add kaankiziltug/logo-design-skill
/plugin install logo-design@logo-design-skill


 Claude Code — manual
Copy the skill folder into your personal (all projects) or project skills directory:
bash
git clone https://github.com/kaankiziltug/logo-design-skill.git
cp -r logo-design-skill/skills/logo-design ~/.claude/skills/logo-design           personal
 or: cp -r logo-design-skill/skills/logo-design .claude/skills/logo-design      per project


 Claude.ai / Claude Desktop
Download logo-design.zip from the Releases page (or run
python3 tools/package_skill.py) and upload it under Settings → Capabilities → Skills. If your upload has a size
limit, use logo-design-lite.zip (everything except the SVG files themselves).

 Gemini CLI, Codex CLI and other agents
The skill uses the open Agent Skills for

Top issues

Latest release

Bug fixes for exports and presentation boards.

- Exported SVG titles are escaped. A --title with an ampersand, such as "Marlow & Finch", produced SVG files that wouldn't open, and markup in a title could turn into SVG elements. Titles are now escaped in every exported variant. Thanks @andromia3 (6)!
- Mockup handles are clean. Presentation boards turned brand names with punctuation into handles like alex@marlow&finch.com. Handles, e-mail addresses and domains now keep only letters and digits, with accents folded ("Café" → "cafe").
- More tests in CI. Unit tests now run on Windows, macOS and L