Knowledge Comic Creator#

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

Usage#

bash

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

Options#

Visual Dimensions#

OptionValuesDescription--artligne-claire (default), manga, realistic, ink-brush, chalkArt style / rendering technique--toneneutral (default), warm, dramatic, romantic, energetic, vintage, actionMood / atmosphere--layoutstandard (default), cinematic, dense, splash, mixed, webtoonPanel arrangement--aspect3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen)Page aspect ratio--langauto (default), zh, en, ja, etc.Output language

Partial Workflow Options#

OptionDescription--storyboard-onlyGenerate storyboard only, skip prompts and images--prompts-onlyGenerate storyboard + prompts, skip images--images-onlyGenerate images from existing prompts directory--regenerate NRegenerate specific page(s) only (e.g., 3 or 2,5,8)

Details: references/partial-workflows.md

Art Styles (画风)#

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

Tones (基调)#

Tone中文Descriptionneutral中性Balanced, rational, educationalwarm温馨Nostalgic, personal, comfortingdramatic戏剧High contrast, intense, powerfulromantic浪漫Soft, beautiful, decorative elementsenergetic活力Bright, dynamic, excitingvintage复古Historical, aged, period authenticityaction动作Speed lines, impact effects, combat

Preset Shortcuts#

Presets with special rules beyond art+tone:

PresetEquivalentSpecial Rules--style ohmsha``--art manga --tone neutralVisual metaphors, NO talking heads, gadget reveals--style wuxia``--art ink-brush --tone actionQi effects, combat visuals, atmospheric elements--style shoujo``--art manga --tone romanticDecorative elements, eye details, romantic beats

Compatibility Matrix#

Art Style✓✓ Best✓ Works✗ Avoidligne-claireneutral, warmdramatic, vintage, energeticromantic, actionmanganeutral, romantic, energetic, actionwarm, dramaticvintagerealisticneutral, warm, dramatic, vintageactionromantic, energeticink-brushneutral, dramatic, action, vintagewarmromantic, energeticchalkneutral, warm, energeticvintagedramatic, action, romantic

Details: references/auto-selection.md

Auto Selection#

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

Content SignalsRecommendedTutorial, how-to, programming, educationalohmsha presetPre-1950, classical, ancientrealistic + vintagePersonal story, mentorligne-claire + warmMartial arts, wuxiawuxia presetRomance, school lifeshoujo presetBiography, balancedligne-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/<script-name>.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:

ScriptPurposescripts/merge-to-pdf.tsMerge 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:

FileDescriptionsource-{slug}.{ext}Source filesanalysis.mdContent analysisstoryboard.mdStoryboard with panel breakdowncharacters/characters.mdCharacter definitionscharacters/characters.pngCharacter reference sheetprompts/NN-{cover|page}-[slug].mdGeneration promptsNN-{cover|page}-[slug].pngGenerated images{topic-slug}.pdfFinal 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#

text

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#

text

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#

StepActionKey Output1.1Load EXTEND.md preferences ⛔ BLOCKING if not foundConfig loaded1.2Analyze contentanalysis.md1.3Check existing directoryHandle conflicts2Confirm style, focus, audience, reviewsUser preferences3Generate storyboard + charactersstoryboard.md, characters/4Review outline (if requested)User approval5Generate promptsprompts/*.md6Review prompts (if requested)User approval7.1****Generate character sheet FIRSTcharacters/characters.png7.2Generate pages with character ref*.png files8Merge to PDF{slug}.pdf9Completion reportSummary

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
• Invoke an installed image generation skill such as baoyu-image-gen
• Read that skill's SKILL.md and follow its documented interface rather than calling its scripts directly
• Use characters/characters.md as the prompt-file input
• Save output to characters/characters.png
• Use aspect ratio 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 CapabilityStrategySupports --refPass characters/characters.png with EVERY pageNo --ref supportPrepend 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
• Invoke the installed image generation skill for each page
• Use prompts/01-page-xxx.md as the prompt-file input
• Save output to 01-page-xxx.png
• Use aspect ratio 3:4
• If the chosen skill supports reference images, pass characters/characters.png as --ref

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.

PathLocation.baoyu-skills/baoyu-comic/EXTEND.mdProject directory$HOME/.baoyu-skills/baoyu-comic/EXTEND.mdUser homeResultActionFoundRead, parse, display summary → ContinueNot 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#

ActionStepsEdit****Update prompt file FIRST → --regenerate N → Regenerate PDFAddCreate prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDFDeleteRemove 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