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
- 参考文档references/maarifu-symbol-v1.md1.6 KB
- 参考文档references/maarifu-symbol-v2.md1.5 KB
- 参考文档references/siafu-phalanx-v1.md2.4 KB
- 脚本scripts/verify_png_colors.py1.8 KB
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-logoskill — symbol and sound should encode the same brand story (Maarifu: λ arc → rising gliss, gold spark → bell crest).
Workflow
- 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.) - 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.
- Geometry-first SVG: 200×200 viewBox, exact coordinates, parametric helpers (
poly_arc, path builders). Tune stroke widths and radii for the smallest target size. - 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). - Size test strip: 96 / 64 / 48 / 32 / 24 px LANCZOS downsamples — 24px is the favicon/avatar test that separates symbols from logos.
- Pixel-verify colors at key probe coordinates against hex expectations (tolerance ±24); probe "background" spots expect transparency. Use
scripts/verify_png_colors.pyinstead of hand-typing the check. - Comparison sheet: PIL composite — title, wrapped rationale, 3 previews per direction (color/mono/rev), size strip, tradeoff table, file manifest. Brand-consistent: Bone
#F8F4E9background, Deep Teal#0F4C5Cheadings. - 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. Useall(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.arcbbox/angle math is error-prone for arcs through 3 points — draw a sampled polyline instead; in SVG emit the trueA rx ry rot large-arc sweep x yarc (compute flags: large-arc=1 if sweep >180°, sweep=1 for clockwise in y-down). - Verifier hex parsing: strip the
#beforeint(..., 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.LANCZOSPyright "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 viatextlength.
Scripts
scripts/verify_png_colors.py— pixel-verify a rendered PNG againstx,y:HEXprobes (SVG viewBox coords, auto-scaled), supportstransparentchecks.
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
web-ui-verification
Verify web UIs via headless Chrome CDP, no vision needed.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.
spike
Throwaway experiments to validate an idea before build.
simplify-code
Parallel 4-agent cleanup of recent code changes.
scroll-driven-3d-websites
Scroll-scrubbed 3D promo sites (Three.js + GSAP).