CommunityImagegithub.com

logo-kit

Use when a client or project needs its logo delivered as a set of files or formats — logo kit, brand asset pack, PNG/SVG/PDF exports, transparent versions, black and white variants, social media banners and profile pictures, favicon or app icons, email signature, watermark. Also when the user says "logo kit", "brand kit", "export the logo", "pack logo", "kit logo", "décline le logo", "plusieurs versions du logo", "le logo pour les réseaux", "exporte le logo". Not for designing or redesigning the logo itself.

What is logo-kit?

logo-kit is a Claude Code agent skill that use when a client or project needs its logo delivered as a set of files or formats — logo kit, brand asset pack, PNG/SVG/PDF exports, transparent versions, black and white variants, social media banners and profile pictures, favicon or app icons, email signature, watermark. Also when the user says "logo kit", "brand kit", "export the logo", "pack logo", "kit logo", "décline le logo", "plusieurs versions du logo", "le logo pour les réseaux", "exporte le logo". Not for designing or redesigning the logo itself.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lvni7/logo-kit/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Logo kit

One SVG logo → the complete kit to hand over to a client, made by logo_kit.py, which sits next to this file. It renders with headless Chrome and needs no Python package on macOS. Never make these files by hand: run the script, then look at the result.

Steps

  1. Find the source SVG of the full logo, and the SVG of the symbol alone (no text) if there is one. Only a PNG/JPG → stop: the logo has to be vectorized first; tell the user.
  2. Run it from the project root (under a minute). <skill-dir> is the folder that holds this file:
    python3 <skill-dir>/logo_kit.py path/logo.svg --nom "Client Name" \
      --symbole path/symbol.svg --nom-couleur gold
    
    On Windows use python instead of python3.
  3. Look at kit-logo/apercu.png with your image-viewing tool and check every row (see "What to check"). A defect → fix it with an option, run again with --ecraser, look at the preview again.
  4. Deliver: open kit-logo/apercu.html for the user (open on macOS, xdg-open on Linux, start on Windows), then give the path of the zip kit-logo/<name>-kit-logo.zip.

Options

The options and the kit's folder names are in French: the kit is delivered as is to French-speaking clients.

OptionRoleDefault
--nomBrand name (file prefix, preview title)required
--symboleSymbol alone: icons and profile picturesthe full logo
--nom-couleurName of the original color version in file names (gold, blue…)couleur
--accentBrand color: "accent" background, halo, choice of the readable variantfirst color of the SVG
--fondDark background of the visuals#0a0a0a
--sortieKit folder./kit-logo
--ecraserReplace an existing kitrefuses if the folder exists

What the kit holds

FolderContent
1-vectorielSVG original / black / white (logo and symbol), PDF original and black
2-png-transparentLogo at 1000, 2000 and 4000 px; symbol at 1000 and 2000 px; all 3 tints
3-reseaux-sociaux8 formats (Instagram, story, Facebook, LinkedIn, X, 16:9) × 3 styles (dark, halo, light) + 4 profile pictures
4-autres-usagesSolid backgrounds, icons 16 → 1024 px, watermark, email signature
rootapercu.html, apercu.png, the zip

What to check in the preview

What you seeCauseFix
Logo hard to read on a background, or wrong "accent" backgroundMulticolor logo: the SVG's first color is not the brand color--accent "#rrggbb"
Black or white version is a solid blob, details goneThe logo uses white shapes or a mask to "cut out"Tell the user: these versions need a dedicated one-color SVG
Logo text in another font<text> not converted to paths (the script warned about it)Convert the text to paths in the source SVG
Unreadable icons (wide logo squeezed into a square)No --symboleAsk for or extract the symbol alone, run again with --symbole

Common mistakes

  • Putting the kit in public/: it would ship with the website. Leave it at the project root.
  • Saying "done" without looking at apercu.png. The script checks sizes, not readability.
  • Using --ecraser on a folder that is not a generated kit: look at what it holds first.

Requirements

  • Python 3.9+ and Google Chrome, Chromium or Microsoft Edge (CHROME=/path/to/chrome if it is not found).
  • Small sizes are scaled down with sips (built into macOS); elsewhere with Pillow (pip install pillow) or ImageMagick.

The script checks itself with python3 <skill-dir>/logo_kit.py --test.

Related Skills