--- name: baoyu-comic description: Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image generation. Use when user asks to create "知识漫画", "教育漫画", "biography comic", "tutorial comic", or "Logicomix-style comic". version: 1.56.1 metadata: openclaw: homepage: https://github.com/JimLiu/baoyu-skills#baoyu-comic requires: anyBins: - bun - npx ---

Knowledge Comic Creator

Create original knowledge comics with flexible art style × tone combinations.

Usage

/baoyu-comic posts/turing-story/source.md
/baoyu-comic article.md --art manga --tone warm
/baoyu-comic  # then paste content

Options

Visual Dimensions

| Option | Values | Description | |--------|--------|-------------| | --art | ligne-claire (default), manga, realistic, ink-brush, chalk | Art style / rendering technique | | --tone | neutral (default), warm, dramatic, romantic, energetic, vintage, action | Mood / atmosphere | | --layout | standard (default), cinematic, dense, splash, mixed, webtoon | Panel arrangement | | --aspect | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen) | Page aspect ratio | | --lang | auto (default), zh, en, ja, etc. | Output language |

Partial Workflow Options

| Option | Description | |--------|-------------| | --storyboard-only | Generate storyboard only, skip prompts and images | | --prompts-only | Generate storyboard + prompts, skip images | | --images-only | Generate images from existing prompts directory | | --regenerate N | Regenerate specific page(s) only (e.g., 3 or 2,5,8) |

Details: references/partial-workflows.md

Art Styles (画风)

| Style | 中文 | Description | |-------|------|-------------| | ligne-claire | 清线 | Uniform lines, flat colors, European comic tradition (Tintin, Logicomix) | | manga | 日漫 | Large eyes, manga conventions, expressive emotions | | realistic | 写实 | Digital painting, realistic proportions, sophisticated | | ink-brush | 水墨 | Chinese brush strokes, ink wash effects | | chalk | 粉笔 | Chalkboard aesthetic, hand-drawn warmth |

Tones (基调)

| Tone | 中文 | Description | |------|------|-------------| | neutral | 中性 | Balanced, rational, educational | | warm | 温馨 | Nostalgic, personal, comforting | | dramatic | 戏剧 | High contrast, intense, powerful | | romantic | 浪漫 | Soft, beautiful, decorative elements | | energetic | 活力 | Bright, dynamic, exciting | | vintage | 复古 | Historical, aged, period authenticity | | action | 动作 | Speed lines, impact effects, combat |

Preset Shortcuts

Presets with special rules beyond art+tone:

| Preset | Equivalent | Special Rules | |--------|-----------|---------------| | --style ohmsha | --art manga --tone neutral | Visual metaphors, NO talking heads, gadget reveals | | --style wuxia | --art ink-brush --tone action | Qi effects, combat visuals, atmospheric elements | | --style shoujo | --art manga --tone romantic | Decorative elements, eye details, romantic beats |

Compatibility Matrix

| Art Style | ✓✓ Best | ✓ Works | ✗ Avoid | |-----------|---------|---------|---------| | ligne-claire | neutral, warm | dramatic, vintage, energetic | romantic, action | | manga | neutral, romantic, energetic, action | warm, dramatic | vintage | | realistic | neutral, warm, dramatic, vintage | action | romantic, energetic | | ink-brush | neutral, dramatic, action, vintage | warm | romantic, energetic | | chalk | neutral, warm, energetic | vintage | dramatic, action, romantic |

Details: references/auto-selection.md

Auto Selection

Content signals determine default art + tone + layout (or preset):

| Content Signals | Recommended | |-----------------|-------------| | Tutorial, how-to, programming, educational | ohmsha preset | | Pre-1950, classical, ancient | realistic + vintage | | Personal story, mentor | ligne-claire + warm | | Martial arts, wuxia | wuxia preset | | Romance, school life | shoujo preset | | Biography, balanced | ligne-claire + neutral |

When preset is recommended: Load references/presets/{preset}.md and apply all special rules.

Details: references/auto-selection.md

Script Directory

Important: All scripts are located in the scripts/ subdirectory of this skill.

Agent Execution Instructions:

1. Determine this SKILL.md file's directory path as {baseDir}
2. Script path = {baseDir}/scripts/.ts
3. Replace all {baseDir} in this document with the actual path
4. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun

Script Reference: | Script | Purpose | |--------|---------| | scripts/merge-to-pdf.ts | Merge comic pages into PDF |

File Structure

Output directory: comic/{topic-slug}/

• Slug: 2-4 words kebab-case from topic (e.g., alan-turing-bio)
• Conflict: append timestamp (e.g., turing-story-20260118-143052)

Contents: | File | Description | |------|-------------| | source-{slug}.{ext} | Source files | | analysis.md | Content analysis | | storyboard.md | Storyboard with panel breakdown | | characters/characters.md | Character definitions | | characters/characters.png | Character reference sheet | | prompts/NN-{cover\|page}-[slug].md | Generation prompts | | NN-{cover\|page}-[slug].png | Generated images | | {topic-slug}.pdf | Final merged PDF |

Language Handling

Detection Priority:

1. --lang flag (explicit)
2. EXTEND.md language setting
3. User's conversation language
4. Source content language

Rule: Use user's input language or saved language preference for ALL interactions:

• Storyboard outlines and scene descriptions
• Image generation prompts
• User selection options and confirmations
• Progress updates, questions, errors, summaries

Technical terms remain in English.

Workflow

Progress Checklist

Comic Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Preferences (EXTEND.md) ⛔ BLOCKING
    - [ ] Found → load preferences → continue
    - [ ] Not found → run first-time setup → MUST complete before other steps
  - [ ] 1.2 Analyze, 1.3 Check existing
- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
- [ ] Step 3: Generate storyboard + characters
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images ⚠️ CHARACTER REF REQUIRED
  - [ ] 7.1 Generate character sheet FIRST → characters/characters.png
  - [ ] 7.2 Generate pages WITH --ref characters/characters.png
- [ ] Step 8: Merge to PDF
- [ ] Step 9: Completion report

Flow

Input → [Preferences] ─┬─ Found → Continue
                       │
                       └─ Not found → First-Time Setup ⛔ BLOCKING
                                      │
                                      └─ Complete setup → Save EXTEND.md → Continue
                                                                              │
        ┌─────────────────────────────────────────────────────────────────────┘
        ↓
Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete

Step Summary

...