baoyu-comic by jimliu/baoyu-skills
npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-comic通过灵活的画风 × 基调组合,创作原创知识漫画。
/baoyu-comic posts/turing-story/source.md
/baoyu-comic article.md --art manga --tone warm
/baoyu-comic # 然后粘贴内容
| 选项 | 可选值 | 描述 |
|---|---|---|
--art | ligne-claire (默认), manga, realistic, ink-brush, chalk | 艺术风格 / 渲染技术 |
--tone | neutral (默认), warm, dramatic, romantic, energetic, vintage, action | 情绪 / 氛围 |
--layout |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| standard (默认), cinematic, dense, splash, mixed, webtoon |
| 分镜布局 |
--aspect | 3:4 (默认, 竖版), 4:3 (横版), 16:9 (宽屏) | 页面宽高比 |
--lang | auto (默认), zh, en, ja 等 | 输出语言 |
| 选项 | 描述 |
|---|---|
--storyboard-only | 仅生成故事板,跳过提示词和图像 |
--prompts-only | 生成故事板 + 提示词,跳过图像 |
--images-only | 从现有的提示词目录生成图像 |
--regenerate N | 仅重新生成特定页面 (例如 3 或 2,5,8) |
| 风格 | 中文 | 描述 |
|---|---|---|
ligne-claire | 清线 | 均匀的线条,平涂色彩,欧洲漫画传统 (丁丁历险记,逻辑学漫画) |
manga | 日漫 | 大眼睛,日漫惯例,富有表现力的情感 |
realistic | 写实 | 数字绘画,写实比例,精致 |
ink-brush | 水墨 | 中国画笔触,水墨渲染效果 |
chalk | 粉笔 | 黑板美学,手绘的温暖感 |
| 基调 | 中文 | 描述 |
|---|---|---|
neutral | 中性 | 平衡,理性,教育性 |
warm | 温馨 | 怀旧,个人化,舒适 |
dramatic | 戏剧 | 高对比度,强烈,有力 |
romantic | 浪漫 | 柔和,优美,装饰性元素 |
energetic | 活力 | 明亮,动态,令人兴奋 |
vintage | 复古 | 历史感,陈旧感,时代真实性 |
action | 动作 | 速度线,冲击效果,战斗 |
超越画风+基调组合的特殊规则预设:
| 预设 | 等效组合 | 特殊规则 |
|---|---|---|
--style ohmsha | --art manga --tone neutral | 视觉隐喻,禁止大头对话,小工具揭示 |
--style wuxia | --art ink-brush --tone action | 气功效果,战斗视觉效果,氛围元素 |
--style shoujo | --art manga --tone romantic | 装饰性元素,眼睛细节,浪漫桥段 |
| 艺术风格 | ✓✓ 最佳 | ✓ 可用 | ✗ 避免 |
|---|---|---|---|
| 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 |
内容信号决定默认的画风 + 基调 + 布局 (或预设):
| 内容信号 | 推荐 |
|---|---|
| 教程,操作指南,编程,教育性 | ohmsha 预设 |
| 1950年前,古典,古代 | realistic + vintage |
| 个人故事,导师 | ligne-claire + warm |
| 武术,武侠 | wuxia 预设 |
| 浪漫,校园生活 | shoujo 预设 |
| 传记,平衡性 | ligne-claire + neutral |
当推荐预设时:加载 references/presets/{preset}.md 并应用所有特殊规则。
重要:所有脚本都位于此技能的 scripts/ 子目录中。
代理执行指令:
{baseDir}{baseDir}/scripts/<script-name>.ts{baseDir} 替换为实际路径${BUN_X} 运行时:如果已安装 bun → bun;如果 npx 可用 → npx -y bun;否则建议安装 bun脚本参考:
| 脚本 | 用途 |
|---|---|
scripts/merge-to-pdf.ts | 将漫画页面合并为 PDF |
输出目录:comic/{topic-slug}/
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 |
检测优先级:
--lang 标志 (显式指定)language 设置规则:使用用户的输入语言或保存的语言偏好进行所有交互:
技术术语保持英文。
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
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
| 步骤 | 操作 | 关键输出 |
|---|---|---|
| 1.1 | 加载 EXTEND.md 偏好设置 ⛔ 如果未找到则阻塞 | 配置已加载 |
| 1.2 | 分析内容 | analysis.md |
| 1.3 | 检查现有目录 | 处理冲突 |
| 2 | 确认风格、重点、受众、审阅 | 用户偏好 |
| 3 | 生成故事板 + 角色 | storyboard.md, characters/ |
| 4 | 审阅大纲 (如果请求) | 用户批准 |
| 5 | 生成提示词 | prompts/*.md |
| 6 | 审阅提示词 (如果请求) | 用户批准 |
| 7.1 | 首先生成角色参考图 | characters/characters.png |
| 7.2 | 使用角色参考生成页面 | *.png 文件 |
| 8 | 合并为 PDF | {slug}.pdf |
| 9 | 完成报告 | 摘要 |
角色参考对于视觉一致性是强制性的。
7.1 首先生成角色参考图:
characters/characters.png 已存在,则重命名为 characters/characters-backup-YYYYMMDD-HHMMSS.pngbaoyu-image-genSKILL.md 并遵循其文档化的接口,而不是直接调用其脚本characters/characters.md 作为提示词文件输入characters/characters.png4:3压缩角色参考图 (推荐):压缩以减少用作参考图像时的令牌使用量:
pngquant, optipng, sips (macOS)7.2 生成每个页面时使用角色参考:
| 技能能力 | 策略 |
|---|---|
支持 --ref | 为每个页面传递 characters/characters.png |
不支持 --ref | 将角色描述前置到每个提示词文件中 |
页面生成的备份规则:
prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.mdNN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.pngprompts/01-page-xxx.md 作为提示词文件输入01-page-xxx.png3:4characters/characters.png 作为 --ref 传递完整工作流程详情:references/workflow.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 支持:水印 | 首选画风/基调/布局 | 自定义风格定义 | 角色预设 | 语言偏好
核心模板:
风格定义:
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)工作流程:
配置:
| 操作 | 步骤 |
|---|---|
| 编辑 | 首先更新提示词文件 → --regenerate N → 重新生成 PDF |
| 添加 | 在指定位置创建提示词 → 使用角色参考生成 → 重新编号后续文件 → 更新故事板 → 重新生成 PDF |
| 删除 | 删除文件 → 重新编号后续文件 → 更新故事板 → 重新生成 PDF |
重要:更新页面时,务必先更新提示词文件 (prompts/NN-{cover|page}-[slug].md),然后再重新生成。这确保了更改被记录且可复现。
--ref 或嵌入描述每周安装量
12.0K
仓库
GitHub 星标
11.6K
首次出现
2026年1月19日
安全审计
安装于
opencode10.9K
gemini-cli10.5K
codex10.4K
cursor10.1K
github-copilot9.6K
amp9.2K
Create original knowledge comics with flexible art style × tone combinations.
/baoyu-comic posts/turing-story/source.md
/baoyu-comic article.md --art manga --tone warm
/baoyu-comic # then paste content
| 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 |
| 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
| 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 | 粉笔 |
| Tone | 中文 | Description |
|---|---|---|
neutral | 中性 | Balanced, rational, educational |
warm | 温馨 | Nostalgic, personal, comforting |
dramatic | 戏剧 | High contrast, intense, powerful |
romantic | 浪漫 | Soft, beautiful, decorative elements |
energetic | 活力 | Bright, dynamic, exciting |
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 |
| 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
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
Important : All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions :
{baseDir}{baseDir}/scripts/<script-name>.ts{baseDir} in this document with the actual path${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bunScript Reference :
| Script | Purpose |
|---|---|
scripts/merge-to-pdf.ts | Merge comic pages into PDF |
Output directory: comic/{topic-slug}/
alan-turing-bio)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` |
| `NN-{cover | page}-[slug].png` |
Detection Priority :
--lang flag (explicit)language settingRule : Use user's input language or saved language preference for ALL interactions:
Technical terms remain in English.
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
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 | Action | Key Output |
|---|---|---|
| 1.1 | Load EXTEND.md preferences ⛔ BLOCKING if not found | 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 |
Character reference is MANDATORY for visual consistency.
7.1 Generate character sheet first :
characters/characters.png exists, rename to characters/characters-backup-YYYYMMDD-HHMMSS.pngbaoyu-image-genSKILL.md and follow its documented interface rather than calling its scripts directlycharacters/characters.md as the prompt-file inputcharacters/characters.png4:3Compress character sheet (recommended): Compress to reduce token usage when used as reference image:
pngquant, optipng, sips (macOS)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 :
prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.mdNN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.pngprompts/01-page-xxx.md as the prompt-file input01-page-xxx.png3:4characters/characters.png as --refFull workflow details : references/workflow.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.
| Path | Location |
|---|---|
.baoyu-skills/baoyu-comic/EXTEND.md | Project directory |
$HOME/.baoyu-skills/baoyu-comic/EXTEND.md | User home |
| Result | Action |
| --- | --- |
| Found | Read, 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
Core Templates :
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 :
Config :
| Action | Steps |
|---|---|
| Edit | Update prompt file FIRST → --regenerate N → Regenerate PDF |
| Add | Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF |
| Delete | Remove 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.
--ref or embed descriptionsWeekly Installs
12.0K
Repository
GitHub Stars
11.6K
First Seen
Jan 19, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode10.9K
gemini-cli10.5K
codex10.4K
cursor10.1K
github-copilot9.6K
amp9.2K
头脑风暴技能:AI协作设计流程,将创意转化为完整规范与实施计划
75,000 周安装
| Chalkboard aesthetic, hand-drawn warmth |
vintage | 复古 | Historical, aged, period authenticity |
action | 动作 | Speed lines, impact effects, combat |
{topic-slug}.pdf | Final merged PDF |
prompts/*.md |
| 6 | Review prompts (if requested) | User approval |
| 7.1 | Generate character sheet FIRST | characters/characters.png |
| 7.2 | Generate pages with character ref | *.png files |
| 8 | Merge to PDF | {slug}.pdf |
| 9 | Completion report | Summary |