Design SVG Logo
Quick SVG icon / wordmark / lockup generator for brand ideation. Lighter than
refine-logo — no full brand system; no showcase HTML.
When to Use This Skill vs refine-logo
Use this skill (design-svg-logo) |
Use refine-logo instead |
| Sketching one or two concept variants |
Establishing a production brand system |
| No existing brand guide |
Have or want a full brand guide |
| Want SVG + PNG only |
Need showcase HTML, manifests, multi-variant suite |
| Ideation, fast turnaround |
Final brand identity |
Setup
- Set
artifact_type: svg
- Set
content_type: direct:svg
- Phase-prefer-endpoint-consumption must be in place (for
--mode llm)
User Input
The user will provide: $ARGUMENTS
Parse for:
--brand-name <name> (required) — string used in wordmark / lockup
--brief <one-line> (required) — what the brand does
--style <keywords> (optional)
--primary-color <hex> (optional; default #E04E28)
--output-dir <dir> (required)
--mode llm|placeholder (optional; default llm)
--variants icon,wordmark,lockup (optional; default all three)
--png-sizes 16,32,64,128,256,512 (optional; default this list)
Procedure
Dispatch to the orchestration script:
node scripts/design-svg-logo.mjs \
--brand-name "${BRAND_NAME}" \
--brief "${BRIEF}" \
--primary-color "${PRIMARY_COLOR}" \
--output-dir "${OUTPUT_DIR}" \
${MODE:+--mode "${MODE}"} \
${STYLE:+--style "${STYLE}"}
LLM path (default --mode llm)
For each variant (icon, wordmark, lockup):
- Construct a structured prompt with viewBox hint, brand name, brief, style keywords, primary color, and security constraints (no
<script>, no on*=, no javascript: URLs)
- Call
chat("refiner-iterate", ...) — routes to small tier
- Strip markdown fences from response
- Validate via
scripts/lib/svg-validate.mjs#isValidSvg() — strict parseability + XSS rejection
- On validation failure OR
HostHarnessRoutingError: fall back to placeholder for that variant only
Placeholder path
- Icon: renders via
tools/template-forge-rs/templates/logo-icon.html (brand initial centered on rounded ember-colored rect)
- Wordmark: deterministic SVG with brand name in
system-ui at primary color
- Lockup: icon mark + wordmark side-by-side
PNG rasterization
- Per variant + PNG size, runs
rsvg-convert -w <size> <svg> -o <png> if available
- If
rsvg-convert absent: copies the SVG to a .png filename with a warning
- Icon gets all sizes; wordmark + lockup get sizes >= 128 only (smaller would be unreadable)
SVG validation
Per scripts/lib/svg-validate.mjs, every emitted SVG must:
- Open with
<svg and close with </svg>
- Contain NO
<script> tags
- Contain NO
on*= event-handler attributes (onclick, onload, etc.)
- Contain NO
javascript: URLs in href / xlink:href / src
- Parse via
parse5 without errors
LLM outputs failing any check fall back to placeholder. Placeholder outputs are generated deterministically and pass validation by construction.
Default Constraints
- All SVGs use
viewBox + explicit width/height
- No raster image embeds inside SVG (paths/rects/circles only)
- All paths use brand-primary color where appropriate; system fonts as fallback
- PNG sizes default to standard set: 16, 32, 64, 128, 256, 512
- Output naming:
<brand-kebab>-{icon,wordmark,lockup}.svg, png/<brand-kebab>-{variant}-<size>.png
Composition with Other Skills
Brand name + brief
→ design-svg-logo (LLM or placeholder)
→ SVG variants + PNG export set
For production brand systems: use refine-logo instead.
Output Contract
artifact_type: svg
content_type: direct:svg
outputs:
- path: <output-dir>/<brand>-icon.svg
- path: <output-dir>/<brand>-wordmark.svg
- path: <output-dir>/<brand>-lockup.svg
- path: <output-dir>/png/<brand>-<variant>-<size>.png
audit_log: .refiner/logo-<brand>/model-routing.log
constraints_satisfied:
- svg_validated_no_script_or_handlers
- llm_failures_fall_back_to_placeholder
- viewbox_present
- png_set_generated_or_svg_copied
References
scripts/design-svg-logo.mjs — orchestration script
scripts/lib/svg-validate.mjs — strict SVG validator
tools/template-forge-rs/templates/logo-icon.html — Minijinja placeholder template
openspec/changes/phase-3b-aux-conversions/ — design rationale
1---2name: design-svg-logo3description: >4 Lightweight SVG logo creation for ideation. Mode-switching between LLM-suggested5 SVG (with strict parseability + XSS validation) and a deterministic Minijinja6 placeholder. Exports PNG raster set when `rsvg-convert` is available.7license: MIT8metadata:9 source: https://skillmd.com/skills/prometheus-ags/design-svg-logo10 version: '1.0.0-prometheus.1'11 tags: 'artifact-refiner, design, svg, logo'12 version-origin: 'Prometheus packaging version; upstream did not declare a version'13---1415# Design SVG Logo1617Quick SVG icon / wordmark / lockup generator for brand ideation. Lighter than18`refine-logo` — no full brand system; no showcase HTML.1920## When to Use This Skill vs `refine-logo`2122| Use this skill (`design-svg-logo`) | Use `refine-logo` instead |23|---|---|24| Sketching one or two concept variants | Establishing a production brand system |25| No existing brand guide | Have or want a full brand guide |26| Want SVG + PNG only | Need showcase HTML, manifests, multi-variant suite |27| Ideation, fast turnaround | Final brand identity |2829## Setup30311. Set `artifact_type: svg`322. Set `content_type: direct:svg`333. Phase-prefer-endpoint-consumption must be in place (for `--mode llm`)3435## User Input3637The user will provide: $ARGUMENTS3839Parse for:40- `--brand-name <name>` (required) — string used in wordmark / lockup41- `--brief <one-line>` (required) — what the brand does42- `--style <keywords>` (optional)43- `--primary-color <hex>` (optional; default `#E04E28`)44- `--output-dir <dir>` (required)45- `--mode llm|placeholder` (optional; default `llm`)46- `--variants icon,wordmark,lockup` (optional; default all three)47- `--png-sizes 16,32,64,128,256,512` (optional; default this list)4849## Procedure5051Dispatch to the orchestration script:5253```bash54node scripts/design-svg-logo.mjs \55 --brand-name "${BRAND_NAME}" \56 --brief "${BRIEF}" \57 --primary-color "${PRIMARY_COLOR}" \58 --output-dir "${OUTPUT_DIR}" \59 ${MODE:+--mode "${MODE}"} \60 ${STYLE:+--style "${STYLE}"}61```6263### LLM path (default `--mode llm`)6465For each variant (icon, wordmark, lockup):66671. Construct a structured prompt with viewBox hint, brand name, brief, style keywords, primary color, and security constraints (no `<script>`, no `on*=`, no `javascript:` URLs)682. Call `chat("refiner-iterate", ...)` — routes to small tier693. Strip markdown fences from response704. Validate via `scripts/lib/svg-validate.mjs#isValidSvg()` — strict parseability + XSS rejection715. On validation failure OR `HostHarnessRoutingError`: fall back to placeholder for that variant only7273### Placeholder path7475- **Icon:** renders via `tools/template-forge-rs/templates/logo-icon.html` (brand initial centered on rounded ember-colored rect)76- **Wordmark:** deterministic SVG with brand name in `system-ui` at primary color77- **Lockup:** icon mark + wordmark side-by-side7879### PNG rasterization8081- Per variant + PNG size, runs `rsvg-convert -w <size> <svg> -o <png>` if available82- If `rsvg-convert` absent: copies the SVG to a `.png` filename with a warning83- Icon gets all sizes; wordmark + lockup get sizes >= 128 only (smaller would be unreadable)8485## SVG validation8687Per `scripts/lib/svg-validate.mjs`, every emitted SVG must:8889- Open with `<svg` and close with `</svg>`90- Contain NO `<script>` tags91- Contain NO `on*=` event-handler attributes (onclick, onload, etc.)92- Contain NO `javascript:` URLs in href / xlink:href / src93- Parse via `parse5` without errors9495LLM outputs failing any check fall back to placeholder. Placeholder outputs are generated deterministically and pass validation by construction.9697## Default Constraints9899- All SVGs use `viewBox` + explicit width/height100- No raster image embeds inside SVG (paths/rects/circles only)101- All paths use brand-primary color where appropriate; system fonts as fallback102- PNG sizes default to standard set: 16, 32, 64, 128, 256, 512103- Output naming: `<brand-kebab>-{icon,wordmark,lockup}.svg`, `png/<brand-kebab>-{variant}-<size>.png`104105## Composition with Other Skills106107```108Brand name + brief109 → design-svg-logo (LLM or placeholder)110 → SVG variants + PNG export set111112For production brand systems: use refine-logo instead.113```114115## Output Contract116117```yaml118artifact_type: svg119content_type: direct:svg120outputs:121 - path: <output-dir>/<brand>-icon.svg122 - path: <output-dir>/<brand>-wordmark.svg123 - path: <output-dir>/<brand>-lockup.svg124 - path: <output-dir>/png/<brand>-<variant>-<size>.png125audit_log: .refiner/logo-<brand>/model-routing.log126constraints_satisfied:127 - svg_validated_no_script_or_handlers128 - llm_failures_fall_back_to_placeholder129 - viewbox_present130 - png_set_generated_or_svg_copied131```132133## References134135- `scripts/design-svg-logo.mjs` — orchestration script136- `scripts/lib/svg-validate.mjs` — strict SVG validator137- `tools/template-forge-rs/templates/logo-icon.html` — Minijinja placeholder template138- `openspec/changes/phase-3b-aux-conversions/` — design rationale