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 (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
| Step |
Action |
Key Output |
| 1.1 |
Load EXTEND.md preferences ⛔ BLOCKING if not found |
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:
- Backup rule: If
characters/characters.png exists, rename to characters/characters-backup-YYYYMMDD-HHMMSS.png
# 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:
| Skill Capability |
Strategy |
Supports --ref |
Pass characters/characters.png with EVERY page |
No --ref support |
Prepend character descriptions to EVERY prompt file |
Backup rules for page generation:
- If prompt file exists: rename to
prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md
- If image file exists: rename to
NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png
# 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 ⛔ BLOCKING
CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about art style, do NOT ask about tone — ONLY complete the preferences setup first.
| Path |
Location |
.baoyu-skills/baoyu-comic/EXTEND.md |
Project directory |
$HOME/.baoyu-skills/baoyu-comic/EXTEND.md |
User home |
| Result |
Action |
| Found |
Read, parse, display summary → Continue |
| Not found |
⛔ BLOCKING: Run first-time setup ONLY (references/config/first-time-setup.md) → Complete and save EXTEND.md → Then continue |
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
Page Modification
| Action |
Steps |
| Edit |
Update prompt file FIRST → --regenerate N → Regenerate PDF |
| Add |
Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF |
| Delete |
Remove files → Renumber subsequent → Update storyboard → Regenerate PDF |
IMPORTANT: When updating pages, ALWAYS update the prompt file (prompts/NN-{cover|page}-[slug].md) FIRST before regenerating. This ensures changes are documented and reproducible.
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
1---2id: "1c8deb5c-f7f2-5295-9fe1-bf0cf7d5275a"3name: baoyu-comic4description: 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".5metadata:6 source: https://skillmd.com/skills/ecnu-icalk/baoyu-comic7---89# Knowledge Comic Creator1011Create original knowledge comics with flexible art style × tone combinations.1213## Usage1415```bash16/baoyu-comic posts/turing-story/source.md17/baoyu-comic article.md --art manga --tone warm18/baoyu-comic # then paste content19```2021## Options2223### Visual Dimensions2425| Option | Values | Description |26|--------|--------|-------------|27| `--art` | ligne-claire (default), manga, realistic, ink-brush, chalk | Art style / rendering technique |28| `--tone` | neutral (default), warm, dramatic, romantic, energetic, vintage, action | Mood / atmosphere |29| `--layout` | standard (default), cinematic, dense, splash, mixed, webtoon | Panel arrangement |30| `--aspect` | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen) | Page aspect ratio |31| `--lang` | auto (default), zh, en, ja, etc. | Output language |3233### Partial Workflow Options3435| Option | Description |36|--------|-------------|37| `--storyboard-only` | Generate storyboard only, skip prompts and images |38| `--prompts-only` | Generate storyboard + prompts, skip images |39| `--images-only` | Generate images from existing prompts directory |40| `--regenerate N` | Regenerate specific page(s) only (e.g., `3` or `2,5,8`) |4142Details: [references/partial-workflows.md](references/partial-workflows.md)4344### Art Styles (画风)4546| Style | 中文 | Description |47|-------|------|-------------|48| `ligne-claire` | 清线 | Uniform lines, flat colors, European comic tradition (Tintin, Logicomix) |49| `manga` | 日漫 | Large eyes, manga conventions, expressive emotions |50| `realistic` | 写实 | Digital painting, realistic proportions, sophisticated |51| `ink-brush` | 水墨 | Chinese brush strokes, ink wash effects |52| `chalk` | 粉笔 | Chalkboard aesthetic, hand-drawn warmth |5354### Tones (基调)5556| Tone | 中文 | Description |57|------|------|-------------|58| `neutral` | 中性 | Balanced, rational, educational |59| `warm` | 温馨 | Nostalgic, personal, comforting |60| `dramatic` | 戏剧 | High contrast, intense, powerful |61| `romantic` | 浪漫 | Soft, beautiful, decorative elements |62| `energetic` | 活力 | Bright, dynamic, exciting |63| `vintage` | 复古 | Historical, aged, period authenticity |64| `action` | 动作 | Speed lines, impact effects, combat |6566### Preset Shortcuts6768Presets with special rules beyond art+tone:6970| Preset | Equivalent | Special Rules |71|--------|-----------|---------------|72| `--style ohmsha` | `--art manga --tone neutral` | Visual metaphors, NO talking heads, gadget reveals |73| `--style wuxia` | `--art ink-brush --tone action` | Qi effects, combat visuals, atmospheric elements |74| `--style shoujo` | `--art manga --tone romantic` | Decorative elements, eye details, romantic beats |7576### Compatibility Matrix7778| Art Style | ✓✓ Best | ✓ Works | ✗ Avoid |79|-----------|---------|---------|---------|80| ligne-claire | neutral, warm | dramatic, vintage, energetic | romantic, action |81| manga | neutral, romantic, energetic, action | warm, dramatic | vintage |82| realistic | neutral, warm, dramatic, vintage | action | romantic, energetic |83| ink-brush | neutral, dramatic, action, vintage | warm | romantic, energetic |84| chalk | neutral, warm, energetic | vintage | dramatic, action, romantic |8586Details: [references/auto-selection.md](references/auto-selection.md)8788## Auto Selection8990Content signals determine default art + tone + layout (or preset):9192| Content Signals | Recommended |93|-----------------|-------------|94| Tutorial, how-to, programming, educational | **ohmsha** preset |95| Pre-1950, classical, ancient | realistic + vintage |96| Personal story, mentor | ligne-claire + warm |97| Martial arts, wuxia | **wuxia** preset |98| Romance, school life | **shoujo** preset |99| Biography, balanced | ligne-claire + neutral |100101**When preset is recommended**: Load `references/presets/{preset}.md` and apply all special rules.102103Details: [references/auto-selection.md](references/auto-selection.md)104105## Script Directory106107**Important**: All scripts are located in the `scripts/` subdirectory of this skill.108109**Agent Execution Instructions**:1101. Determine this SKILL.md file's directory path as `SKILL_DIR`1112. Script path = `${SKILL_DIR}/scripts/<script-name>.ts`1123. Replace all `${SKILL_DIR}` in this document with the actual path113114**Script Reference**:115| Script | Purpose |116|--------|---------|117| `scripts/merge-to-pdf.ts` | Merge comic pages into PDF |118119## File Structure120121Output directory: `comic/{topic-slug}/`122- Slug: 2-4 words kebab-case from topic (e.g., `alan-turing-bio`)123- Conflict: append timestamp (e.g., `turing-story-20260118-143052`)124125**Contents**:126| File | Description |127|------|-------------|128| `source-{slug}.{ext}` | Source files |129| `analysis.md` | Content analysis |130| `storyboard.md` | Storyboard with panel breakdown |131| `characters/characters.md` | Character definitions |132| `characters/characters.png` | Character reference sheet |133| `prompts/NN-{cover\|page}-[slug].md` | Generation prompts |134| `NN-{cover\|page}-[slug].png` | Generated images |135| `{topic-slug}.pdf` | Final merged PDF |136137## Language Handling138139**Detection Priority**:1401. `--lang` flag (explicit)1412. EXTEND.md `language` setting1423. User's conversation language1434. Source content language144145**Rule**: Use user's input language or saved language preference for ALL interactions:146- Storyboard outlines and scene descriptions147- Image generation prompts148- User selection options and confirmations149- Progress updates, questions, errors, summaries150151Technical terms remain in English.152153## Workflow154155### Progress Checklist156157```158Comic Progress:159- [ ] Step 1: Setup & Analyze160 - [ ] 1.1 Preferences (EXTEND.md) ⛔ BLOCKING161 - [ ] Found → load preferences → continue162 - [ ] Not found → run first-time setup → MUST complete before other steps163 - [ ] 1.2 Analyze, 1.3 Check existing164- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED165- [ ] Step 3: Generate storyboard + characters166- [ ] Step 4: Review outline (conditional)167- [ ] Step 5: Generate prompts168- [ ] Step 6: Review prompts (conditional)169- [ ] Step 7: Generate images ⚠️ CHARACTER REF REQUIRED170 - [ ] 7.1 Generate character sheet FIRST → characters/characters.png171 - [ ] 7.2 Generate pages WITH --ref characters/characters.png172- [ ] Step 8: Merge to PDF173- [ ] Step 9: Completion report174```175176### Flow177178```179Input → [Preferences] ─┬─ Found → Continue180 │181 └─ Not found → First-Time Setup ⛔ BLOCKING182 │183 └─ Complete setup → Save EXTEND.md → Continue184 │185 ┌─────────────────────────────────────────────────────────────────────┘186 ↓187Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete188```189190### Step Summary191192| Step | Action | Key Output |193|------|--------|------------|194| 1.1 | Load EXTEND.md preferences ⛔ BLOCKING if not found | Config loaded |195| 1.2 | Analyze content | `analysis.md` |196| 1.3 | Check existing directory | Handle conflicts |197| 2 | Confirm style, focus, audience, reviews | User preferences |198| 3 | Generate storyboard + characters | `storyboard.md`, `characters/` |199| 4 | Review outline (if requested) | User approval |200| 5 | Generate prompts | `prompts/*.md` |201| 6 | Review prompts (if requested) | User approval |202| **7.1** | **Generate character sheet FIRST** | `characters/characters.png` |203| **7.2** | Generate pages **with character ref** | `*.png` files |204| 8 | Merge to PDF | `{slug}.pdf` |205| 9 | Completion report | Summary |206207### Step 7: Image Generation ⚠️ CRITICAL208209**Character reference is MANDATORY for visual consistency.**210211**7.1 Generate character sheet first**:212- **Backup rule**: If `characters/characters.png` exists, rename to `characters/characters-backup-YYYYMMDD-HHMMSS.png`213```bash214# Use Reference Sheet Prompt from characters/characters.md215npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \216 --promptfiles characters/characters.md \217 --image characters/characters.png --ar 4:3218```219220**Compress character sheet** (recommended):221Compress to reduce token usage when used as reference image:222- Use available image compression skill (if any)223- Or system tools: `pngquant`, `optipng`, `sips` (macOS)224- **Keep PNG format**, lossless compression preferred225226**7.2 Generate each page WITH character reference**:227228| Skill Capability | Strategy |229|------------------|----------|230| Supports `--ref` | Pass `characters/characters.png` with EVERY page |231| No `--ref` support | Prepend character descriptions to EVERY prompt file |232233**Backup rules for page generation**:234- If prompt file exists: rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`235- If image file exists: rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`236237```bash238# Example: ALWAYS include --ref for consistency239npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \240 --promptfiles prompts/01-page-xxx.md \241 --image 01-page-xxx.png --ar 3:4 \242 --ref characters/characters.png243```244245**Full workflow details**: [references/workflow.md](references/workflow.md)246247### EXTEND.md Paths ⛔ BLOCKING248249**CRITICAL**: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about art style, do NOT ask about tone — ONLY complete the preferences setup first.250251| Path | Location |252|------|----------|253| `.baoyu-skills/baoyu-comic/EXTEND.md` | Project directory |254| `$HOME/.baoyu-skills/baoyu-comic/EXTEND.md` | User home |255256| Result | Action |257|--------|--------|258| Found | Read, parse, display summary → Continue |259| Not found | ⛔ **BLOCKING**: Run first-time setup ONLY ([references/config/first-time-setup.md](references/config/first-time-setup.md)) → Complete and save EXTEND.md → Then continue |260261**EXTEND.md Supports**: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference262263Schema: [references/config/preferences-schema.md](references/config/preferences-schema.md)264265## References266267**Core Templates**:268- [analysis-framework.md](references/analysis-framework.md) - Deep content analysis269- [character-template.md](references/character-template.md) - Character definition format270- [storyboard-template.md](references/storyboard-template.md) - Storyboard structure271- [ohmsha-guide.md](references/ohmsha-guide.md) - Ohmsha manga specifics272273**Style Definitions**:274- `references/art-styles/` - Art styles (ligne-claire, manga, realistic, ink-brush, chalk)275- `references/tones/` - Tones (neutral, warm, dramatic, romantic, energetic, vintage, action)276- `references/presets/` - Presets with special rules (ohmsha, wuxia, shoujo)277- `references/layouts/` - Layouts (standard, cinematic, dense, splash, mixed, webtoon)278279**Workflow**:280- [workflow.md](references/workflow.md) - Full workflow details281- [auto-selection.md](references/auto-selection.md) - Content signal analysis282- [partial-workflows.md](references/partial-workflows.md) - Partial workflow options283284**Config**:285- [config/preferences-schema.md](references/config/preferences-schema.md) - EXTEND.md schema286- [config/first-time-setup.md](references/config/first-time-setup.md) - First-time setup287- [config/watermark-guide.md](references/config/watermark-guide.md) - Watermark configuration288289## Page Modification290291| Action | Steps |292|--------|-------|293| **Edit** | **Update prompt file FIRST** → `--regenerate N` → Regenerate PDF |294| **Add** | Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF |295| **Delete** | Remove files → Renumber subsequent → Update storyboard → Regenerate PDF |296297**IMPORTANT**: When updating pages, ALWAYS update the prompt file (`prompts/NN-{cover|page}-[slug].md`) FIRST before regenerating. This ensures changes are documented and reproducible.298299## Notes300301- Image generation: 10-30 seconds per page302- Auto-retry once on generation failure303- Use stylized alternatives for sensitive public figures304- Maintain style consistency via session ID305- **Step 2 confirmation required** - do not skip306- **Steps 4/6 conditional** - only if user requested in Step 2307- **Step 7.1 character sheet MUST be generated before pages** - ensures consistency308- **Step 7.2 EVERY page MUST reference characters** - use `--ref` or embed descriptions309- Watermark/language configured once in EXTEND.md