Paper Comic - Academic Paper Comic Generator

Usage

/paper-comic /path/to/paper.pdf
/paper-comic /path/to/paper.pdf --style tech
/paper-comic  # Then paste the paper content

Art Style Options

Output Structure

[output-dir]/
├── outline.md           # Outline and storyboards
├── characters/
│   ├── characters.md    # Character definitions
│   └── characters.png   # Character reference images
├── prompts/
│   ├── 00-cover.md      # Cover prompt
│   └── XX-page.md       # Page-specific prompts
├── 00-cover.png         # Cover image
└── XX-page.png          # Comic pages

• With source files:

  [source-dir]/comic/

• Without source files:

  comic-outputs/YYYY-MM-DD/[topic-slug]/

Workflow

Step 1: Analyze the Paper

1. Read paper content (PDF or Markdown)
2. Extract core information:
   • Paper title, authors
   • Research background and motivation
   • Core innovations (1-3)
   • Key methods/algorithms
   • Main experimental results
3. Automatically recommend an art style based on the paper's field (or use user-specified style)

Step 2: Design Narrative Structure

Step 3: Define Characters

characters/characters.md

• Mentor: Knowledge explainer, wise and approachable
• Student: Represents readers, asks questions and learns
• Concept Personification (optional): Personify abstract concepts

• Mentor and student must appear in ≥60% of pages
• Clearly mark characters present on each page
• Character appearance remains consistent across all pages

Step 4: Create Storyboards

outline.md

• Metadata (title, art style, number of pages)
• Cover design
• Panel layout and content for each page

• 3-5 panels per page
• Mark characters, scenes, and dialogue for each panel
• All dialogue must be in Chinese
• Express formulas with illustrations instead of text

Step 5: Generate Images

# Get skill installation path (assuming installed via npx skills add)
SKILL_DIR="$HOME/.claude/skills/baoyu-gemini-web"
# Or if located elsewhere:
# SKILL_DIR="$HOME/.codex/skills/baoyu-gemini-web"

# Generate character reference images
npx -y bun "$SKILL_DIR/scripts/main.ts" \
  --promptfiles references/base-prompt.md characters/characters.md \
  --image characters/characters.png \
  --sessionId comic-[topic]-[timestamp]

# Generate each page (use the same sessionId for consistency)
npx -y bun "$SKILL_DIR/scripts/main.ts" \
  --promptfiles references/base-prompt.md prompts/XX-page.md \
  --image XX-page.png \
  --sessionId comic-[topic]-[timestamp]

--sessionId

Step 6: Output Documentation

[topic]-paper-comic.md

# [Paper Title] - Comic Interpretation

## Overview
- **Paper**: [Title]
- **Art Style**: [Selected Style]
- **Number of Pages**: [N]
- **Generation Time**: [YYYY-MM-DD]

## Comic Pages

### Cover
![Cover](00-cover.png)

### Page 1
![Page 1](01-page.png)
**Content**: [Brief description of what this page explains]

...

## Core Knowledge Points
1. [Knowledge Point 1]
2. [Knowledge Point 2]
3. [Knowledge Point 3]

Key Principles

Text Requirements

• All dialogue and narration must be in Chinese
• Professional terms: Chinese + English, e.g., "梯度下降 (Gradient Descent)"
• Text must be clear and readable, no blurriness

Formula Handling

• Do not write formulas as text
• Express formula meanings with illustrations/metaphors
• Example: Gradient Descent → Draw a ball rolling down a hillside

Visual Coherence

• Consistent character appearance throughout
• Unified scene style
• Clear and progressive narrative logic

Reference Files

• references/base-prompt.md

  - Base prompt template

• references/styles/classic.md

  - Clean line style template

• references/styles/tech.md

  - Technical style template

• references/styles/warm.md

  - Warm style template

• references/styles/chalk.md

  - Chalkboard style template