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`	复古

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`

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)

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:

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

Loading…

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`	复古

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`

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)

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:

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

baoyu-comic

Knowledge Comic Creator

Usage

Options

Visual Dimensions

Partial Workflow Options

Art Styles (画风)

Tones (基调)

Preset Shortcuts

Compatibility Matrix

Auto Selection

Script Directory

File Structure

Language Handling

Workflow

Progress Checklist

Flow

Step Summary

Step 7: Image Generation ⚠️ CRITICAL

EXTEND.md Paths

References

Notes

Related Skills

flow

verify

feature-flags

flags

Knowledge Comic Creator

Usage

Options

Visual Dimensions

Partial Workflow Options

Art Styles (画风)

Tones (基调)

Preset Shortcuts

Compatibility Matrix

Auto Selection

Script Directory

File Structure

Language Handling

Workflow

Progress Checklist

Flow

Step Summary

Step 7: Image Generation ⚠️ CRITICAL

EXTEND.md Paths

References

Notes

Related Skills

flow

verify

feature-flags

flags