baoyu-cover-image

Files (35)

• SKILL.md
• auto-selection.md · references/
• base-prompt.md · references/
• codex-imagegen.md · references/
• compatibility.md · references/
• first-time-setup.md · references/config/
• preferences-schema.md · references/config/
• watermark-guide.md · references/config/
• font.md · references/dimensions/
• mood.md · references/dimensions/
• text.md · references/dimensions/
• cool.md · references/palettes/
• dark.md · references/palettes/
• duotone.md · references/palettes/
• earth.md · references/palettes/
• elegant.md · references/palettes/
• macaron.md · references/palettes/
• mono.md · references/palettes/
• pastel.md · references/palettes/
• retro.md · references/palettes/
• vivid.md · references/palettes/
• warm.md · references/palettes/
• chalk.md · references/renderings/
• digital.md · references/renderings/
• flat-vector.md · references/renderings/
• hand-drawn.md · references/renderings/
• painterly.md · references/renderings/
• pixel.md · references/renderings/
• screen-print.md · references/renderings/
• style-presets.md · references/
• types.md · references/
• visual-elements.md · references/
• confirm-options.md · references/workflow/
• prompt-template.md · references/workflow/
• reference-images.md · references/workflow/

SKILL.md (first lines)

# Cover Image Generator

## User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

1. **Prefer built-in user-input tools** exposed by the current agent runtime — e.g., `AskUserQuestion`, `request_user_input`, `clarify`, `ask_user`, or any equivalent.
2. **Fallback**: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
3. **Batching**: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete `AskUserQuestion` references below are examples — substitute the local equivalent in other runtimes.

## Image Generation Tools

Resolve the image backend in this order:

1. **User names a backend** in the current message → use it.
2. **`preferred_image_backend`** in `EXTEND.md` names a backend available now → use it. `ask` means ask every run.
3. **Auto-select** (preference `auto`, unset, or the pinned backend is unavailable), first match wins:
   - **Codex `imagegen`** skill is in your available skills → you are in Codex and MUST use it: `Skill` with `skill: "imagegen"`, passing the prompt file's content plus output path and aspect ratio. It outranks non-native skills such as `baoyu-image-gen`.
   - **Codex via `codex exec` (`codex-imagegen`)**: no native `imagegen`, but the `codex` CLI is on `PATH` with an active `codex login` → `baoyu-image-gen --provider codex-cli` (preferred), or the bundled wrapper if baoyu-image-gen is unavailable. Load [references/codex-imagegen.md](references/codex-imagegen.md) only for this branch.
   - **Cursor `GenerateImage`** → use it (outranks non-native skills). It has no aspect-ratio parameter, so state the aspect ratio / dimensions in the `description` prompt; it saves to a tool-managed location, so copy the file to the expected output path (e.g., `outputs/.../NN-xxx.png`). Reference images go in `reference_image_paths`.
   - **Other runtime-native image tool** (e.g., Hermes `image_generate`) → use it the same way.
   - Exactly one non-native backend installed (e.g., `baoyu-image-gen`) → use it.
   - Several non-native backends → ask the user once, batched with other initial questions.
4. **None available** → tell the user and ask how to proceed.

**⛔ Raster only**: never substitute SVG, HTML/CSS, canvas, or other code-based rendering for a raster image, even for diagram-like content. If no raster backend resolves, go to step 4.

**⛔ No bitmap text patching**: never use ImageMagick, Pillow, Canvas, SVG, HTML/CSS, OCR scripts, or any other overlay to cover, rewrite, erase, stroke, or replace title/subtitle text inside an already generated cover image. Regenerate from a corrected prompt, switch to a lower-text or no-title variant, or ask the user which imperfect candidate to keep.

**Prompt file (hard)**: before invoking any backend, write each image's full, final prompt to its own file under `prompts/` (`NN-{type}-[slug].md`) and pass that file (or its content) to the backend. It is the reproducibility record and lets you switch backends without rewriting prompts.

Change the pinned backend via `## Changing Preferences` below. Tool names above are examples; use the local equivalent in other runtimes.

## Confirmation Policy

Default: **confirm before generation**.

- Explicit skill invocation, a file path, matched keywords/presets, `EXTEND.md` defaults, and any documented auto-selection are recommendation inputs only — none authorizes skipping confirmation.
- Do not start Step 3 or Step 4 until the user confirms the dimensions / aspect / language / backend choices.
- Skip confirmation only when the current request explicitly says so: `--quick`, "直接生成", "不用确认", "跳过确认", "按默认出图", or equivalent. `quick_mode: true` in `EXTEND.md` counts as a standing explicit opt-out — set it only when you want every run to skip Step 2.
- When skipped, state the assumed dimensions / aspect / language / backend in the next user-facing update before generating.

## Options

| Option | Description |
|--------|-------------|
| `--type <name>` | hero, conceptual, typography, metaphor, scene, minimal |
| `--palette <name>` | warm, elegant, cool, dark, earth, vivid, pastel, mono, retro, duotone, macaron |
| `--rendering <name>` | flat-vector, hand-drawn, painterly, digital, pixel, chalk, screen-print |
| `--style <name>` | Preset shorthand (see [Style Presets](references/style-presets.md)) |
| `--text <level>` | none, title-only, title-subtitle, text-rich |
| `--mood <level>` | subtle, balanced, bold |
| `--font <name>` | clean, handwritten, serif, display |
| `--aspect <ratio>` | 16:9 (default), 2.35:1, 4:3, 3:2, 1:1, 3:4 |
| `--lang <code>` | Title language (en, zh, ja, etc.) |
| `--no-title` | Alias for `--text none` |
| `--quick` | Skip confirmation, use auto-selection |
| `--ref <files...>` | Reference images for style/composition guidance |

## Five Dimensions

| Dimension | Default | Details |
|-----------|---------|---------|
| **Type** | auto | [types.md](references/types.md) |
| **Palette** | auto | [palettes/](references/palettes/) |
| **Rendering** | auto | [renderings/](references/renderings/) |
| **Text** | title-only | [dimensions/text.md](references/dimensions/text.md) |
| **Mood** | balanced | [dimensions/mood.md](references/dimensions/mood.md) |
| **Font** | clean | [dimensions/font.md](references/dimensions/font.md) |

Values are listed in Options. Auto-selection: [references/auto-selection.md](references/auto-selection.md). Compatibility matrices: [references/compatibility.md](references/compatibility.md). Icon vocabulary: [references/visual-elements.md](references/visual-elements.md).

## File Structure

Output directory per `default_output_dir` preference:
- `same-dir`: `{article-dir}/`
- `imgs-subdir`: `{article-dir}/imgs/`
- `independent` (default): `cover-image/{topic-slug}/`

```
<output-dir>/
├── source-{slug}.{ext}    # Source files
├── refs/                  # Reference images (if provided)
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # Description file
├── prompts/cover.md       # Generation prompt
└── cover.png              # Output image
```

**Slug**: 2-4 words, kebab-case. Conflict: append `-YYYYMMDD-HHMMSS`

## Workflow

```
Cover Image Progress:
- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] Step 1: Analyze content + save refs + determine output dir
- [ ] Step 2: Confirm options (6 dimensions) ⚠️ unless --quick
- [ ] Step 3: Create prompt
- [ ] Step 4: Generate image
- [ ] Step 5: Completion report
```

### Step 0: Load Preferences ⛔ BLOCKING

First match wins:

| Priority | Path | Scope |
|----------|------|-------|
| 1 | `.baoyu-skills/baoyu-cover-image/EXTEND.md` | Project |
| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-cover-image/EXTEND.md` | XDG |
| 3 | `$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md` | User home |

Found → load, display summary. Not found → ⛔ run [first-time-setup](references/config/first-time-setup.md) and save, BEFORE any other step or question.

### Step 1: Analyze Content

From guanyang/open-agent-hub, MIT.

More from guanyang/open-agent-hub