community-baoyu-comic

Files (35)

• PORT_NOTES.md
• SKILL.md
• analysis-framework.md · references/
• chalk.md · references/art-styles/
• ink-brush.md · references/art-styles/
• ligne-claire.md · references/art-styles/
• manga.md · references/art-styles/
• minimalist.md · references/art-styles/
• realistic.md · references/art-styles/
• auto-selection.md · references/
• base-prompt.md · references/
• character-template.md · references/
• cinematic.md · references/layouts/
• dense.md · references/layouts/
• four-panel.md · references/layouts/
• mixed.md · references/layouts/
• splash.md · references/layouts/
• standard.md · references/layouts/
• webtoon.md · references/layouts/
• ohmsha-guide.md · references/
• partial-workflows.md · references/
• concept-story.md · references/presets/
• four-panel.md · references/presets/
• ohmsha.md · references/presets/
• shoujo.md · references/presets/
• wuxia.md · references/presets/
• storyboard-template.md · references/
• action.md · references/tones/
• dramatic.md · references/tones/
• energetic.md · references/tones/
• neutral.md · references/tones/
• romantic.md · references/tones/
• vintage.md · references/tones/
• warm.md · references/tones/
• workflow.md · references/

SKILL.md (first lines)

# Knowledge Comic Creator

Adapted from [baoyu-comic](https://github.com/JimLiu/baoyu-skills) for Community Skills's tool ecosystem.

Create original knowledge comics with flexible art style × tone combinations.

## When to Use

Trigger this skill when the user asks to create a knowledge/educational comic, biography comic, tutorial comic, or uses terms like "知识漫画", "教育漫画", or "Logicomix-style". The user provides content (text, file path, URL, or topic) and optionally specifies art style, tone, layout, aspect ratio, or language.

## Reference Images

community skills' `image_generate` tool is **prompt-only** — it accepts a text prompt and an aspect ratio, and returns an image URL. It does **NOT** accept reference images. When the user supplies a reference image, use it to **extract traits in text** that get embedded in every page prompt:

**Intake**: Accept file paths when the user provides them (or pastes images in conversation).

- File path(s) → copy to `refs/NN-ref-{slug}.{ext}` alongside the comic output for provenance
- Pasted image with no path → ask the user for the path via `clarify`, or extract style traits verbally as a text fallback
- No reference → skip this section

**Usage modes** (per reference):

| Usage     | Effect                                                                                      |
| --------- | ------------------------------------------------------------------------------------------- |
| `style`   | Extract style traits (line treatment, texture, mood) and append to every page's prompt body |
| `palette` | Extract hex colors and append to every page's prompt body                                   |
| `scene`   | Extract scene composition or subject notes and append to the relevant page(s)               |

**Record in each page's prompt frontmatter** when refs exist:

```yaml
references:
  - ref_id: 01
    filename: 01-ref-scene.png
    usage: style
    traits: "muted earth tones, soft-edged ink wash, low-contrast backgrounds"
```

Character consistency is driven by **text descriptions** in `characters/characters.md` (written in Step 3) that get embedded inline in every page prompt (Step 5). The optional PNG character sheet generated in Step 7.1 is a human-facing review artifact, not an input to `image_generate`.

## Options

### Visual Dimensions

| Option   | Values                                                                   | Description                                                                                                                                  |
| -------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Art      | ligne-claire (default), manga, realistic, ink-brush, chalk, minimalist   | Art style / rendering technique                                                                                                              |
| Tone     | neutral (default), warm, dramatic, romantic, energetic, vintage, action  | Mood / atmosphere                                                                                                                            |
| Layout   | standard (default), cinematic, dense, splash, mixed, webtoon, four-panel | Panel arrangement                                                                                                                            |
| Aspect   | 3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen)              | Page aspect ratio                                                                                                                            |
| Language | auto (default), zh, en, ja, etc.                                         | Output language                                                                                                                              |
| Refs     | File paths                                                               | Reference images used for style / palette trait extraction (not passed to the image model). See [Reference Images](#reference-images) above. |

### 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](references/partial-workflows.md)

### Art, Tone & Preset Catalogue

- **Art styles** (6): `ligne-claire`, `manga`, `realistic`, `ink-brush`, `chalk`, `minimalist`. Full definitions at `references/art-styles/<style>.md`.
- **Tones** (7): `neutral`, `warm`, `dramatic`, `romantic`, `energetic`, `vintage`, `action`. Full definitions at `references/tones/<tone>.md`.
- **Presets** (5) with special rules beyond plain art+tone:

  | Preset          | Equivalent                               | Hook                                                          |
  | --------------- | ---------------------------------------- | ------------------------------------------------------------- |
  | `ohmsha`        | manga + neutral                          | Visual metaphors, no talking heads, gadget reveals            |
  | `wuxia`         | ink-brush + action                       | Qi effects, combat visuals, atmospheric                       |
  | `shoujo`        | manga + romantic                         | Decorative elements, eye details, romantic beats              |
  | `concept-story` | manga + warm                             | Visual symbol system, growth arc, dialogue+action balance     |
  | `four-panel`    | minimalist + neutral + four-panel layout | 起承转合 structure, B&W + spot color, stick-figure characters |

  Full rules at `references/presets/<preset>.md` — load the file when a preset is picked.

- **Compatibility matrix** and **content-signal → preset** table live in [references/auto-selection.md](references/auto-selection.md). Read it before recommending combinations in Step 2.

## 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}.md` | Saved source content (kebab-case slug matches the output directory) |
| `analysis.md` | Content analysis |
| `storyboard.md` | Storyboard with panel breakdown |
| `characters/characters.md` | Character definitions |
| `characters/characters.png` | Character reference sheet (downloaded from `image_generate`) |
| `prompts/NN-{cover\|page}-[slug].md` | Generation prompts |
| `NN-{cover\|page}-[slug].png` | Generated images (downloaded from `image_generate`) |
| `refs/NN-ref-{slug}.{ext}` | User-supplied reference images (optional, for provenance) |

## Language Handling

**Detection Priority**:

1. User-specified language (explicit option)
2. User's conversation language
3. Source content language

**Rule**: Use user's input language 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

From ArgentAIOS/argentos-core, MIT.

More from ArgentAIOS/argentos-core