notbucki 15de38fb70
fix(design): make workflows self-contained, add bundled-skill contract (#498)
* fix(design): make workflows self-contained, add bundled-skill contract (#474 finding 2)

The design skill's banner and social-photos workflows named skills the plugin
does not ship (frontend-design, ai-artist, ai-multimodal, chrome-devtools,
project-management, assets-organizing) and claudekit command namespaces
(/ckm:brand, /ck:ui-ux-pro-max), so those steps fail or force the agent to
improvise under a plugin or CLI install. Rewrite them after the pattern of
#473: bundled skills stay referenced by name, optional tooling becomes an
optional runtime capability, unbundled steps are implemented inline or
dropped. The same references sat in references/social-photos-design.md, so
the fix covers the skill directory, not just SKILL.md; the CLI copy is synced.

check-asset-sync.yml gains a bundled-skill contract over both skill trees:
no /ck: or /ckm: namespace, every "`name` skill" reference must be a
directory under .claude/skills, and none of the claudekit-only names above
in any spelling.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* fix(design): address review - list-aware skill grep, case-insensitive denylist, banner intro, report naming

- contract grep 2 walks comma/and/or lists so every member is checked, not
  only the last one, and accepts the sub-skill and bold forms; grep 3 matches
  case-insensitively; the step comment states what is not covered
- banner intro no longer claims "no sibling skills" while step 2 names the
  bundled ui-ux-pro-max skill
- social-photos report name stated inline instead of "naming pattern from
  session hooks" (a claudekit convention nothing in the bundle provides);
  "persistent" dropped from the task-list step; device-scale note scoped to
  tools that support it

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* fix(ci): match wrapped skill lists - read each file as one record in the bundled-skill contract

A Markdown list wrapped over two lines ("`playwright-mcp`,\n`brand`, and
`ui-ux-pro-max` skills") passed the line-oriented allowlist grep. Read the
file as one record (-z, separators as \s+) so wrapped lists are still lists;
a hit now names the file and the name instead of the line. grep's own exit
status is taken inside the substitution so an unreadable file still fails the
step under plain bash -e, pipefail or not.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 16:29:29 +07:00

4.2 KiB

Logo Design Reference

AI-powered logo design with 55+ styles, 30 color palettes, 25 industry guides. Gemini Nano Banana is the default provider; Atlas Cloud and MuAPI are also available as explicit opt-in providers.

Scripts

Script Purpose
scripts/logo/search.py Search styles, colors, industries; generate design briefs
scripts/logo/generate.py Generate logos with Gemini Nano Banana, Atlas Cloud, or MuAPI
scripts/logo/core.py BM25 search engine for logo data

Commands

Design Brief (Start Here)

python3 scripts/logo/search.py "tech startup modern" --design-brief -p "BrandName"

Search Domains

# Styles
python3 scripts/logo/search.py "minimalist clean" --domain style

# Color palettes
python3 scripts/logo/search.py "tech professional" --domain color

# Industry guidelines
python3 scripts/logo/search.py "healthcare medical" --domain industry

ALWAYS use white background for output logos.

python3 scripts/logo/generate.py --brand "TechFlow" --style minimalist --industry tech
python3 scripts/logo/generate.py --prompt "coffee shop vintage badge" --style vintage
python3 scripts/logo/generate.py --brand "TechFlow" --provider atlas
python3 scripts/logo/generate.py --brand "TechFlow" --provider muapi
python3 scripts/logo/generate.py --brand "TechFlow" --provider muapi --muapi-model nano-banana-pro

Options: --style, --industry, --prompt, --provider, --atlas-model, --muapi-model

Available Styles

Category Styles
General Minimalist, Wordmark, Lettermark, Pictorial Mark, Abstract Mark, Mascot, Emblem, Combination Mark
Aesthetic Vintage/Retro, Art Deco, Luxury, Playful, Corporate, Organic, Neon, Grunge, Watercolor
Modern Gradient, Flat Design, 3D/Isometric, Geometric, Line Art, Duotone, Motion-Ready
Clever Negative Space, Monoline, Split/Fragmented, Responsive/Adaptive

Color Psychology

Color Psychology Best For
Blue Trust, stability Finance, tech, healthcare
Green Growth, natural Eco, wellness, organic
Red Energy, passion Food, sports, entertainment
Gold Luxury, premium Fashion, jewelry, hotels
Purple Creative, innovative Beauty, creative, tech

Industry Defaults

Industry Style Colors Typography
Tech Minimalist, Abstract Blues, purples, gradients Geometric sans
Healthcare Professional, Line Art Blues, greens, teals Clean sans
Finance Corporate, Emblem Navy, gold Serif or clean sans
Food Vintage Badge, Mascot Warm reds, oranges Friendly, script
Fashion Wordmark, Luxury Black, gold, white Elegant serif

Workflow

  1. Generate design brief → scripts/logo/search.py --design-brief
  2. Generate logo variations → scripts/logo/generate.py --brand --style --industry
  3. Ask user about HTML preview → AskUserQuestion tool
  4. If yes, use the bundled ui-ux-pro-max skill for the HTML gallery

Detailed References

  • references/logo-style-guide.md - Detailed style descriptions
  • references/logo-color-psychology.md - Color meanings and combinations
  • references/logo-prompt-engineering.md - AI generation prompts

Setup

export GEMINI_API_KEY="your-key"
pip install google-genai

# Optional Atlas Cloud provider (no extra Python package required)
export ATLASCLOUD_API_KEY="your-key"

# Optional MuAPI provider (no extra Python package required)
export MUAPI_API_KEY="your-key"

MuAPI uses the asynchronous model endpoint and prediction result API. See the MuAPI API reference for authentication and the nano-banana model contract or nano-banana-pro model contract for the current model-specific schemas. The logo generator supports both documented model slugs and sends their shared required prompt plus optional aspect_ratio fields; the Pro model also accepts an optional resolution field that this focused logo workflow leaves at the provider default.