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".

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

Partial Workflow Options

Details: references/partial-workflows.md

Art Styles (画风)

Tones (基调)

Preset Shortcuts

Presets with special rules beyond art+tone:

Compatibility Matrix

Details: references/auto-selection.md

Auto Selection

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

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 SKILL_DIR
2. Script path = ${SKILL_DIR}/scripts/<script-name>.ts
3. Replace all ${SKILL_DIR} in this document with the actual path

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, 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 → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete

Step Summary

Step 7: Image Generation ⚠️ CRITICAL

Character reference is MANDATORY for visual consistency.

7.1 Generate character sheet first:

# Use Reference Sheet Prompt from characters/characters.md
npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
  --promptfiles characters/characters.md \
  --image characters/characters.png --ar 4:3

Compress character sheet (recommended):
Compress to reduce token usage when used as reference image:
- Use available image compression skill (if any)
- Or system tools: pngquant, optipng, sips (macOS)
- Keep PNG format, lossless compression preferred

7.2 Generate each page WITH character reference:

# Example: ALWAYS include --ref for consistency
npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
  --promptfiles prompts/01-page-xxx.md \
  --image 01-page-xxx.png --ar 3:4 \
  --ref characters/characters.png

Full workflow details: references/workflow.md

EXTEND.md Paths

EXTEND.md Supports: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference

Schema: references/config/preferences-schema.md

References

Core Templates:
- analysis-framework.md - Deep content analysis
- character-template.md - Character definition format
- storyboard-template.md - Storyboard structure
- ohmsha-guide.md - Ohmsha manga specifics

Style Definitions:
- references/art-styles/ - Art styles (ligne-claire, manga, realistic, ink-brush, chalk)
- references/tones/ - Tones (neutral, warm, dramatic, romantic, energetic, vintage, action)
- references/presets/ - Presets with special rules (ohmsha, wuxia, shoujo)
- references/layouts/ - Layouts (standard, cinematic, dense, splash, mixed, webtoon)

Workflow:
- workflow.md - Full workflow details
- auto-selection.md - Content signal analysis
- partial-workflows.md - Partial workflow options

Config:
- config/preferences-schema.md - EXTEND.md schema
- config/first-time-setup.md - First-time setup
- config/watermark-guide.md - Watermark configuration

Notes

• Image generation: 10-30 seconds per page
• Auto-retry once on generation failure
• Use stylized alternatives for sensitive public figures
• Maintain style consistency via session ID
• Step 2 confirmation required - do not skip
• Steps 4/6 conditional - only if user requested in Step 2
• Step 7.1 character sheet MUST be generated before pages - ensures consistency
• Step 7.2 EVERY page MUST reference characters - use --ref or embed descriptions
• Watermark/language configured once in EXTEND.md