# web-asset-generator

Adopt this skill: https://proskills.md/skills/other/alonw0-web-asset-generator-skills-web-asset-generator

Page: https://proskills.md/skills/other/alonw0-web-asset-generator-skills-web-asset-generator
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/web-asset-generator/SKILL.md
size: 8033
upstream: https://github.com/alonw0/web-asset-generator/blob/main/skills/web-asset-generator/SKILL.md

````text
---
name: web-asset-generator
description: Generate web assets including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Use when users need icons, favicons, social sharing images, or Open Graph images from logos or text slogans. Handles image resizing, text-to-image generation, and provides proper HTML meta tags.
---

# Web Asset Generator

Generate professional web assets from logos or text slogans, including favicons, app icons, and social media meta images.

## Quick Start

When a user requests web assets:

1. **Use AskUserQuestion tool to clarify needs** if not specified:
   - What type of assets they need (favicons, app icons, social images, or everything)
   - Whether they have source material (logo image vs text/slogan)
   - For text-based images: color preferences

2. **Check for source material**:
   - If user uploaded an image: use it as the source
   - If user provides text/slogan: generate text-based images

3. **Run the appropriate script(s)**:
   - Favicons/icons: `scripts/generate_favicons.py`
   - Social media images: `scripts/generate_og_images.py`

4. **Provide the generated assets and HTML tags** to the user

## Using Interactive Questions

**IMPORTANT**: Always use the AskUserQuestion tool to gather requirements instead of plain text questions. This provides a better user experience with visual selection UI.

### Why Use AskUserQuestion?

✅ **Visual UI**: Users see options as clickable chips/tags instead of typing responses
✅ **Faster**: Click to select instead of typing out answers
✅ **Clearer**: Descriptions explain what each option means
✅ **Fewer errors**: No typos or misunderstandings from free-form text
✅ **Professional**: Consistent with modern Claude Code experience

### Example Flow

**User request**: "I need web assets"

**Claude uses AskUserQuestion** (not plain text):
```
What type of web assets do you need?                    [Asset type]
○ Favicons only - Browser tab icons (16x16, 32x32, 96x96) and favicon.ico
○ App icons only - PWA icons for iOS/Android (180x180, 192x192, 512x512)
○ Social images only - Open Graph images for Facebook, Twitter, WhatsApp, LinkedIn
● Everything - Complete package: favicons + app icons + social images
```

User clicks → Claude immediately knows what to generate

### Question Patterns

Below are the standard question patterns to use in various scenarios. Copy the structure and adapt as needed.

### Question Pattern 1: Asset Type Selection

When the user's request is vague (e.g., "create web assets", "I need icons"), use AskUserQuestion:

**Question**: "What type of web assets do you need?"
**Header**: "Asset type"
**Options**:
- **"Favicons only"** - Description: "Browser tab icons (16x16, 32x32, 96x96) and favicon.ico"
- **"App icons only"** - Description: "PWA icons for iOS/Android (180x180, 192x192, 512x512)"
- **"Social images only"** - Description: "Open Graph images for Facebook, Twitter, WhatsApp, LinkedIn"
- **"Everything"** - Description: "Complete package: favicons + app icons + social images"

### Question Pattern 2: Source Material

When the asset type is determined but source is unclear:

**Question**: "What source material will you provide?"
**Header**: "Source"
**Options**:
- **"Logo image"** - Description: "I have or will upload a logo/image file"
- **"Emoji"** - Description: "Generate favicon from an emoji character"
- **"Text/slogan"** - Description: "Create images from text only"
- **"Logo + text"** - Description: "Combine logo with text overlay (for social images)"

### Question Pattern 3: Platform Selection (for social images)

When user requests social images but doesn't specify platforms:

**Question**: "Which social media platforms do you need images for?"
**Header**: "Platforms"
**Multi-select**: true
**Options**:
- **"Facebook/WhatsApp/LinkedIn"** - Description: "Standard 1200x630 Open Graph format"
- **"Twitter"** - Description: "1200x675 (16:9 ratio) for large image cards"
- **"All platforms"** - Description: "Generate all variants including square format"

### Question Pattern 4: Color Preferences (for text-based images)

When generating text-based social images:

**Question**: "What colors should we use for your social images?"
**Header**: "Colors"
**Options**:
- **"I'll provide colors"** - Description: "Let me specify exact hex codes for brand colors"
- **"Default theme"** - Description: "Use default purple background (#4F46E5) with white text"
- **"Extract from logo"** - Description: "Auto-detect brand colors from uploaded logo"
- **"Custom gradient"** - Description: "Let me choose gradient colors"

### Question Pattern 5: Icon Type Clarification

When user says "create icons" or "generate icons" (ambiguous):

**Question**: "What kind of icons do you need?"
**Header**: "Icon type"
**Options**:
- **"Website favicon"** - Description: "Small browser tab icon"
- **"App icons (PWA)"** - Description: "Mobile home screen icons"
- **"Both"** - Description: "Favicon + app icons"

### Question Pattern 6: Emoji Selection

When user selects "Emoji" as source material:

**Step 1**: Ask for project description (free text):
- "What is your website/app about?"
- Use this to generate emoji suggestions

**Step 2**: Use AskUserQuestion to present the 4 suggested emojis:

**Question**: "Which emoji best represents your project?"
**Header**: "Emoji"
**Options**: (Dynamically generated based on project description)
- Example: **"🚀 Rocket"** - Description: "Rocket, launch, startup, space"
- Example: **"☕ Coffee"** - Description: "Coffee, cafe, beverage, drink"
- Example: **"💻 Laptop"** - Description: "Computer, laptop, code, dev"
- Example: **"🎨 Art"** - Description: "Art, design, creative, paint"

**Implementation**:
```bash
# Get suggestions
python scripts/generate_favicons.py --suggest "coffee shop" output/ all

# Then generate with selected emoji
python scripts/generate_favicons.py --emoji "☕" output/ all
```

**Optional**: Ask about background color for app icons:

**Question**: "Do you want a background color for app icons?"
**Header**: "Background"
**Options**:
- **"Transparent"** - Description: "No background (favicons only)"
- **"White"** - Description: "White background (recommended for app icons)"
- **"Custom color"** - Description: "I'll provide a color"

### Question Pattern 7: Code Integration Offer

**When to use**: After generating assets and showing HTML tags to the user

**Question**: "Would you like me to add these HTML tags to your codebase?"
**Header**: "Integration"
**Options**:
- **"Yes, auto-detect my setup"** - Description: "Find and update my HTML/framework files automatically"
- **"Yes, I'll tell you where"** - Description: "I'll specify which file to update"
- **"No, I'll do it manually"** - Description: "Just show me the code, I'll add it myself"

**If user selects "Yes, auto-detect":**
1. Search for framework config files (next.config.js, astro.config.mjs, etc.)
2. Detect framework type
3. Find appropriate target file (layout.tsx, index.html, etc.)
4. Show detected file and ask for confirmation
5. Show diff of proposed changes
6. Insert tags if user confirms

**If user selects "Yes, I'll tell you where":**
1. Ask user for file path
2. Verify file exists
3. Show diff of proposed changes
4. Insert tags if user confirms

**Framework Detection Priority:**
- Next.js: Look for `next.config.js`, update `app/layout.tsx` or `pages/_app.tsx`
- Astro: Look for `astro.config.mjs`, update layout files in `src/layouts/`
- SvelteKit: Look for `svelte.config.js`, update `src/app.html`
- Vue/Nuxt: Look for `nuxt.config.js`, update `app.vue` or `nuxt.config.ts`
- Plain HTML: Look for `index.html` or `*.html` files
- Gatsby: Look for `gatsby-config.js`, update `gatsby-ssr.js`

### Question Pattern 8: Testing Links Offer

**When to use**: After code integration (or if user declined integration)

**Question**: "Would you like to test your meta tags now?"
**Header**: "Testing"
**Options**:
- **"Facebo
````

## File: README.md
upstream: https://github.com/alonw0/web-asset-generator/blob/main/README.md

````text
# Web Asset Generator - Claude Code Skill

> 🎨 A Claude Code Skill for generating favicons, app icons, and social media images

Talk to Claude naturally to create production-ready web assets from logos, text, or emojis!

[![Claude Code](https://img.shields.io/badge/Claude-Code_Skill-violet)](https://claude.ai/code)
[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)

## What is This?

This is a **Claude Code Skill** - a modular capability that extends Claude's functionality. When installed, Claude can automatically generate web assets through natural conversation.

**Example conversation:**

> **You:** "Create a favicon for my coffee shop website"
>
> **Claude:**
> - Suggests relevant emojis (☕ Coffee, 🏪 Store)
> - Generates all icon sizes (16×16 through 512×512)
> - Validates files and checks accessibility
> - Detects your framework (Next.js, Astro, etc.)
> - Offers to add HTML tags to your code
> - Provides testing validator links

No manual work needed - just ask Claude!

## 🎬 Demo

See the skill in action:

https://github.com/user-attachments/assets/99b37698-98ec-42fe-87aa-f96b86edc00b

<video src="https://github.com/alonw0/web-asset-generator/raw/main/demo.mp4" width="100%" controls>
  Your browser doesn't support video playback. <a href="https://github.com/alonw0/web-asset-generator/raw/main/demo.mp4">Download the demo video</a>.
</video>

*Watch Claude automatically generate favicons, validate them, and integrate them into your project!*

## 🚀 Quick Start

### 1. Prerequisites

- [Claude Code](https://claude.ai/code) 2.0.13 or later
- Python 3.6+ with pip

### 2. Install the Plugin

**Recommended: Via Plugin Marketplace**

The easiest way to install:

```
/plugins marketplace add alonw0/web-asset-generator
and then
/plugin install web-asset-generator@web-asset-generator-marketplace
```

Then install dependencies:
```bash
pip install Pillow

# Optional: For emoji support
pip install pilmoji 'emoji<2.0.0'
```

**Alternative: Manual Installation**

<details>
<summary>Click to expand manual installation steps</summary>

Clone this repository:
```bash
git clone https://github.com/alonw0/web-asset-generator.git
cd web-asset-generator
```

Copy the skill folder to Claude's skills directory:
```bash
# macOS/Linux
cp -r skills/web-asset-generator ~/.claude/skills/

# Windows
xcopy /E /I skills\web-asset-generator %USERPROFILE%\.claude\skills\web-asset-generator
```

Install dependencies:
```bash
pip install Pillow
pip install pilmoji 'emoji<2.0.0'  # Optional
```

</details>

### 3. Restart Claude Code

After installation, restart Claude Code to load the plugin.

### 4. Use It!

Open Claude Code and try:
- "Create a favicon with a rocket emoji"
- "Generate Open Graph images for my blog"
- "Make app icons from my logo.png"

Claude will automatically invoke this skill and guide you through the process!

## ✨ Features

- **Favicons** - Browser icons (16×16, 32×32, 96×96, favicon.ico)
- **App Icons** - PWA/mobile icons (180×180, 192×192, 512×512)
- **PWA Manifest** - Auto-generate manifest.json with icons, colors, and settings
- **Social Images** - Open Graph for Facebook, Twitter, LinkedIn (1200×630, 1200×675)
- **Emoji Support** - 60+ curated emojis with smart suggestions
- **Validation** - File sizes, dimensions, formats, WCAG contrast compliance
- **Auto-Integration** - Framework detection and code insertion
- **Interactive** - Question-based workflow using Claude's UI

## 📸 Examples

<table>
<tr>
<td width="50%">
<img src="docs/examples/rocket-emoji.png" alt="Rocket emoji favicon" width="128">
<br>
<b>Emoji Favicon</b><br>
Generated from 🚀 with custom background
</td>
<td width="50%">
<img src="docs/examples/text-og-image.png" alt="Text-based social image" width="400">
<br>
<b>Social Media Image</b><br>
Text with dynamic font sizing
</td>
</tr>
</table>

## 📁 Repository Structure

```
web-asset-generator/                    # Repository root
├── README.md                           # This file
├── CONTRIBUTING.md                     # How to contribute
├── LICENSE                             # MIT License
├── CHANGELOG.md                        # Version history
├── .claude-plugin/                     # Plugin metadata
│   └── plugin.json                     # Plugin manifest
├── marketplace.json                    # Marketplace distribution
├── docs/                               # Documentation & examples
└── skills/                             # Skills directory
    └── web-asset-generator/           # ⭐ THE SKILL (copy this folder)
        ├── SKILL.md                    # Skill definition (Claude reads this)
        ├── CLAUDE.md                   # Development guidance
        ├── scripts/
        │   ├── generate_favicons.py    # Favicon generator
        │   ├── generate_og_images.py   # Social image generator
        │   ├── emoji_utils.py          # Emoji utilities
        │   ├── check_dependencies.py   # Dependency checker
        │   └── lib/
        │       └── validators.py       # Validation system
        └── references/
            └── specifications.md       # Platform specs
```

**To install:** Copy the `skills/web-asset-generator/` folder to `~/.claude/skills/`

## 💬 Usage Examples

Once installed, use natural language:

### Favicon Generation
```
"Create a favicon for my tech startup"
"Generate app icons from my logo.png"
"Make a favicon using a rocket emoji"
"I need PWA icons for my website"
```

### Social Media Images
```
"Create Open Graph images for my blog"
"Generate Twitter card with my tagline"
"Make social sharing images from my logo"
"Create Facebook preview with custom colors"
```

### Emoji Features
```
"Suggest emojis for my coffee shop"
"Show me good emojis for a fitness app"
"Create favicon from emoji representing growth"
```

### With Validation
```
"Generate favicons and validate them"
"Create social images and check accessibility"
"Make Open Graph images and verify file sizes"
```

## 🛠️ Advanced: Direct Script Usage

You can also use the scripts directly without Claude:

```bash
cd ~/.claude/skills/web-asset-generator

# Generate from emoji
python scripts/generate_favicons.py --emoji "🚀" output/ all

# Generate social images
python scripts/generate_og_images.py output/ --text "Welcome"

# Check dependencies
python scripts/check_dependencies.py
```

See `skills/web-asset-generator/CLAUDE.md` for complete script documentation.

## 🔧 Troubleshooting

### Skill Not Working

1. Verify installation:
   ```bash
   ls ~/.claude/skills/web-asset-generator/SKILL.md
   ```

2. Check dependencies:
   ```bash
   cd ~/.claude/skills/web-asset-generator
   python scripts/check_dependencies.py
   ```

3. Restart Claude Code

4. Your request should include keywords like "favicon", "icon", "social image", or "Open Graph"

### Emoji Not Working

Pilmoji requires `emoji<2.0.0`:
```bash
pip install 'emoji<2.0.0'
```

### Claude Doesn't Invoke the Skill

- Ensure `SKILL.md` is in the skill folder
- Restart Claude Code after installation
- Try explicit requests like "create a favicon"
- Check that the skill folder is named `web-asset-generator`

## 📚 Documentation

- **[PLUGIN_INSTALLATION.md](PLUGIN_INSTALLATION.md)** - Detailed plugin installation guide
- **[skills/web-asset-generator/SKILL.md](skills/web-asset-generator/SKILL.md)** - Complete Skill instructions
- **[skills/web-asset-generator/CLAUDE.md](skills/web-asset-generator/CLAUDE.md)** - Development guide
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Contribution guidelines
- **[CHANGELOG.md](CHANGELOG.md)** - Version history

## 🤝 Contributing

Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for:
- Development setup
- Code standards
- Testing guidelines
- Pull request process

**Priority areas:**
- Add
````
