shalevamin/cover-image

Cover Image Generator

Generate hand-drawn style cover images for articles with multiple style options.

Usage

# From markdown file (auto-select style based on content)
/cover-image path/to/article.md

# Specify a style
/cover-image path/to/article.md --style blueprint
/cover-image path/to/article.md --style warm
/cover-image path/to/article.md --style dark-atmospheric

# Without title text
/cover-image path/to/article.md --no-title

# Combine options
/cover-image path/to/article.md --style minimal --no-title

# From direct text input
/cover-image
[paste content or describe topic]

# Direct input with style
/cover-image --style playful
[paste content]

Options

| Option | Description | |--------|-------------| | --style <name> | Specify cover style (see Style Gallery below) | | --aspect <ratio> | Aspect ratio: 2.35:1 (cinematic, default), 16:9 (widescreen), 1:1 (social) | | --lang <code> | Output language for title text (en, zh, ja, etc.) | | --no-title | Generate cover without title text (visual only) |

Style Gallery

| Style | Description | |-------|-------------| | elegant (Default) | Refined, sophisticated, understated | | flat-doodle | Bold outlines, pastel colors, cute rounded shapes | | blueprint | Technical schematics, engineering precision | | bold-editorial | Magazine cover impact, dramatic typography | | chalkboard | Black chalkboard, colorful chalk drawings | | dark-atmospheric | Cinematic dark mode, glowing accents | | editorial-infographic | Magazine explainer, visual storytelling | | fantasy-animation | Ghibli/Disney inspired, whimsical charm | | intuition-machine | Technical briefing, bilingual labels | | minimal | Ultra-clean, zen-like, focused | | nature | Organic, calm, earthy | | notion | Clean SaaS dashboard, productivity styling | | pixel-art | Retro 8-bit, nostalgic gaming aesthetic | | playful | Fun, creative, whimsical | | retro | Halftone dots, vintage badges, classic | | sketch-notes | Hand-drawn, educational, warm | | vector-illustration | Flat vector, black outlines, retro colors | | vintage | Aged paper, historical, expedition style | | warm | Friendly, approachable, human-centered | | watercolor | Soft hand-painted, natural warmth |

Detailed style definitions: references/styles/<style>.md

Auto Style Selection

When no --style is specified, system analyzes content to select best style:

| Content Signals | Selected Style | |----------------|----------------| | Architecture, system design, engineering | blueprint | | Product launch, keynote, marketing, brand | bold-editorial | | Education, classroom, tutorial, teaching | chalkboard | | Entertainment, creative, premium, cinematic | dark-atmospheric | | Technology explainer, science, research | editorial-infographic | | Storytelling, children, fantasy, magical | fantasy-animation | | Technical docs, academic, bilingual | intuition-machine | | Personal story, emotion, growth, life | warm | | Simple, zen, focus, essential | minimal | | Fun, easy, beginner, casual | playful | | Nature, eco, wellness, health, organic | nature | | Pop culture, 80s/90s nostalgia, badges | retro | | Product, SaaS, dashboard, productivity | notion | | Productivity, workflow, app, tools, cute | flat-doodle | | Gaming, retro tech, developer, 8-bit | pixel-art | | Educational, tutorial, knowledge sharing | sketch-notes | | Creative proposals, brand, toy-like | vector-illustration | | History, exploration, heritage, biography | vintage | | Lifestyle, travel, food, personal | watercolor | | Business, professional, strategy, analysis | elegant |

File Management

Output Directory

Each session creates an independent directory named by content slug:

cover-image/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── prompts/
│   └── cover.md
└── cover.png

Slug Generation:

1. Extract main topic from content (2-4 words, kebab-case)
2. Example: "The Future of AI" → future-of-ai

Conflict Resolution

If cover-image/{topic-slug}/ already exists:

• Append timestamp: {topic-slug}-YYYYMMDD-HHMMSS
• Example: ai-future exists → ai-future-20260118-143052

Source Files

Copy all sources with naming source-{slug}.{ext}:

• source-article.md (main text content)
• source-logo.png (image from conversation)

Multiple sources supported: text, images, files from conversation.

Workflow

Step 1: Analyze Content

1. Save source content (if not already a file):

   • If user provides a file path: use as-is
   • If user pastes content: save to source.md in target directory

2. Extract key information:

   • Main topic: What is the article about?
   • Core message: What's the key takeaway?
   • Tone: Serious, playful, inspiring, educational?
   • Keywords: Identify style-signaling words

3. Language detection:

   • Detect source language from content
   • Detect user language from conversation context
   • Note if source_language ≠ user_language (will ask in Step 3)

Step 2: Determine Options

1. Style selection:

   • If --style specified, use that style
   • Otherwise, scan content for style signals and auto-select 3 candidates
   • Default to elegant if no clear signals

2. Aspect ratio:

   • If --aspect specified, use that ratio
   • Otherwise, prepare options: 2.35:1 (cinematic), 16:9 (widescreen), 1:1 (social)

Step 3: Confirm Options

Purpose: Let user confirm all options in a single step before generation.

IMPORTANT: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.

Determine which questions to ask:

| Question | When to Ask | |----------|-------------| | Style | Always (required) | | Aspect ratio | Always (offer common options) | | Language | Only if source_language ≠ user_language |

Present options (use AskUserQuestion with all applicable questions):

Question 1 (Style) - always:

• Style A (recommended): [style name] - [brief description]
• Style B: [style name] - [brief description]
• Style C: [style name] - [brief description]
• Custom: Provide custom style reference

Question 2 (Aspect) - always:

• 2.35:1 Cinematic (Recommended) - ultra-wide, dramatic
• 16:9 Widescreen - standard video/presentation
• 1:1 Square - social media optimized

Question 3 (Language) - only if source ≠ user language:

• [Source language] (matches content)
• [User language] (your preference)

Language handling:

• If source language = user language: Just inform user (e.g., "Title will be in Chinese")
• If different: Ask which language to use for title text

Step 4: Generate Cover Concept

Create a cover image concept based on selected style:

Title (if included, max 8 characters):

• Distill the core message into a punchy headline
• Use hooks: numbers, questions, contrasts, pain points
• Skip if --no-title flag is used

Visual Elements:

• Style-appropriate imagery and icons
• 1-2 symbolic elements representing the topic
• Metaphors or analogies that fit the style

Step 5: Create Prompt File

Save prompt to prompts/cover.md with confirmed options.

All prompts are written in the user's confirmed language preference.

Prompt Format:

Cover theme: [topic in 2-3 words]
Style: [selected style name]
Aspect ratio: [confirmed aspect ratio]

[If title included:]
Title text: [8 characters or less, in confirmed language]
Subtitle: [optional, in confirmed language]

Visual composition:
- Main visual: [description matching style]
- Layout: [positioning based on title inclusion and aspect ratio]
- Decorative elements: [style-appropriate elements]

Color scheme:
- Primary: [style primary color]
- Background: [style background color]
- Accent: [style accent color]

Style notes: [specific style characteristics to emphasize]

[If no title:]
Note: No title text, pure visual illustration only.

Step 6: Generate Image

Image Generation Skill Selection:

1. Check available image generation skills
2. If multiple skills available, ask user to choose

Generation: Call selected image generation skill with prompt file, output path, and confirmed aspect ratio.

Step 7: Output Summary

Cover Image Generated!

Topic: [topic]
Style: [style name]
Aspect: [aspect ratio]
Title: [cover title] (or "No title - visual only")
Language: [confirmed language]
Location: [output path]

Preview the image to verify it matches your expectations.

Notes

• Cover should be instantly understandable at small preview sizes
• Title (if included) must be readable and impactful
• Visual metaphors work better than literal representations
• Maintain style consistency throughout the cover
• Image generation typically takes 10-30 seconds
• Title text uses user's confirmed language preference
• Aspect ratio: 2.35:1 for cinematic/dramatic, 16:9 for widescreen, 1:1 for social media

Extension Support

Custom styles and configurations via EXTEND.md.

Check paths (priority order):

1. .content-gen-skills/cover-image/EXTEND.md (project)
2. ~/.content-gen-skills/cover-image/EXTEND.md (user)

If found, load before Step 1. Extension content overrides defaults.