Knowledge Comic Creator Skill

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:

Determine this SKILL.md file's directory path as SKILL_DIR
Script path = ${SKILL_DIR}/scripts/<script-name>.ts
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:

--lang flag (explicit)
EXTEND.md language setting
User's conversation language
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 | Action | Key Output | |------|--------|------------| | 1.1 | Load EXTEND.md preferences | Config loaded | | 1.2 | Analyze content | analysis.md | | 1.3 | Check existing directory | Handle conflicts | | 2 | Confirm style, focus, audience, reviews | User preferences | | 3 | Generate storyboard + characters | storyboard.md, characters/ | | 4 | Review outline (if requested) | User approval | | 5 | Generate prompts | prompts/*.md | | 6 | Review prompts (if requested) | User approval | | 7.1 | Generate character sheet FIRST | characters/characters.png | | 7.2 | Generate pages with character ref | *.png files | | 8 | Merge to PDF | {slug}.pdf | | 9 | Completion report | 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

7.2 Generate each page WITH character reference:

| Skill Capability | Strategy | |------------------|----------| | Supports --ref | Pass characters/characters.png with EVERY page | | No --ref support | Prepend character descriptions to EVERY prompt file |

# 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

| Path | Location | |------|----------| | .baoyu-skills/baoyu-comic/EXTEND.md | Project directory | | $HOME/.baoyu-skills/baoyu-comic/EXTEND.md | User home |

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

Agent Skills: Knowledge Comic Creator

Install this agent skill to your local

Skill Files