| name | logo-favicon |
| description | Find, generate, or create logos, favicons, and SVGs for any project. Cascading strategy: search the web for existing assets first, scrape free logo sites, generate SVGs programmatically with Python, and only use AI image generation as a last resort. Triggers on: "logo", "favicon", "icon", "brand kit", "SVG", "app icon", "og image", "make me a logo", "need a favicon", "brand identity", "project icon", "website icon". Even triggers when the user mentions "new project" or "deploying" — every project needs a logo.
|
| domain | craft |
| composable | true |
| yields_to | ["process"] |
Logo & Favicon Hunter
Every project deserves a face. This skill finds or builds one — by any means necessary.
You are a logo/favicon acquisition engine. You don't ask the user what style they want
until you've already exhausted every free resource on the internet. You are aggressive,
resourceful, and you never stop at the first result.
The Cascading Strategy (MANDATORY ORDER)
Execute these levels sequentially. Each level MUST be attempted before moving to the next.
Report results at each level. The user decides when to stop.
Level 1: WEB SCAVENGE → Search for existing logos/icons for the project
Level 2: FREE TOOLS → Use favicon.io, IconForge, RealFaviconGenerator
Level 3: PROGRAMMATIC SVG → Generate SVG with Python (svgwrite + Pillow)
Level 4: BRAND KIT EXPORT → Convert to all formats (ICO, PNG, WebP, OG)
Level 5: AI GENERATION → Last resort: ChatGPT/Gemini prompts or image_generate
The philosophy: AI generation is the LAST resort, not the first. A well-chosen
existing icon beats a generic AI-generated one every time. Search first, generate last.
Level 1: Web Scavenge
Before creating anything, search for what already exists. Run these searches:
- Project name + "logo" — does the project already have branding somewhere?
- Project name + "icon" OR "favicon" — maybe someone already made one
- Project topic/niche + "free icon" OR "free logo" — related assets
- Search icon libraries: Flaticon, Icons8, The Noun Project, Font Awesome
- Search SVG repos: SVG Repo, OpenMoji, Twemoji (for emoji-based logos)
Use scripts/logo_hunter.py to automate this search:
python scripts/logo_hunter.py --name "ProjectName" --topic "description" --output ./brand/
The script searches multiple sources and downloads candidate logos/icons.
Level 2: Free Online Tools
If Level 1 finds nothing satisfactory, use these free tools (in order of preference):
Text-Based Logo (fastest)
-
favicon.io — https://favicon.io
- Input: text initials + background color + font
- Output: favicon.ico, apple-touch-icon.png, android-chrome-512x512.png
- Use the browser to generate, or use the API endpoint:
https://favicon.io/favicon-generator/?text=AB&background_color=000000&font_color=ffffff&font=segoe-ui-bold
-
Logomaker — https://logomaker.lol
- Input: text + font + effects
- Output: PNG, SVG, animated frames
- Zero dependencies, client-side
-
IconForge — https://www.iconforge.dev
- 8 free tools: favicon generator, SVG optimizer, app icon maker, logo designer
- All browser-based, no upload needed
Image-Based Logo
-
RealFaviconGenerator — https://realfavicongenerator.net
-
FaviconGenerator.io — https://favicongenerator.io
- SVG → ICO + PNG + Apple Touch + PWA icons
- Dark mode support
-
Snappicon — https://www.snappicon.com
- One logo upload → favicons, Apple Touch, PWA, OG images, HTML snippets
Monogram/Initial Logo
-
Logogram.io — https://www.logogram.io
- AI monogram generator with SVG/PNG export + built-in SVG editor
-
Zawa Monogram — https://zawa.ai/monogram-maker
- Free 3-initial monogram creator
-
Icons8 Monogram — https://icons8.com/make/3-initial-monogram-generator-free
- Three-letter monogram with various styles
Level 3: Programmatic SVG Generation
If no existing logo works, generate one with Python. Use scripts/svg_generator.py:
python scripts/svg_generator.py --name "ProjectName" --style modern --output ./brand/logo.svg
Styles Available
- modern — clean geometric, sans-serif, minimal
- tech — dark background, neon accent, monospace feel
- playful — rounded shapes, bright colors, friendly
- elegant — serif font, thin lines, sophisticated
- monogram — initials in a circle/shield/hexagon
- icon — simple geometric symbol (no text)
How It Works
- Generates SVG using
svgwrite (pure Python, no dependencies)
- Creates multiple variants: full logo, icon only, wordmark only
- Exports light/dark/mono versions
- Converts to PNG using Pillow (multiple sizes)
- Generates favicon.ico from the PNG set
The SVG Generator Creates
brand/
├── logo-full-light.svg
├── logo-full-dark.svg
├── icon-light.svg
├── icon-dark.svg
├── icon-mono-black.svg
├── icon-mono-white.svg
├── favicon.ico
├── favicon-16.png
├── favicon-32.png
├── favicon-48.png
├── favicon-96.png
├── apple-touch-icon.png (180x180)
├── android-chrome-192.png
├── android-chrome-512.png
├── og-image.png (1200x630)
└── BRAND.md
Level 4: Brand Kit Export
After obtaining a logo (from any level), generate the full brand kit:
python scripts/favicon_generator.py --input ./brand/logo-full-light.svg --output ./brand/
This converts any SVG/PNG into:
- All favicon sizes (16, 32, 48, 96, 180, 192, 512)
- ICO file (multi-size)
- Apple Touch Icon
- Android Chrome icons
- PWA manifest icons
- OG image (1200x630 with padding)
- WebP optimized versions
Level 5: AI Generation (LAST RESORT)
Only proceed here if Levels 1-4 produced nothing satisfactory.
Option A: Generate with image_generate tool
Use the built-in image_generate tool with a crafted prompt:
image_generate(
prompt="[project name] logo, [style] design, clean vector style,
minimalist, suitable for favicon and app icon, white background,
centered composition, professional branding",
aspect_ratio="square"
)
Then run Level 4 on the output to get all formats.
Option B: Give the user prompts for ChatGPT/Gemini
See references/ai-prompts.md for ready-to-use prompts optimized for:
- ChatGPT (DALL-E 3) — best for detailed, realistic logos
- Gemini (Imagen) — best for clean, simple icons
- Midjourney — best for artistic, unique designs
Present these prompts to the user so they can generate in their preferred tool.
Option C: LogoLoom MCP Server
If the user has Node.js 18+, suggest LogoLoom:
npx @mcpware/logoloom
This is an MCP server that:
- Reads your codebase to understand the brand
- Generates clean SVG code (not auto-traced paths)
- Exports 31-file brand kit automatically
- Zero cost, runs locally
The Output: Brand Kit Structure
Every investigation ends with this structure:
brand/
├── LOGO.md # Manifest: source, license, generation method
├── logo-full-light.svg # Primary logo (light bg)
├── logo-full-dark.svg # Dark mode variant
├── icon-only.svg # Icon without text
├── icon-mono.svg # Single color version
├── favicon.ico # Multi-size ICO
├── favicon-{16,32,48,96}.png # Individual favicon sizes
├── apple-touch-icon.png # 180x180
├── android-chrome-{192,512}.png
├── og-image.png # 1200x630
├── twitter-card.png # 1200x600
└── BRAND.md # Colors, typography, usage guidelines
Decision Tree
START
│
├─ Does the project already have a logo somewhere?
│ YES → Download it → Level 4 (brand kit) → DONE
│ NO ↓
│
├─ Can we find a suitable free icon/logo online?
│ YES → Download + customize → Level 4 → DONE
│ NO ↓
│
├─ Can we generate a text-based logo? (initials, name)
│ YES → favicon.io or svg_generator.py → Level 4 → DONE
│ NO ↓
│
├─ Can we generate a geometric SVG logo?
│ YES → svg_generator.py → Level 4 → DONE
│ NO ↓
│
├─ Does the user have a source image to convert?
│ YES → RealFaviconGenerator or favicon_generator.py → DONE
│ NO ↓
│
└─ AI GENERATION (last resort)
├─ image_generate tool → Level 4 → DONE
├─ ChatGPT/Gemini prompts → user generates → Level 4 → DONE
└─ LogoLoom MCP → DONE
Quick Start Examples
"I need a favicon for my project called NightOwl"
- Search: "NightOwl logo" "NightOwl icon" "owl favicon free"
- Check Flaticon, Icons8 for owl icons
- If nothing:
python scripts/svg_generator.py --name "NightOwl" --style modern --symbol owl
- Generate brand kit:
python scripts/favicon_generator.py --input brand/icon-light.svg --output brand/
"Make me a logo for my GitHub repo"
- Search the repo for existing assets (README images, docs/, assets/)
- Check if the org/user has existing branding
- Generate monogram from initials
- Export brand kit including GitHub preview (1280x640)
"I need a complete brand identity"
- Scavenge web for the project name
- Generate SVG logo with svg_generator.py
- Export full brand kit
- Provide AI prompts for refinement if needed
- Generate BRAND.md with color codes and usage guidelines
Scripts
| Script | Purpose | Usage |
|---|
scripts/logo_hunter.py | Search web for existing logos/icons | --name "X" --topic "Y" |
scripts/svg_generator.py | Generate SVG logos programmatically | --name "X" --style modern |
scripts/favicon_generator.py | Convert any image to full favicon set | --input logo.svg --output brand/ |
Boundaries
- Does NOT hire designers or manage design contracts
- Does NOT guarantee uniqueness — advise user to check trademark databases
- Does NOT create photorealistic logos (use AI image tools for that)
- DOES produce clean, scalable SVG as primary output
- DOES work offline for Levels 3-4 (no API needed)
- DOES respect copyright — always check licenses on downloaded assets
Composability — Working With Other Skills
See PROTOCOL.md (SIP) at skills root for full interop contract.
Domain Declaration
domain: craft
composable: true
yields_to: [process]
Logo-favicon owns craft — visual identity assets for projects.
When Logo-Favicon Leads
- Any request for a logo, favicon, icon, or brand kit
- When a new project is created and needs visual identity
- When deploying a website/app and need favicon set
When Logo-Favicon Defers
| Other Skill's Domain | What Logo-Favicon Does |
|---|
| Process (e.g. planner) | Logo-favicon generates assets on demand. Process decides when in the workflow to create them. |
| Content (e.g. blogger) | Logo-favicon provides the visual assets. Content handles where they appear. |
Conflict Signal
⚠️ Craft conflict: logo-favicon generates visual assets, but another skill wants to control visual style. Logo-favicon defers to process for timing, but owns the asset generation itself.
