From hypercore-business
[HyperB][Codex Only] Create or refine logo raster assets for brands, products, projects, apps, favicons, social profiles, and launch materials. Use when Codex should turn logo requirements into an English JSON logo brief, review the brief before generation, generate or edit with the project-approved image path, and deliver archived transparent-background PNG logo files with preview.html and optional Chrome preview.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hypercore-business:logo-makerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
@rules/logo-design-workflow.md
@rules/logo-design-workflow.md @references/transparent-png-requirements.md
Create logo assets that are distinctive, simple, scalable, and ready to place on arbitrary backgrounds. This skill turns brand/product requirements into a reviewed English JSON logo brief, generates or edits logo candidates, and ships only stable transparent-background PNG outputs with a local preview and archive evidence.
<routing_rule>
Use this skill when the user wants Codex to create, iterate, adapt, or prepare a logo-like raster asset, including:
Prefer this skill over image-maker or broad image-generation workflows when the primary deliverable is a logo/mark rather than a scene, photo, illustration, or marketing image.
Do not use this skill when:
</routing_rule>
<execution_contract>
gpt-image-2 when available and consistent with the project image-maker contract, unless the user explicitly changes the image model/path in a later instruction.user requirements → English JSON logo brief → brief review → Codex transparent-background PNG generation/edit → visual transparency check..png files generated/exported by the Codex image path with a native transparent background. A white, black, checkerboard, solid color, or chroma-key background is not acceptable as the final logo asset.prompt.json and the final report..hypercore/logo-maker/<topic-slug>/, save the reviewed brief as prompt.json, copy final logo files as logo1.png, logo2.png, logo3.png, ..., create preview.html, and verify all files before completion.preview.html in a fresh Google Chrome window/tab with the local helper. If Chrome cannot open, report the preview path and exact command.</execution_contract>
<trigger_examples>
Positive examples:
Negative examples:
Boundary example:
image-maker or image-generation.</trigger_examples>
new logo, logo variant, transparent export, edit existing logo, favicon/app icon, or batch concepts.rules/logo-design-workflow.md for logo-specific simplicity, scalability, silhouette, typography, and anti-generic checks.logo_prompt.text.verbatim.format: png and background: transparent, and ensure text/brand constraints are inspectable.generation_prompt as source of truth and request transparent-background PNG output directly in the Codex image generation path. The prompt must say the logo is an isolated mark on transparent background, with no background fill, no white square, no checkerboard pattern, no mockup, and no scene.file plus an alpha-pixel check on the returned PNG. If it is RGB, fully opaque RGBA, filled-background, checkerboard, chroma-key, mockup scene, or non-PNG, mark the attempt failed, refine the JSON brief/prompt/settings, and regenerate.scripts/render-simple-logo-rgba.mjs, then archive and disclose that this fallback produced the final transparent PNG. Do not use this fallback to hide a failed photoreal/logo-generation result; it is only for clean geometric logo assets..hypercore/logo-maker/<topic-slug>/ as logo1.png, logo2.png, ... and write the reviewed brief as prompt.json. The optional archive helper may be used for file copying, alpha verification, and preview.preview.html from assets/logo-preview-template.html or the optional archive helper. Use a fresh Chrome window when the user asked to see the result.prompt.json, preview.html, and every expected logoN.png exists. Require alpha evidence such as RGBA, color_type: 6, and at least one transparent pixel. Visually check the logo over checkerboard, white, black, and brand-color surfaces.<archive_helper>
The archive helper is optional but recommended for verification and preview. It is for file copying/preview only, plus alpha evidence; it is not a generator and not a background-removal path. Use it after a final PNG exists from either native Codex transparent generation or the explicit deterministic fallback:
node skills/logo-maker/scripts/archive-logo-assets.mjs \
--topic "descriptive logo topic" \
--prompt /path/to/reviewed-logo-brief.json \
--logos /path/to/logo-candidate-1.png /path/to/logo-candidate-2.png \
--open-preview
The helper copies existing PNG files and writes preview/archive files:
.hypercore/logo-maker/<topic-slug>/prompt.json.hypercore/logo-maker/<topic-slug>/logo1.png, logo2.png, ....hypercore/logo-maker/<topic-slug>/preview.htmlUse --no-preview only for non-visual automation where a browser preview is unnecessary. If you do not use the helper, manually create equivalent archive, alpha-verification, and preview evidence.
</archive_helper>
<fallback_renderer>
Use the deterministic fallback only after native transparent generation attempts fail and the requested logo can be represented as a simple geometric mark:
node skills/logo-maker/scripts/render-simple-logo-rgba.mjs \
--out .hypercore/tmp-logo-final/logo.png \
--size 1024
Then archive that PNG with scripts/archive-logo-assets.mjs. The fallback always writes a real RGBA PNG with transparent pixels, but it is intentionally limited to clean geometric marks. Record generation_settings.api_path: "deterministic_rgba_fallback" in prompt.json when this path is used.
</fallback_renderer>
<json_logo_brief>
The logo brief must be valid JSON: double-quoted keys/strings, no comments, no trailing commas.
{
"schema_version": "1.0",
"model": "gpt-image-2",
"task": "new logo",
"use_case": "brand mark",
"generation_settings": {
"api_path": "image_api",
"size": "1024x1024",
"quality": "medium",
"format": "png",
"background": "transparent",
"transparent_background": true,
"destination_intent": "project-bound",
"archive_dir": ".hypercore/logo-maker/descriptive-logo-topic",
"save_paths": [
".hypercore/logo-maker/descriptive-logo-topic/logo1.png"
],
"prompt_path": ".hypercore/logo-maker/descriptive-logo-topic/prompt.json",
"preview_html_path": ".hypercore/logo-maker/descriptive-logo-topic/preview.html"
},
"logo_archive": {
"topic": "Human-readable topic for this logo job.",
"topic_slug": "descriptive-logo-topic",
"prompt_path": ".hypercore/logo-maker/descriptive-logo-topic/prompt.json",
"logo_paths": [
".hypercore/logo-maker/descriptive-logo-topic/logo1.png"
],
"preview_path": ".hypercore/logo-maker/descriptive-logo-topic/preview.html",
"transparent_png_required": true
},
"user_requirements_summary": "English summary of the user's requirements and inferred constraints.",
"assumptions": [
"Assumption made because the user did not specify brand tone, symbol, color, usage surface, or text constraints."
],
"source_inputs": [
{
"id": "reference_1",
"type": "local_file | url | generated_reference | none",
"role": "existing_logo | brand_reference | style_reference | competitor_reference | color_reference",
"path_or_url": "",
"must_preserve": [
"Brand name, symbol idea, color, geometry, or typography invariant from this source."
]
}
],
"brand_context": {
"name": "Brand or product name.",
"domain": "What the brand/product does.",
"audience": "Who should recognize or trust it.",
"personality": ["clear", "modern", "credible"]
},
"placement": {
"primary_surface": "website header | app icon | favicon | social avatar | deck | product UI",
"safe_zone": "Centered mark with padding; must remain readable at small sizes.",
"backgrounds_to_test": ["transparent checkerboard", "white", "black", "brand color"]
},
"logo_prompt": {
"mark_type": "symbol | wordmark | combination mark | monogram | badge | app icon",
"primary_request": "The logo to create, in English.",
"symbol_concept": "One clear visual metaphor, not a collage of unrelated symbols.",
"composition": "Centered, balanced, flat logo asset on transparent background; isolated mark only, no background layer.",
"style_direction": "Minimal, scalable, vector-like raster output; no scene or mockup.",
"color_palette": "Exact or inferred colors and contrast notes.",
"typography": "Letterform style if text is included; avoid unreadable microtext.",
"text": {
"verbatim": "",
"placement": "",
"text_risk": "none | low | medium | high"
},
"must_keep": [
"Required brand name, geometry, colors, symbol, or reference invariants."
],
"avoid": [
"background fill",
"white box",
"checkerboard pattern baked into the image",
"chroma-key background",
"mockup scene",
"drop shadow as background crutch",
"generic globe/rocket/leaf unless requested",
"AI emblem clutter",
"warped text",
"watermark",
"trademark-confusing similarity"
]
},
"review_checklist": {
"valid_json": true,
"schema_fields_complete": true,
"transparent_png_required": true,
"native_transparent_generation_requested": true,
"single_clear_logo_concept": true,
"works_without_background": true,
"small_size_legibility_considered": true,
"text_constraints_are_verbatim_and_inspectable": true,
"trademark_similarity_risk_checked": true
},
"review_notes": {
"prompt_strengths": [
"Why this brief should produce a usable logo."
],
"unresolved_risks": [
"Known risk such as exact text, trademark similarity, brand ambiguity, or small-size legibility."
],
"iteration_strategy_if_failed": "Change only one dimension next: symbol, geometry, typography, color, transparency, or crop."
},
"generation_prompt": "A concise English prompt assembled from logo_prompt and constraints after review. Explicitly request a native transparent-background PNG logo asset with no background fill, no white square, no checkerboard, no mockup, and no scene."
}
</json_logo_brief>
Before completion, pass all checks:
format: png, background: transparent, and native transparent Codex image generation.logo1.png, logo2.png, ... under .hypercore/logo-maker/<topic-slug>/.prompt.json, preview.html, and every expected logoN.png.<reference_map>
rules/logo-design-workflow.md: practical rules for simple, scalable, brand-usable logo direction.references/transparent-png-requirements.md: transparent PNG prompt/settings contract and visual validation notes.scripts/archive-logo-assets.mjs: archive/preview helper that verifies final PNG alpha evidence.scripts/render-simple-logo-rgba.mjs: deterministic fallback renderer for simple geometric marks when native transparent generation repeatedly returns RGB/filled-background images.assets/logo-preview-template.html: local preview template rendered into .hypercore/logo-maker/<topic-slug>/preview.html.</reference_map>
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub alpoxdev/hypercore-business --plugin hypercore-business