Baoyu Comic

Knowledge comic creator supporting multiple art styles and tones. Creates original educational comics with detailed panel layouts and sequential image genera...

Security Scan

The skill mostly matches its stated purpose (creating comics) but includes a blocking preference setup that writes files into user locations and enforces questionable defaults (e.g., copyrighted Doraemon characters) — behaviors that deserve review before installing.

Purpose & Capability

Name/description align with included files and a small TypeScript helper (merge-to-pdf.ts). Requiring a JS/TS runtime via bun or npx is coherent for running local scripts. One oddity: the ohmsha preset mandates using Doraemon characters by default, which is a surprising/legal design decision not implied by the general 'knowledge comic' purpose.

Instruction Scope

SKILL.md instructs the agent to perform a blocking first-time setup that must complete before any other workflow and to write EXTEND.md either to the project (.baoyu-skills/) or the user's home (~/.baoyu-skills/). The skill also requires computing its baseDir and executing TypeScript scripts via bun/npx. These are within a comic workflow but expand scope to creating/modifying files in the user's home and to executing local scripts — actions the user should explicitly approve.

Install Mechanism

No install spec is provided (instruction-only), which is lower risk. However runtime execution depends on bun or npx; using npx could download and run code on demand. There is one small included script (scripts/merge-to-pdf.ts) — the code should be inspected before running, but no external arbitrary-download install step was found.

Credentials

The skill requests no environment variables or credentials. The only peripheral requirement is write access to a preferences file location (project or user scope) which is proportionate for storing user preferences.

Persistence & Privilege

The skill writes persistent configuration (EXTEND.md) and forces the first-time setup to complete before other actions; it offers to save to ~/.baoyu-skills/ by default. While not an elevated system privilege, this persistent user-level presence and mandatory blocking behavior should be acceptable to the user and explicitly granted. The skill does not set always:true or modify other skills.

What to consider before installing

This skill appears to implement a coherent comic-creation workflow, but review the following before installing: - Inspect included scripts (scripts/merge-to-pdf.ts) to confirm they do only local PDF merging and contain no unexpected network calls or harmful shell commands. Running the skill will execute TypeScript via bun or npx, which can run arbitrary code. - The first-time setup is blocking and will create EXTEND.md either in the project (.baoyu-skills/) or in your home directory (~/.baoyu-skills/). If you don't want files written to your home, prepare to choose the project-scoped save or run in an isolated environment. - The ohmsha preset explicitly defaults to using Doraemon characters unless you override it. That is a copyright/branding concern — if you need legally clean outputs, change presets or character defaults before generating content. - There are no requested secrets/credentials, which is good, but be cautious about where image generation is performed: SKILL.md relies on the agent's image-generation capability but does not specify a provider or endpoint. Understand which image service your agent will call and how generated images are stored or transmitted. If you want this skill but are uncomfortable with the defaults: run it in a sandbox/container, or pre-create an EXTEND.md (project-scoped) to avoid the blocking setup; and override the ohmsha character defaults. If you can share the merge-to-pdf.ts contents or any other scripts, I can re-check for network IO or suspicious operations and raise/lower my confidence.

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	复古	Historical, aged, period authenticity
action	动作	Speed lines, impact effects, combat

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:

1. Determine this SKILL.md file's directory path as {baseDir}
2. Script path = {baseDir}/scripts/<script-name>.ts
3. Replace all {baseDir} in this document with the actual path
4. Resolve ${BUN_X} runtime: if bun installed → bun; if npx available → npx -y bun; else suggest installing bun

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	Generated images
{topic-slug}.pdf	Final merged 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.

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

Step 7: Image Generation ⚠️ CRITICAL

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
• Invoke an installed image generation skill such as baoyu-image-gen
• Read that skill's SKILL.md and follow its documented interface rather than calling its scripts directly
• Use characters/characters.md as the prompt-file input
• Save output to characters/characters.png
• Use aspect ratio 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
• Invoke the installed image generation skill for each page
• Use prompts/01-page-xxx.md as the prompt-file input
• Save output to 01-page-xxx.png
• Use aspect ratio 3:4
• If the chosen skill supports reference images, pass characters/characters.png as --ref

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.

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

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

Page Modification

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.

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