AGENT SKILL

brand-symbol-design

Use when designing a brand symbol/mark programmatically.

License 许可
MIT
最近更新
2026-08-16
Stars
★ 0
Forks
0

01 前言 Front Matter

name
brand-symbol-design
author
Hermes curator
license
MIT
version
1.0.0
metadata
{ "hermes": { "tags": [ "branding", "svg", "logo", "symbol", "cairosvg", "pillow", "verification", "design" ], "related_skills": [ "frame-by-frame-animation", "architecture-diagram" ] } }
platforms
[ "linux", "macos", "windows" ]
description
Use when designing a brand symbol/mark programmatically.

02 资源文件 4

03 SKILL.md 正文

Brand Symbol Design (programmatic)

Ibrahim's briefs ("symbol not logo") follow the Apple / Grok / Nike model: a single iconic silhouette drawable from memory at 16px — no text, no letterform unless the letter IS the symbol. A logo is a lockup; a symbol is a mark. Deliver symbols.

When to use

  • Any "design a symbol / logo / mark" request for Maarifu, Olive, JengaConnect, Ghost, KukuPlus, or new products.
  • Iterating on an existing mark (variants, mono/reversed, favicon packs).

Audio twin: when the brief also calls for a brand sound mark / sonic logo, use the brand-sonic-logo skill — symbol and sound should encode the same brand story (Maarifu: λ arc → rising gliss, gold spark → bell crest).

Workflow

  1. Read the brand guide first (vault: 00. Company/Brand Guidelines.md). Extract: palette, sacred elements, logo DON'Ts. Never break sacred elements in a redesign — fold them into the symbol. (Maarifu's chosen symbol since 2026-08-05: geometric λ "Trajectory" — λ + cyan arc, gold spark on crest; sacred elements are the gold spark and the teal/gold/cyan palette.)
  2. Design 3 distinct directions, one per archetype: (a) letter/peak-derived — keeps the brand letterform; (b) icon/tech — iris/aperture/tool; (c) pure gesture — vortex/swoosh, no letter. Each gets a one-line rationale + tradeoffs.
  3. Geometry-first SVG: 200×200 viewBox, exact coordinates, parametric helpers (poly_arc, path builders). Tune stroke widths and radii for the smallest target size.
  4. Render variants per direction: color, monochrome (single color), reversed (on brand dark bg). Fallback chain: cairosvg → rsvg-convert → inkscape. Run with env -u PYTHONPATH (a venv on PYTHONPATH hijacks python).
  5. Size test strip: 96 / 64 / 48 / 32 / 24 px LANCZOS downsamples — 24px is the favicon/avatar test that separates symbols from logos.
  6. Pixel-verify colors at key probe coordinates against hex expectations (tolerance ±24); probe "background" spots expect transparency. Use scripts/verify_png_colors.py instead of hand-typing the check.
  7. Comparison sheet: PIL composite — title, wrapped rationale, 3 previews per direction (color/mono/rev), size strip, tradeoff table, file manifest. Brand-consistent: Bone #F8F4E9 background, Deep Teal #0F4C5C headings.
  8. Deliver: source SVG + 512px PNG for every variant into the vault brand folder (00. Company/brand/<subfolder>/), keep the build script in the project dir for iteration, report absolute paths + MEDIA: links.

Craft rules

  • One silhouette, ≤3 strokes/shapes, no gradient needed to read, recognizable at 24px, drawable from memory.
  • Use the brand palette exactly (Maarifu: #0F4C5C / #E8A745 / #00B4A6 — gold is accent, never base).
  • Every symbol must carry the brand story — write it into the rationale (Maarifu: "mastery in motion" = knowledge rising into action).
  • Reversed variant: flip linework colors so it reads on dark; test contrast.

Pitfalls

  • Vision models may reject images at the provider level (unknown variant 'image_url', expected 'text') — do NOT retry in a loop. Fall back to a deterministic ASCII sanity render (downsample RGBA → #/o/~ glyph map) + pixel probes; it verifies geometry without a vision model.
  • Verifier all(...) bug: if checks are stored as (label, (passed, px)) tuples, all(c[0] for c in checks) tests the LABELS (always truthy) → false PASS. Use all(c[1][0] ...).
  • Probe coordinates must land on the element: a dot drawn OVER an arc crest hides the arc — probe the arc at an x offset where the dot doesn't reach (compute y from circle equation).
  • PIL ImageDraw.arc bbox/angle math is error-prone for arcs through 3 points — draw a sampled polyline instead; in SVG emit the true A rx ry rot large-arc sweep x y arc (compute flags: large-arc=1 if sweep >180°, sweep=1 for clockwise in y-down).
  • Verifier hex parsing: strip the # before int(..., 16) — int('#E8', 16) raises ValueError.
  • Auto-centering (e.g. bbox-recentered spirals) shifts probe coordinates — compute probes from the geometry function's output, not hardcoded values, or you get false FAILs.
  • PIL Image.LANCZOS Pyright "unknown attribute" warnings are noise — works at runtime.
  • im.getcolors(1<<24) gives nontransparent pixel counts; reversed variants are full-canvas because the bg counts as opaque.
  • DejaVu fonts at /usr/share/fonts/truetype/dejavu/ for sheet text; wrap paragraphs manually via textlength.

Scripts

  • scripts/verify_png_colors.py — pixel-verify a rendered PNG against x,y:HEX probes (SVG viewBox coords, auto-scaled), supports transparent checks.

References

  • references/maarifu-symbol-v1.md — Maarifu v1 case: 3 concepts (Apex/Lens/Vortex), trade-off table, file locations, pending direction decision.
  • references/maarifu-symbol-v2.md — CHOSEN Maarifu symbol: geometric λ "Trajectory" (λ + cyan arc, spark on crest), exact geometry (240×240 viewBox, apex/legs/arc/dot coordinates), production pack locations.
  • references/siafu-phalanx-v1.md — CHOSEN Siafu product mark: 3 chevrons + gold scout point (200×200 viewBox, exact path data), 7/7 pixel-probe coordinates + expectations, usage rules. Second worked example of the full pipeline (geometry → variants → size strip → probes → delivery).

04 同仓库更多 Skills