Skip to content
Back to search

logo-design-skill

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kaankiziltug/logo-design-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kaankiziltug/logo-design-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kaankiziltug--logo-design-skill/badge.svg)](/listings/kaankiziltug--logo-design-skill)

HTML

<a href="/listings/kaankiziltug--logo-design-skill"><img src="/api/listings/kaankiziltug--logo-design-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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:

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](https://github.com/kaankiziltug/logo-design-skill/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** format (a folder with a `SKILL.md`), so it works in any agent that supports skills — the instructions are plain Markdown and the tools are plain Python. Clone once, then copy the folder into your agent's skills directory:

git clone https://github.com/kaankiziltug/logo-design-skill.git

| Agent | Personal (all projects) | Per project | |---|---|---| | Gemini CLI | `~/.gemini/skills/logo-design` (or `~/.agents/skills/`) | `.gemini/skills/logo-design` | | Codex CLI | `~/.codex/skills/logo-design` | `.codex/skills/logo-design` | | Cursor, GitHub Copilot, OpenCode, others | see your agent's skills docs | usually a `skills/` folder in the project |

cp -r logo-design-skill/skills/logo-design ~/.gemini/skills/logo-design     # Gemini CLI
cp -r logo-design-skill/skills/logo-design ~/.codex/skills/logo-design      # Codex CLI

Start a new session and ask for a logo; the agent picks the skill up from its description. The skill works best with a model that can view images, because it renders its own drafts to PNG and checks them before showing you anything. The `.claude-plugin/` folder is only used by Claude Code and is ignored elsewhere.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "logo-design-skill",
  3. "owner": {
  4. "name": "kaankiziltug",
  5. "url": "https://github.com/kaankiziltug"
  6. },
  7. "metadata": {
  8. "description": "A comprehensive logo-design skill for Claude: principles, process, SVG craft, testing tools and a 1,400+ logo reference library.",
  9. "version": "1.4.5"
  10. },
  11. "plugins": [
  12. {
  13. "name": "logo-design",
  14. "source": "./",
  15. "description": "Design, critique and deliver professional logos: brief, concepts, geometric SVG construction, optical refinement, colour, typography, testing, presentation and brand guidelines — with a searchable library of 1,400+ classified SVG logos.",
  16. "version": "1.4.5",
  17. "category": "design",
  18. "keywords": ["logo", "branding", "identity", "svg", "design", "wordmark", "icon"]
  19. }
  20. ]
  21. }
README.md · README · 483 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Logo Design Skill for Claude & AI Agents
  2. [![Sponsor](https://img.shields.io/badge/Sponsor-ea4aaa?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/kaankiziltug) [![Tests](https://github.com/kaankiziltug/logo-design-skill/actions/workflows/test.yml/badge.svg)](https://github.com/kaankiziltug/logo-design-skill/actions/workflows/test.yml) [![The New 100: #14](https://www.theagenticleaderboard.com/badges/new/logo-design-skill.svg)](#)
  3. ![Twenty-eight example runs of the logo-design skill](docs/images/hero.png)
  4. A comprehensive **logo-design skill** that turns Claude — or any agent that supports Agent Skills, such as Gemini
  5. CLI, Codex CLI, Cursor or GitHub Copilot — into a disciplined identity designer, from the first brief to
  6. production-ready SVG files and brand guidelines.
  7. - **Principles & process** — discovery and briefs, word mapping, choosing the right mark type, concepting,
  8. geometric construction, optical corrections (overshoot, bone effect, irradiation…), colour, typography, lockups,
  9. testing, presentation, delivery, redesigns and identity systems.
  10. - **A reference library of 1,400+ real-world SVG logos**, each visually classified by mark type, technique,
  11. geometry, subject, typography, mood and industry — searchable from the command line and browsable in a local
  12. gallery. Used to study construction, map category conventions and avoid look-alikes (never to copy).
  13. - **Dependency-free Python tools** — audit an SVG against logo principles, build concept overview sheets and test
  14. sheets (16 px pixel test, one-colour, reversed, squint, mirror, contexts, competitor shelf test), create client
  15. presentation boards with industry-specific mockups, render PNGs, and export a complete favicon / app-icon /
  16. web-manifest set.
  17. **Contents:** [How it works](#how-it-works) · [Install](#install) · [Examples](#examples) ·
  18. [Tests](#what-the-tests-catch) · [Use](#use) · [What's inside](#whats-inside) · [Library](#library-at-a-glance)
  19. ---
  20. ## How it works
  21. ```mermaid
  22. flowchart LR
  23. A[Brief<br/>questions or stated assumptions] --> B[Research<br/>category conventions in the library]
  24. B --> C[Concepts<br/>8–12 one-liners → build 3 in SVG]
  25. C --> D[Test & refine<br/>audit · 16 px · one-colour · shelf test]
  26. D --> E{{Checkpoint<br/>show concepts, recommend, stop}}
  27. E -- "you pick a direction<br/>and ask for the kit" --> F[Kit<br/>colour · lockups · board · icons · guidelines]
  28. E -- "you want changes" --> C
  29. ```
  30. The skill always **stops at the checkpoint**: it shows the concepts as one overview image with a recommendation and
  31. offers the full kit. Nothing else is produced until you choose a direction — the kit is most of the work and only
  32. makes sense for an approved idea.
  33. ---
  34. ## Install
  35. ### Claude Code — plugin marketplace (recommended)
  36. ```
  37. /plugin marketplace add kaankiziltug/logo-design-skill
  38. /plugin install logo-design@logo-design-skill
  39. ```
  40. ### Claude Code — manual
  41. Copy the skill folder into your personal (all projects) or project skills directory:
  42. ```bash
  43. git clone https://github.com/kaankiziltug/logo-design-skill.git
  44. cp -r logo-design-skill/skills/logo-design ~/.claude/skills/logo-design # personal
  45. # or: cp -r logo-design-skill/skills/logo-design .claude/skills/logo-design # per project
  46. ```
  47. ### Claude.ai / Claude Desktop
  48. Download `logo-design.zip` from the [Releases](https://github.com/kaankiziltug/logo-design-skill/releases) page (or run
  49. `python3 tools/package_skill.py`) and upload it under **Settings → Capabilities → Skills**. If your upload has a size
  50. limit, use `logo-design-lite.zip` (everything except the SVG files themselves).
  51. ### Gemini CLI, Codex CLI and other agents
  52. The skill uses the open **Agent Skills** format (a folder with a `SKILL.md`), so it works in any agent that supports
  53. skills — the instructions are plain Markdown and the tools are plain Python. Clone once, then copy the folder into
  54. your agent's skills directory:
  55. ```bash
  56. git clone https://github.com/kaankiziltug/logo-design-skill.git
  57. ```
  58. | Agent | Personal (all projects) | Per project |
  59. |---|---|---|
  60. | Gemini CLI | `~/.gemini/skills/logo-design` (or `~/.agents/skills/`) | `.gemini/skills/logo-design` |
  61. | Codex CLI | `~/.codex/skills/logo-design` | `.codex/skills/logo-design` |
  62. | Cursor, GitHub Copilot, OpenCode, others | see your agent's skills docs | usually a `skills/` folder in the project |
  63. ```bash
  64. cp -r logo-design-skill/skills/logo-design ~/.gemini/skills/logo-design # Gemini CLI
  65. cp -r logo-design-skill/skills/logo-design ~/.codex/skills/logo-design # Codex CLI
  66. ```
  67. Start a new session and ask for a logo; the agent picks the skill up from its description. The skill works best with
  68. a model that can view images, because it renders its own drafts to PNG and checks them before showing you anything.
  69. The `.claude-plugin/` folder is only used by Claude Code and is ignored elsewhere.
  70. ---
  71. ## Examples
  72. ![Covers for all 28 example brands](docs/images/covers-28.png)
  73. Twenty-eight fictional briefs, from quiet luxury and neon festivals to B2B SaaS, fintech and health — each run end to
  74. end with the skill. For every brand you see exactly what the skill shows at the checkpoint (greyscale concepts with
  75. true 64/32/16 px sizes and a recommendation), followed by a colour preview of the chosen direction on mockups picked
  76. for that industry. Later batches deliberately push **vivid, saturated palettes** while still passing the one-colour
  77. and 3 : 1 contrast checks. The newest batch takes on three crowded categories: **SaaS** (no chat bubbles, charts or
  78. padlocks), **finance** (no coins, piggy banks or bank blue) and **health** (no crosses, pills or heartbeat lines).
  79. The latest ten add another ten sectors. In four of them the client picked a different concept at the checkpoint than
  80. the one the skill recommended, and the skill refined that choice before colouring it: exactly what the checkpoint is
  81. for.
  82. | Brand | Sector | Style | Chosen mark |
  83. |---|---|---|---|
  84. | <img src="docs/images/tiles/kiln.png" width="24" height="24" alt=""> [Kiln](#kiln--specialty-coffee-roaster) | Specialty coffee | Warm, crafted, modern | Letterform + custom wordmark |
  85. | <img src="docs/images/tiles/zestly.png" width="24" height="24" alt=""> [Zestly](#zestly--food-delivery-app) | Food delivery | Juicy, cheeky, tomato & lime | Mascot |
  86. | <img src="docs/images/tiles/maison-orvelle.png" width="24" height="24" alt=""> [Maison Orvelle](#maison-orvelle--luxury-fashion-atelier) | Luxury fashion | High-contrast Didone | Monogram |
  87. | <img src="docs/images/tiles/pulsewave.png" width="24" height="24" alt=""> [Pulsewave](#pulsewave--music--arts-festival) | Music festival | Neon on night, kinetic | Abstract letterform |
  88. | <img src="docs/images/tiles/tinkertrail.png" width="24" height="24" alt=""> [Tinkertrail](#tinkertrail--kids-stem-workshops) | Kids' STEM education | Playful, rounded, multi-colour | Letterform |
  89. | <img src="docs/images/tiles/ralli.png" width="24" height="24" alt=""> [Ralli](#ralli--padel--tennis-app) | Sports app | Dynamic italic, electric coral | Letterform |
  90. | <img src="docs/images/tiles/alderpeak.png" width="24" height="24" alt=""> [Alderpeak](#alderpeak--outdoor-gear) | Outdoor gear | Rugged, slab, earthy | Pictorial symbol |
  91. | <img src="docs/images/tiles/driftwell.png" width="24" height="24" alt=""> [Driftwell](#driftwell--surf-hostel--café) | Hospitality | Azulejo tile, coastal brights | Emblem + symbol |
  92. | <img src="docs/images/tiles/calmera.png" width="24" height="24" alt=""> [Calmera](#calmera--physiotherapy-clinic) | Physiotherapy | Soft, organic, calm | Pictorial symbol |
  93. | <img src="docs/images/tiles/bramble-vet.png" width="24" height="24" alt=""> [Bramble Vet](#bramble-vet--veterinary-clinic) | Veterinary | Friendly character, sunny | Mascot |
  94. | <img src="docs/images/tiles/voltra.png" width="24" height="24" alt=""> [Voltra](#voltra--solar-energy) | Clean energy | Geometric, volt orange | Abstract symbol |
  95. | <img src="docs/images/tiles/keyfort.png" width="24" height="24" alt=""> [Keyfort](#keyfort--password-manager) | Security SaaS | Strict grid, electric indigo & mint | Abstract symbol |
  96. | <img src="docs/images/tiles/relaydesk.png" width="24" height="24" alt=""> [Relaydesk](#relaydesk--customer-support-saas) | Support SaaS | Rounded, violet & coral | Abstract symbol |
  97. | <img src="docs/images/tiles/tracelane.png" width="24" height="24" alt=""> [Tracelane](#tracelane--product-analytics) | Developer analytics | Technical, acid & pink on carbon | Letterform |
  98. | <img src="docs/images/tiles/tallybook.png" width="24" height="24" alt=""> [Tallybook](#tallybook--invoicing--bookkeeping) | Small-business finance | Friendly, tangerine & teal | Letterform |
  99. | <img src="docs/images/tiles/northvault.png" width="24" height="24" alt=""> [Northvault](#northvault--digital-bank-for-freelancers) | Digital banking | Bold tile, hot magenta | Letterform |
  100. | <img src="docs/images/tiles/mediora.png" width="24" height="24" alt=""> [Mediora](#mediora--telehealth-app) | Telehealth | Soft, coral face on teal | Mascot |
  101. | <img src="docs/images/tiles/brightdose.png" width="24" height="24" alt=""> [Brightdose](#brightdose--online-pharmacy) | Online pharmacy | Sunny yellow & cobalt | Letterform |
  102. | <img src="docs/images/tiles/hearsay.png" width="24" height="24" alt=""> [Hearsay](#hearsay--podcast-network) | Podcast network | Bold pink, conversational | Letterform (client's pick) |
  103. | <img src="docs/images/tiles/norrvik.png" width="24" height="24" alt=""> [Norrvik](#norrvik--architecture-studio) | Architecture | Restrained, spruce green | Abstract symbol |
  104. | <img src="docs/images/tiles/brawnhall.png" width="24" height="24" alt=""> [Brawnhall](#brawnhall--boxing-club) | Boxing gym | Heavy, hi-vis orange | Letterform (client's pick) |
  105. | <img src="docs/images/tiles/solenne.png" width="24" height="24" alt=""> [Solenne](#solenne--skincare) | Skincare | Daylight blue & gold | Pictorial (client's pick) |
  106. | <img src="docs/images/tiles/mothlight.png" width="24" height="24" alt=""> [Mothlight](#mothlight--indie-game-studio) | Indie games | Ultraviolet & lamplight | Negative space |
  107. | <img src="docs/images/tiles/loafwright.png" width="24" height="24" alt=""> [Loafwright](#loafwright--sourdough-bakery) | Bakery | Warm marigold | Mascot |
  108. | <img src="docs/images/tiles/stillbrook.png" width="24" height="24" alt=""> [Stillbrook](#stillbrook--craft-brewery) | Craft brewery | Turquoise & forge orange | Letterform |
  109. | <img src="docs/images/tiles/marlow-finch.png" width="24" height="24" alt=""> [Marlow & Finch](#marlow--finch--estate-agency) | Real estate | Finch orange & ink | Pictorial ampersand |
  110. | <img src="docs/images/tiles/kitewire.png" width="24" height="24" alt=""> [Kitewire](#kitewire--ai-agent-platform) | AI dev tools | Kite red & updraft yellow | Letterform |
  111. | <img src="docs/images/tiles/roamwheel.png" width="24" height="24" alt=""> [Roamwheel](#roamwheel--e-bike-subscription) | Urban mobility | Go lime & ink | Mascot (client's pick) |
  112. ### Kiln — specialty coffee roaster
  113. *Small-batch roaster in Istanbul: warm, crafted and modern — not rustic cliché. Must work on bags, cups and an Instagram avatar.*
  114. ![Kiln concepts](docs/images/kiln-concepts.png)
  115. **Recommended: Kiln K** — a K whose leg is the kiln's arched firing mouth; the arch returns as the *n* of the wordmark. The audit caught a 60.8° diagonal in an early *N* and an off-centre symbol before anything was shown.
  116. ![Kiln in use](docs/images/kiln-board.png)
  117. ### Zestly — food delivery app
  118. *Independent local kitchens delivered in 25 minutes: fresh, fast, appetising, cheeky — no forks, chef hats, scooters or map pins.*
  119. ![Zestly concepts](docs/images/zestly-concepts.png)
  120. **Recommended: Big Grin** — a citrus wedge flipped into a cheeky, winking grin: appetite and generosity in one mark. Tomato red with a zest-lime rind and aubergine ink. The skill flags its honest risk too: some people read the wedge as watermelon.
  121. ![Zestly in use](docs/images/zestly-board.png)
  122. ### Maison Orvelle — luxury fashion atelier
  123. *Paris womenswear, made-to-measure and small leather goods: elegant, refined, timeless — no crowns, laurels or gold gradients.*
  124. ![Maison Orvelle concepts](docs/images/maison-orvelle-concepts.png)
  125. **Recommended: Pendant** — a Didone M whose vertex holds an O like a pendant at a V-neckline; it still reads at 16 px and is solid enough to emboss on leather. The craft pass dropped a shared-foot "LL" (it read as *ORVEILE*) and avoided an M-in-a-circle (too close to a famous transit sign).
  126. ![Maison Orvelle in use](docs/images/maison-orvelle-board.png)
  127. ### Pulsewave — music & arts festival
  128. *Three-day electronic music and digital-arts festival by a lake: electric, rhythmic, euphoric — no equaliser bars, headphones or vinyl.*
  129. ![Pulsewave concepts](docs/images/pulsewave-concepts.png)
  130. **Recommended: Crossing Beams** — two stage lights send four tapered beams; where the inner beams cross they draw the W, like raised arms, and they can sweep to the beat. Electric magenta, ultraviolet and cyan on night. Cyan only reaches 1.5 : 1 on white, so the skill keeps it for dark backgrounds.
  131. ![Pulsewave in use](docs/images/pulsewave-board.png)
  132. ### Tinkertrail — kids' STEM workshops
  133. *Hands-on robotics and circuits workshops that tour schools: playful, curious, trustworthy — no lightbulbs, atoms, gears or rockets.*
  134. ![Tinkertrail concepts](docs/images/tinkertrail-concepts.png)
  135. **Chosen: Signpost t** — the t is a trail signpost pointing kids to the next discovery: a teal stem (the trail) and a coral sign (what's next). The skill had recommended the Workshop Snail; at the checkpoint the client picked the letterform because it stays sturdy for schools and reads at 16 px — exactly what the checkpoint is for.
  136. ![Tinkertrail in use](docs/images/tinkertrail-board.png)
  137. ### Ralli — padel & tennis app
  138. *Book courts, find partners at your level and join leagues: energetic, social, sporty — no tennis balls, crossed rackets, trophies or swooshes.*
  139. ![Ralli concepts](docs/images/ralli-concepts.png)
  140. **Recommended: Rally R** — one italic stroke goes up, over, back and away, like a rally; the leg was snapped to an exact 60°. Electric coral on night-court ink, with acid lime reserved for dark backgrounds.
  141. ![Ralli in use](docs/images/ralli-board.png)
  142. ### Alderpeak — outdoor gear
  143. *Packs, shells and base layers from the Pacific Northwest: rugged, dependable, honest — no generic mountain-and-sun.*
  144. ![Alderpeak concepts](docs/images/alderpeak-concepts.png)
  145. **Recommended: Cairn** — three stacked stones build a summit, a peak and a trail marker in one; the tilted gaps zigzag like a switchback. Rejected along the way: a carabiner *a* (read as "cl") and tree-ring contours (read as a target).
  146. ![Alderpeak in use](docs/images/alderpeak-board.png)
  147. ### Driftwell — surf hostel & café
  148. *Design-led surf hostel and café on the Portuguese coast: sunny, laid-back, social — no palm trees, sunsets or surfboard silhouettes.*
  149. ![Driftwell concepts](docs/images/driftwell-concepts.png)
  150. **Recommended: Azulejo Tile** — a Portuguese azulejo name tile with a D at its heart; laid edge to edge, the corner quarters join into suns. Atlantic blue, tangerine and sun yellow. The audit snapped the W and R diagonals to exact 75° and 45°.
  151. ![Driftwell in use](docs/images/driftwell-board.png)
  152. ### Calmera — physiotherapy clinic
  153. *Rehab, sports physio and pilates: calm, caring, professional — no crosses, heartbeats, spines or hands-with-hearts.*
  154. ![Calmera concepts](docs/images/calmera-concepts.png)
  155. **Recommended: Still Heron** — a heron balancing on one leg in still water; single-leg balance is a standard rehab and pilates exercise, and nothing else in the category looks like it. An early abstract idea was dropped after the peer test found it too close to an existing mark, and the sage was darkened to reach 3 : 1 contrast.
  156. ![Calmera in use](docs/images/calmera-board.png)
  157. ### Bramble Vet — veterinary clinic
  158. *A family vet for cats and dogs: warm, trustworthy, cheerful — no paws, bones, crosses or stethoscopes.*
  159. ![Bramble Vet concepts](docs/images/bramble-vet-concepts.png)
  160. **Recommended: Odd Ears** — one smiling face with a pointed cat ear and a floppy dog ear: every cat and dog belongs. Cobalt and berry on sunny yellow. Several ideas were dropped when the reading test turned them into grapes, an anchor or a teapot.
  161. ![Bramble Vet in use](docs/images/bramble-vet-board.png)
  162. ### Voltra — solar energy
  163. *Rooftop solar, home batteries and an energy app: bright, optimistic, dependable — no sun rays, leaves, bolts or plugs.*
  164. ![Voltra concepts](docs/images/voltra-concepts.png)
  165. **Recommended: Sun Dock** — the sun docks into a battery shaped to hold it, and the gap between them is a crescent moon: *sunshine, after dark*. Volt orange with night navy. A "charge-level o" was dropped because it read as *veltra*.
  166. ![Voltra in use](docs/images/voltra-board.png)
  167. ### Keyfort — password manager
  168. *Password manager and team-security SaaS with shared vaults, passkeys and access control: secure, calm, strong — no padlocks, shields, keyholes, fingerprints or chain links.*
  169. ![Keyfort concepts](docs/images/keyfort-concepts.png)
  170. **Recommended: Greek Key** — one unbroken wall winds inward: a Greek key that is also a fortress with only one way in. Electric indigo sets it apart from the category's azure blues; the innermost turn glows mint only on indigo and dark surfaces, because mint reaches just 1.4 : 1 on white. A star-fort idea was dropped when it read as a shuriken.
  171. ![Keyfort in use](docs/images/keyfort-board.png)
  172. ### Relaydesk — customer-support SaaS
  173. *One shared inbox for email, chat and social, with AI that drafts replies and routes tickets: helpful, fast, human — no headsets, robots or speech bubbles.*
  174. ![Relaydesk concepts](docs/images/relaydesk-concepts.png)
  175. **Recommended: Hand-off** — two identical hooks catch each other mid-pass, so no ticket is dropped: one radius and one stroke, repeated with a 180° turn. Coral only reaches 2.1 : 1 on violet, so on violet surfaces the mark turns all white. The craft pass snapped the *y* to an exact 60° and opened a hook gap that had shrunk to 1.7 units.
  176. ![Relaydesk in use](docs/images/relaydesk-board.png)
  177. ### Tracelane — product analytics
  178. *Event tracking, funnels and session paths for developers, with an SDK and a CLI: precise, fast, insightful — no bar charts, pie charts, magnifying glasses or up-arrows.*
  179. ![Tracelane concepts](docs/images/tracelane-concepts.png)
  180. **Recommended: Junction T** — one lane runs straight on and the other turns off to become the stem: the moment a funnel measures, drawn as the brand initial. Acid green on carbon for the terminal and README, with the turning lane always signal pink. Moving the turning lane inward made the T read at first glance.
  181. ![Tracelane in use](docs/images/tracelane-board.png)
  182. ### Tallybook — invoicing & bookkeeping
  183. *Invoicing and bookkeeping for small businesses and sole traders: friendly, tidy, reassuring — no calculators, coins, ledgers or charts.*
  184. ![Tallybook concepts](docs/images/tallybook-concepts.png)
  185. **Recommended: Bookmark T** — an open book forms the crossbar and its ribbon bookmark forms the stem: your books, always open at the right page. Tangerine with a lagoon-teal ribbon; on tangerine surfaces the ribbon turns ink, because teal and tangerine are nearly equal in luminance and would vibrate.
  186. ![Tallybook in use](docs/images/tallybook-board.png)
  187. ### Northvault — digital bank for freelancers
  188. *A business account with self-saving tax pots and instant invoicing: confident, clear, independent — no bank blue, coins, piggy banks, columns or up-arrows.*
  189. ![Northvault concepts](docs/images/northvault-concepts.png)
  190. **Recommended: Seam N** — a vault-shaped tile split into two interlocking pots, where the seam between them spells N (and N marks north on every compass). Hot magenta, with electric green kept for dark surfaces only. An electric-green card was tested and dropped because the text on it failed contrast.
  191. ![Northvault in use](docs/images/northvault-board.png)
  192. ### Mediora — telehealth app
  193. *Video consultations with a doctor in minutes, e-prescriptions and records in one place: caring, immediate, warm — no crosses, stethoscopes, hearts or pulse lines.*
  194. ![Mediora concepts](docs/images/mediora-concepts.png)
  195. **Recommended: Relief** — a circle face with closed, smiling eyes and a listening head-tilt: the relief of being looked after, fast. A coral face on a teal stage, with ink eyes and wordmark. An early *m* concept put its dot top-right, where it read as "mi", so the dot moved down.
  196. ![Mediora in use](docs/images/mediora-board.png)
  197. ### Brightdose — online pharmacy
  198. *Repeat prescriptions delivered to your door, with reminders and pharmacist chat: cheerful, reliable, easy — no green crosses, pills, mortar and pestle or rod of Asclepius.*
  199. ![Brightdose concepts](docs/images/brightdose-concepts.png)
  200. **Recommended: Sunspot b** — a lowercase *b* that holds a small sun in its counter: a bright spot in every day. Sunrise yellow is rare in a green-and-blue category; on yellow bags and app tiles the whole mark turns one-colour cobalt. Rejected along the way: a seven-bar sun that looked like a helmet and a peel that looked like a moon.
  201. ![Brightdose in use](docs/images/brightdose-board.png)
  202. ### Hearsay — podcast network
  203. *Twelve narrative and interview shows about culture, science and true stories: curious, expressive, warm — no microphones, headphones, sound waves or speech bubbles.*
  204. ![Hearsay concepts](docs/images/hearsay-concepts.png)
  205. **Chosen: Pull-up Chair** — a lowercase *h* whose ascender is a backrest tilted back 15°: pull up a chair, stay for the story. The skill had recommended *Curious Ear* (a question mark whose hook is an ear); the client picked the chair at the checkpoint, and the skill thinned its seat to match the legs before colouring it in Hearsay Pink.
  206. ![Hearsay in use](docs/images/hearsay-board.png)
  207. ### Norrvik — architecture studio
  208. *Scandinavian studio for timber housing, libraries and schools, known for daylight: precise, calm, enduring — no houses, roofs, blueprints or compasses.*
  209. ![Norrvik concepts](docs/images/norrvik-concepts.png)
  210. **Recommended: Knot** — timber grain bending around one offset knot, where a branch once reached for the light. A first favourite (an N cut through a timber block) was dropped in review because it looked too much like Northvault in this series; the accent moved from orange to spruce green to keep the set varied.
  211. ![Norrvik in use](docs/images/norrvik-board.png)
  212. ### Brawnhall — boxing club
  213. *A boxing and conditioning gym in an old warehouse, with classes for complete beginners: tough, disciplined, welcoming — no gloves, lightning, skulls or fists.*
  214. ![Brawnhall concepts](docs/images/brawnhall-concepts.png)
  215. **Chosen: Hall B** — a heavy *B* whose counters are the old hall's fanlight and arched door, the doorway lit in hi-vis orange: the door's open, the work's inside. The skill had recommended *Open Ropes*; after the client's pick, the craft pass enlarged the window and deepened the waist so the B no longer read as a D at 16 px.
  216. ![Brawnhall in use](docs/images/brawnhall-board.png)
  217. ### Solenne — skincare
  218. *Sunlight-smart skincare (serums, daily SPF, barrier creams): luminous, fresh, gentle — no leaves, drops, faces or sun rays.*
  219. ![Solenne concepts](docs/images/solenne-concepts.png)
  220. **Chosen: Persienne** — the sun seen through louvred shutters: let the light in, keep the glare out. The skill had recommended *Day of Sun* (an S of 13 suns); for the chosen shutters it reworked the proportions and the slat rhythm so the mark stays clear of striped marks such as IBM's.
  221. ![Solenne in use](docs/images/solenne-board.png)
  222. ### Mothlight — indie game studio
  223. *An eight-person studio making cozy adventure games about exploring at night: curious, warm, mysterious — no controllers, pixel hearts or big-eyed mascots.*
  224. ![Mothlight concepts](docs/images/mothlight-concepts.png)
  225. **Recommended: Half-light Moth** — a moth on the edge of the lamplight: one half is a shadow, the other half is light cut out of the night. Ultraviolet with lamplight yellow.
  226. ![Mothlight in use](docs/images/mothlight-board.png)
  227. ### Loafwright — sourdough bakery
  228. *A neighbourhood sourdough bakery where the bakers start at 3 am: warm, generous, cheerful — no wheat, rolling pins or chef hats.*
  229. ![Loafwright concepts](docs/images/loafwright-concepts.png)
  230. **Recommended: Early Lark** — a round loaf that is also a lark: the ear of its score lifts into the crest. Crust marigold with a jam-pink beak, and one solid silhouette that stamps in a single ink on kraft bags.
  231. ![Loafwright in use](docs/images/loafwright-board.png)
  232. ### Stillbrook — craft brewery
  233. *Craft brewery and taproom in a converted riverside mill: characterful, bold, local — no hops, barrels, mugs or anchors.*
  234. ![Stillbrook concepts](docs/images/stillbrook-concepts.png)
  235. **Recommended: Wall-tie S** — the forged iron S-anchor that holds the old mill's walls together, bolted through its middle. A heron idea was dropped in review because Calmera in this series already stands on one leg.
  236. ![Stillbrook in use](docs/images/stillbrook-board.png)
  237. ### Marlow & Finch — estate agency
  238. *A boutique estate agency known for honest valuations and great photography: trustworthy, warm, premium — no roofs, houses, keys or map pins.*
  239. ![Marlow & Finch concepts](docs/images/marlow-finch-concepts.png)
  240. **Recommended: Finch Ampersand** — the *&* in the name is a perched finch: the partnership and the name in one sign. After the checkpoint the client asked for a bigger beak; it grew 1.5× with one clean join to the throat, and the & still reads first at 16 px.
  241. ![Marlow & Finch in use](docs/images/marlow-finch-board.png)
  242. ### Kitewire — AI agent platform
  243. *A developer platform for building, testing and deploying AI agents: reliable, fast, controllable — no sparkles, brains, circuits or robot heads.*
  244. ![Kitewire concepts](docs/images/kitewire-concepts.png)
  245. **Recommended: Kite-cut K** — three straight cuts divide a solid kite into panels, and the seams spell K: autonomy, always on a line. Kite red with an updraft-yellow panel, away from the category's blues and violets.
  246. ![Kitewire in use](docs/images/kitewire-board.png)
  247. ### Roamwheel — e-bike subscription
  248. *A monthly e-bike subscription for city commuters: light, fast, optimistic — no bike silhouettes, lightning or eco leaves.*
  249. ![Roamwheel concepts](docs/images/roamwheel-concepts.png)
  250. **Chosen: Roamie** — a tyre on two legs with a half-lidded smirk: a wheel with somewhere to be. The skill's first pick read as a play button in review, and its second (an m/w ambigram) lost to the mascot at the checkpoint; the craft pass then split tyre and rim so it reads as a wheel, not a donut.
  251. ![Roamwheel in use](docs/images/roamwheel-board.png)
  252. ---
  253. ## What the tests catch
  254. Every concept goes through `svg_audit.py` and `preview_sheet.py` before the checkpoint. The test sheet puts the
  255. options side by side at 96 and 32 px, in one colour and reversed, then walks each one down a size ladder to 16 px —
  256. here it shows why Maison Orvelle's wordmark (B) needs a companion mark while the monogram (A) holds up:
  257. ![Test sheet](docs/images/test-sheet.png)
  258. The audit turns craft rules into checks. The same run, two files — the recommended lockup and the emblem that was not
  259. recommended:
  260. ```text
  261. $ python3 scripts/svg_audit.py a-lockup.svg b-emblem.svg
  262. === a-lockup.svg
  263. viewBox 0 0 905 256 · aspect 3.535 (horizontal) · colours 1 · anchors 205
  264. · INFO [complexity] 205 anchor points (library median 75, p75 155). Check every point earns its place.
  265. production-readiness score: 99/100
  266. === b-emblem.svg
  267. viewBox 0 0 256 256 · aspect 1.0 (square) · colours 1 · anchors 374
  268. ▲ WARN [complex] 374 anchor points — more than 95% of comparable reference logos (median 53).
  269. ▲ WARN [near-miss-angle] 8 straight edge(s) are 0.3–3° off a clean angle … (expected for type set on a curve)
  270. ▲ WARN [tiny-detail] 6 sub-shape(s) smaller than 1/48 of the canvas: 4.3×3.1 at (40,77) …
  271. production-readiness score: 76/100
  272. ```
  273. ---
  274. ## Use
  275. Just ask — the skill triggers on logo, wordmark, monogram, brand mark, app icon, favicon, rebrand and critique requests:
  276. > *"Design a logo for **Harbor**, a savings app for first-time savers. It should feel calm and safe."*
  277. > *"Here's our current logo (logo.svg) — critique it and suggest a refresh."*
  278. > *"Give me three wordmark directions for a specialty coffee roaster called Kiln."*
  279. > *"Turn this symbol into favicon, app icon and one-colour versions, plus a one-page usage guide."*
  280. Tools can also be run directly:
  281. ```bash
  282. cd skills/logo-design
  283. python3 scripts/search_library.py --technique negative-space --exemplary
  284. python3 scripts/search_library.py --industry payments-fintech --summary
  285. python3 scripts/svg_audit.py my-logo.svg
  286. python3 scripts/concept_sheet.py a.svg b.svg c.svg --names "A" "B" "C" --recommend 1 -o concepts.png
  287. python3 scripts/preview_sheet.py my-logo.svg --refs-industry developer-tools -o preview.html
  288. python3 scripts/render_png.py my-logo.svg --size 512 -o my-logo.png
  289. python3 scripts/export_variants.py my-logo.svg --mono "#0F7C80" --icon-bg "#0F7C80" --web-icons
  290. open assets/library/gallery.html # browse the library visually
  291. ```
  292. Requires Python 3.8+ (standard library only). PNG/ICO export uses whatever renderer is available: `cairosvg`,
  293. `rsvg-convert`, Inkscape, a Chromium-based browser (Chrome, Edge, Brave) or macOS Quick Look.
  294. ## What's inside
  295. ```
  296. skills/logo-design/
  297. ├── SKILL.md # workflow, checkpoint, principles, red flags, tool guide
  298. ├── references/ # loaded on demand
  299. │ ├── principles.md # the twelve principles, mnemonic model, simplicity, relevance, longevity
  300. │ ├── discovery-brief.md # question bank, brief template, word mapping
  301. │ ├── mark-types.md # wordmark → combination: pros, cons, decision guide
  302. │ ├── visual-techniques.md # geometry, grids, balance, optical corrections, negative space, gradients…
  303. │ ├── color.md · typography.md · process.md · svg-construction.md
  304. │ ├── testing-checklist.md · presentation-delivery.md · identity-system.md
  305. │ ├── redesign.md · critique.md
  306. │ └── library-guide.md # library contents, data insights, curated examples by technique
  307. ├── scripts/
  308. │ ├── concept_sheet.py # one-image concept overview shown at the checkpoint
  309. │ ├── search_library.py # query the 1,400+ logo library (filters, --summary, --format paths)
  310. │ ├── svg_audit.py # structure, colours, complexity, near-miss angles, tiny details, centring
  311. │ ├── preview_sheet.py # HTML test sheet (sizes, backgrounds, treatments, contexts, shelf test)
  312. │ ├── presentation_board.py # client presentation with six industry-specific mockups per concept
  313. │ ├── render_png.py # SVG → transparent PNG at exact sizes, favicon.ico
  314. │ ├── export_variants.py # black / white / mono / square / favicon / app-icon, PNGs, full web-icon set
  315. │ └── build_catalog.py # maintainers: rebuild catalog, stats and gallery
  316. ├── templates/ # brand-guidelines template, presentation spec example
  317. └── assets/library/ # svg/ (1,400+ files), catalog.json, classifications.json, stats.json, gallery.html
  318. ```
  319. ## Library at a glance
  320. 1,400+ files · ≈1,200 brands · 233 brands with both a lockup and a standalone icon · mark types: abstract 24 %,
  321. combination 21 %, pictorial 20 %, letterform 15 %, wordmark 10 %, emblem 4 %, mascot 4 %, lettermark 3 % · median
  322. 2 colours, 75 % use ≤ 3 · gradients in 19 % · 141 flagged as exemplary teaching examples. More in
  323. [`references/library-guide.md`](skills/logo-design/references/library-guide.md).
  324. ## License & trademarks
  325. Skill text, scripts, templates and catalog data: [MIT](LICENSE). The logo files in `assets/library/svg/` are
  326. trademarks of their respective owners, included for reference and education only and **not** covered by the MIT
  327. license — see [TRADEMARKS.md](TRADEMARKS.md). The brands in the examples are fictional briefs created to demonstrate the
  328. skill.
  329. Contributions welcome: new classified logos (with redistribution rights), better scripts, translations, evals.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.