Back to Details

baoyu-comic

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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
bash
/baoyu-comic posts/turing-story/source.md
/baoyu-comic article.md --art manga --tone warm
/baoyu-comic  # 然后粘贴内容

Options

可选参数

Visual Dimensions

视觉维度

OptionValuesDescription
--art
ligne-claire (default), manga, realistic, ink-brush, chalkArt style / rendering technique
--tone
neutral (default), warm, dramatic, romantic, energetic, vintage, actionMood / atmosphere
--layout
standard (default), cinematic, dense, splash, mixed, webtoonPanel arrangement
--aspect
3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen)Page aspect ratio
--lang
auto (default), zh, en, ja, etc.Output language
参数可选值描述
--art
ligne-claire（默认）, manga, realistic, ink-brush, chalk艺术风格/渲染技法
--tone
neutral（默认）, warm, dramatic, romantic, energetic, vintage, action情绪/氛围
--layout
standard（默认）, cinematic, dense, splash, mixed, webtoon分镜布局
--aspect
3:4（默认，竖版）, 4:3（横版）, 16:9（宽屏）页面宽高比
--lang
auto（默认）, zh, en, ja等输出语言

Partial Workflow Options

部分工作流可选参数

OptionDescription
--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
参数描述
--storyboard-only
仅生成分镜脚本，跳过提示词和图像生成
--prompts-only
生成分镜脚本+提示词，跳过图像生成
--images-only
从已有的提示词目录生成图像
--regenerate N
仅重新生成指定页面（例如：
3
或 
2,5,8
）
详情：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
风格中文描述
ligne-claire
清线线条统一、色彩平涂，欧洲漫画传统风格（如《丁丁历险记》《Logicomix》）
manga
日漫大眼睛、遵循日漫惯例，情绪表现力强
realistic
写实数字绘画风格，比例写实，质感细腻
ink-brush
水墨中式毛笔笔触，水墨晕染效果
chalk
粉笔黑板手绘质感，温暖亲切

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
基调中文描述
neutral
中性平衡理性，偏向教育性
warm
温馨怀旧感，贴近个人叙事，令人安心
dramatic
戏剧高对比度，张力十足，视觉冲击力强
romantic
浪漫柔和唯美，带有装饰性元素
energetic
活力明亮动感，充满激情
vintage
复古历史感，年代氛围真实
action
动作速度线、冲击效果，适合战斗场景

Preset Shortcuts

预设快捷选项

Presets with special rules beyond art+tone:
PresetEquivalentSpecial 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
除艺术风格+基调外，还包含特殊规则的预设：
预设等效参数特殊规则
--style ohmsha
--art manga --tone neutral
使用视觉隐喻，禁止对话头像，突出工具展示
--style wuxia
--art ink-brush --tone action
呈现气劲效果、战斗画面、氛围感元素
--style shoujo
--art manga --tone romantic
加入装饰元素，细化眼部刻画，突出浪漫情节

Compatibility Matrix

风格兼容性矩阵

Art Style✓✓ Best✓ Works✗ Avoid
ligne-claireneutral, warmdramatic, vintage, energeticromantic, action
manganeutral, romantic, energetic, actionwarm, dramaticvintage
realisticneutral, warm, dramatic, vintageactionromantic, energetic
ink-brushneutral, dramatic, action, vintagewarmromantic, energetic
chalkneutral, warm, energeticvintagedramatic, action, romantic
Details: references/auto-selection.md
艺术风格✓✓ 最佳适配✓ 可适配✗ 不建议搭配
ligne-claireneutral, warmdramatic, vintage, energeticromantic, action
manganeutral, romantic, energetic, actionwarm, dramaticvintage
realisticneutral, warm, dramatic, vintageactionromantic, energetic
ink-brushneutral, dramatic, action, vintagewarmromantic, energetic
chalkneutral, warm, energeticvintagedramatic, action, romantic
详情：references/auto-selection.md

Auto Selection

自动选择

Content signals determine default art + tone + layout (or preset):
Content SignalsRecommended
Tutorial, how-to, programming, educationalohmsha preset
Pre-1950, classical, ancientrealistic + vintage
Personal story, mentorligne-claire + warm
Martial arts, wuxiawuxia preset
Romance, school lifeshoujo preset
Biography, balancedligne-claire + neutral
When preset is recommended: Load 
references/presets/{preset}.md
and apply all special rules.
Details: references/auto-selection.md
根据内容信号自动确定默认的艺术风格+基调+布局（或预设）：
内容信号推荐配置
教程、操作指南、编程、教育类ohmsha 预设
1950年前、古典、古代主题realistic + vintage
个人故事、导师叙事ligne-claire + warm
武侠、仙侠主题wuxia 预设
爱情、校园题材shoujo 预设
传记、平衡叙事ligne-claire + neutral
当推荐使用预设时：加载 
references/presets/{preset}.md
并应用所有特殊规则。
详情：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 
    SKILL_DIR
  2. Script path = 
    ${SKILL_DIR}/scripts/<script-name>.ts
  3. Replace all 
    ${SKILL_DIR}
    in this document with the actual path
Script Reference:
ScriptPurpose
scripts/merge-to-pdf.ts
Merge comic pages into PDF
重要提示：所有脚本均位于本技能的 
scripts/
子目录中。
Agent执行说明：
  1. 确定本SKILL.md文件的目录路径为 
    SKILL_DIR
  2. 脚本路径 = 
    ${SKILL_DIR}/scripts/<script-name>.ts
  3. 将本文档中所有 
    ${SKILL_DIR}
    替换为实际路径
脚本参考:
脚本用途
scripts/merge-to-pdf.ts
将漫画页面合并为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:
FileDescription
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
输出目录: 
comic/{topic-slug}/
  • Slug: 从主题提取2-4个单词的短横线命名格式（例如：
    alan-turing-bio
    ）
  • 冲突处理: 追加时间戳（例如：
    turing-story-20260118-143052
    ）
目录内容:
文件描述
source-{slug}.{ext}
源文件
analysis.md
内容分析报告
storyboard.md
带分镜拆解的脚本
characters/characters.md
角色定义文档
characters/characters.png
角色参考图
prompts/NN-{cover|page}-[slug].md
生成提示词
NN-{cover|page}-[slug].png
生成的图像
{topic-slug}.pdf
最终合并的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.
检测优先级:
  1. --lang
    参数（显式指定）
  2. EXTEND.md 中的 
    language
    设置
  3. 用户对话使用的语言
  4. 源内容的语言
规则：所有交互均使用用户输入语言或已保存的语言偏好：
  • 分镜大纲和场景描述
  • 图像生成提示词
  • 用户选择选项和确认信息
  • 进度更新、问题提示、错误信息、总结内容
专业术语保留英文。

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
漫画制作进度:
- [ ] 步骤1: 准备与分析
  - [ ] 1.1 偏好设置（EXTEND.md） ⛔ 阻塞项
    - [ ] 找到文件 → 加载偏好设置 → 继续
    - [ ] 未找到 → 执行首次设置 → 完成后方可进行其他步骤
  - [ ] 1.2 内容分析、1.3 检查已有文件
- [ ] 步骤2: 确认 - 风格与参数 ⚠️ 必填项
- [ ] 步骤3: 生成分镜脚本 + 角色设定
- [ ] 步骤4: 审核大纲（可选）
- [ ] 步骤5: 生成提示词
- [ ] 步骤6: 审核提示词（可选）
- [ ] 步骤7: 生成图像 ⚠️ 必须有角色参考图
  - [ ] 7.1 先生成角色参考图 → characters/characters.png
  - [ ] 7.2 生成页面时必须携带 --ref characters/characters.png
- [ ] 步骤8: 合并为PDF
- [ ] 步骤9: 完成报告

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
输入 → [偏好设置] ─┬─ 已找到 → 继续
                       │
                       └─ 未找到 → 执行首次设置 ⛔ 阻塞项
                                      │
                                      └─ 完成设置 → 保存EXTEND.md → 继续
                                                                              │
        ┌─────────────────────────────────────────────────────────────────────┘
        ↓
内容分析 → [检查已有文件?] → [确认: 风格 + 审核选项] → 分镜脚本 → [需要审核?] → 提示词 → [需要审核?] → 图像 → PDF → 完成

Step Summary

步骤摘要

StepActionKey Output
1.1Load EXTEND.md preferences ⛔ BLOCKING if not foundConfig loaded
1.2Analyze content
analysis.md
1.3Check existing directoryHandle conflicts
2Confirm style, focus, audience, reviewsUser preferences
3Generate storyboard + characters
storyboard.md
, 
characters/
4Review outline (if requested)User approval
5Generate prompts
prompts/*.md
6Review prompts (if requested)User approval
7.1Generate character sheet FIRST
characters/characters.png
7.2Generate pages with character ref
*.png
files
8Merge to PDF
{slug}.pdf
9Completion reportSummary
步骤操作关键输出
1.1加载EXTEND.md偏好设置 ⛔ 未找到则阻塞配置加载完成
1.2内容分析
analysis.md
1.3检查已有文件目录处理文件冲突
2确认风格、重点、受众、审核选项用户偏好记录
3生成分镜脚本 + 角色设定
storyboard.md
, 
characters/
目录
4审核大纲（若步骤2中用户要求）用户确认通过
5生成提示词
prompts/*.md
6审核提示词（若步骤2中用户要求）用户确认通过
7.1先生成角色参考图
characters/characters.png
7.2生成页面时必须引用角色参考图各页面PNG文件
8合并为PDF
{slug}.pdf
9生成完成报告制作总结

Step 7: Image Generation ⚠️ CRITICAL

步骤7: 图像生成 ⚠️ 关键步骤

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
bash
undefined
为保证视觉一致性，必须使用角色参考图。
7.1 先生成角色参考图:
  • 备份规则: 若 
    characters/characters.png
    已存在，重命名为 
    characters/characters-backup-YYYYMMDD-HHMMSS.png
bash
undefined

Use Reference Sheet Prompt from characters/characters.md

使用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`

```bash
npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts
--promptfiles characters/characters.md
--image characters/characters.png --ar 4:3

**压缩角色参考图（推荐）**:
压缩以减少作为参考图时的令牌使用量：
- 使用可用的图像压缩技能（若有）
- 或系统工具: `pngquant`, `optipng`, `sips`（macOS）
- **保持PNG格式**，优先选择无损压缩

**7.2 生成每个页面时必须携带角色参考**:

| 技能能力 | 策略 |
|------------------|----------|
| 支持 `--ref` 参数 | 每个页面都传入 `characters/characters.png` |
| 不支持 `--ref` 参数 | 在每个提示词文件开头加入角色描述 |

**页面生成备份规则**:
- 若提示词文件已存在：重命名为 `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
- 若图像文件已存在：重命名为 `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`

```bash

Example: ALWAYS include --ref for consistency

示例: 始终携带--ref参数以保证一致性

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](references/workflow.md)
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

**完整工作流详情**: [references/workflow.md](references/workflow.md)

EXTEND.md Paths ⛔ BLOCKING

EXTEND.md文件路径 ⛔ 阻塞项

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.md
Project directory
$HOME/.baoyu-skills/baoyu-comic/EXTEND.md
User home
ResultAction
FoundRead, 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
关键提示: 如果未找到EXTEND.md文件，必须先完成首次设置，之后才能进行其他任何问题或步骤。不得直接进行内容分析、询问艺术风格或基调，仅可执行偏好设置流程。
路径位置
.baoyu-skills/baoyu-comic/EXTEND.md
项目目录
$HOME/.baoyu-skills/baoyu-comic/EXTEND.md
用户主目录
结果操作
已找到读取、解析、展示摘要 → 继续
未找到⛔ 阻塞: 仅执行首次设置（references/config/first-time-setup.md）→ 完成并保存EXTEND.md → 再继续
EXTEND.md支持配置: 水印 | 偏好艺术风格/基调/布局 | 自定义风格定义 | 角色预设 | 语言偏好
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
核心模板:
  • analysis-framework.md - 深度内容分析框架
  • character-template.md - 角色定义格式
  • storyboard-template.md - 分镜脚本结构
  • ohmsha-guide.md - Ohmsha日漫风格规范
风格定义:
  • references/art-styles/
    - 艺术风格（ligne-claire, manga, realistic, ink-brush, chalk）
  • references/tones/
    - 基调（neutral, warm, dramatic, romantic, energetic, vintage, action）
  • references/presets/
    - 带特殊规则的预设（ohmsha, wuxia, shoujo）
  • references/layouts/
    - 分镜布局（standard, cinematic, dense, splash, mixed, webtoon）
工作流:
  • workflow.md - 完整工作流详情
  • auto-selection.md - 内容信号分析逻辑
  • partial-workflows.md - 部分工作流选项
配置:
  • config/preferences-schema.md - EXTEND.md 格式规范
  • config/first-time-setup.md - 首次设置指南
  • config/watermark-guide.md - 水印配置说明

Page Modification

页面修改

ActionSteps
EditUpdate prompt file FIRST → 
--regenerate N
→ Regenerate PDF
AddCreate prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF
DeleteRemove 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.
操作步骤
编辑先更新提示词文件 → 使用 
--regenerate N
→ 重新生成PDF
添加在指定位置创建提示词 → 携带角色参考图生成图像 → 重命名后续文件 → 更新分镜脚本 → 重新生成PDF
删除删除对应文件 → 重命名后续文件 → 更新分镜脚本 → 重新生成PDF
重要提示: 更新页面时，必须先修改提示词文件（
prompts/NN-{cover|page}-[slug].md
），再执行重新生成操作。确保修改可追溯、可复现。

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
  • 图像生成：每页10-30秒
  • 生成失败时自动重试一次
  • 对敏感公众人物使用风格化替代形象
  • 通过会话ID保持风格一致性
  • 必须完成步骤2的确认 - 不可跳过
  • 步骤4/6为可选步骤 - 仅当用户在步骤2中要求时执行
  • 必须先生成步骤7.1的角色参考图，再生成页面 - 保证一致性
  • 步骤7.2的每个页面都必须引用角色参考 - 使用
    --ref
    参数或嵌入描述
  • 水印/语言配置仅需在EXTEND.md中设置一次