baoyu-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:

Script Reference:

File Structure

Output directory: comic/{topic-slug}/

Contents:

Language Handling

Detection Priority:

Rule: Use user's input language or saved language preference for ALL interactions:

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 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:

7.2 Generate each page WITH character reference:

Backup rules for page generation:

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

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

Schema: references/config/preferences-schema.md

References

Core Templates:

Style Definitions:

Workflow:

Config:

Page Modification

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