Image Card Series Generator

Break down complex content into eye-catching image card series with multiple style options.

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

Image Generation Tools

When this skill needs to render an image:

• Use whatever image-generation tool or skill is available in the current runtime — e.g., Codex

  imagegen

  , Hermes

  image_generate

  ,

  baoyu-imagine

  , or any equivalent the user has installed.
• If multiple are available, ask the user once at the start which to use (batch with any other initial questions).
• If none are available, tell the user and ask how to proceed.

Prompt file requirement (hard): write each image's full, final prompt to a standalone file under

prompts/

NN-{type}-[slug].md

Language

Respond in the user's language across questions, progress, errors, and completion summary. Keep technical tokens (style names, file paths, code) in English.

Options

--style <name>

--layout <name>

--palette <name>

--preset <name>

references/style-presets.md

--ref <files...>

--yes

Dimensions

Three independent knobs combine freely:

Example:

--style notion --layout dense

--palette macaron

--preset

Palette behavior: no

--palette

--palette <name>

default_palette

Styles (12)

cute

fresh

warm

bold

minimal

retro

pop

notion

chalkboard

study-notes

screen-print

sketch-notes

Per-style specifications:

references/presets/<style>.md

Layouts (8)

sparse

balanced

dense

list

comparison

flow

mindmap

quadrant

Layout specs:

references/elements/canvas.md

Palettes (optional override)

Replaces the style's colors while keeping rendering rules (line treatment, textures) intact.

macaron

warm

neon

Palette specs:

references/palettes/<palette>.md

Presets (style + layout shortcuts)

Quick-start combos, grouped by scenario. Use

--preset <name>

Knowledge & Learning:

knowledge-card

checklist

concept-map

swot

tutorial

classroom

study-guide

hand-drawn-edu

sketch-card

sketch-summary

Lifestyle & Sharing:

cute-share

girly

cozy-story

product-review

nature-flow

Impact & Opinion:

warning

versus

clean-quote

pro-summary

Trend & Entertainment:

retro-ranking

throwback

pop-facts

hype

Poster & Editorial:

poster

editorial

cinematic

Full prompt-fragment definitions:

references/style-presets.md

Auto-Selection

Match content signals to the best combo. First row whose keywords appear wins; fall back to

cute-share

cute

cute-share

girly

fresh

product-review

nature-flow

warm

cozy-story

bold

warning

versus

minimal

clean-quote

pro-summary

retro

throwback

retro-ranking

pop

hype

pop-facts

notion

knowledge-card

checklist

chalkboard

tutorial

classroom

study-notes

study-guide

screen-print

poster

editorial

cinematic

sketch-notes

hand-drawn-edu

sketch-card

sketch-summary

Style × Layout Matrix

Compatibility scores (✓✓ highly recommended, ✓ works well, ✗ avoid). Use when the user picks a non-default combo and you want to flag a poor match.

Outline Strategies

Three differentiated approaches — each produces a structurally different outline. The workflow recommends one; Path C generates all three and lets the user choose.

Reference Images

User-supplied refs are separate from the internal "image-1 as anchor" chain (Step 3) — they layer on top of it.

Intake: via

--ref <files...>

• File path → copy to

  refs/NN-ref-{slug}.{ext}

• Pasted with no path → ask for the path, or extract style traits as a text fallback

Usage modes (per reference):

direct

style

palette

Record refs in each affected card's prompt frontmatter:

references:
  - ref_id: 01
    filename: 01-ref-brand.png
    usage: direct

At generation time: verify files exist. Image 1 with

usage: direct

--ref

style

palette

File Layout

image-cards/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── outline-strategy-{a,b,c}.md    # Path C only
├── outline.md
├── prompts/NN-{type}-{slug}.md
├── NN-{type}-{slug}.png
└── refs/                          # only if --ref used

Slug: 2-4 words, kebab-case. "AI 工具推荐" →

ai-tools-recommend

-YYYYMMDD-HHMMSS

Backup rule (applies throughout): before overwriting any file — source, outline, prompt, image — rename the existing one to

<name>-backup-YYYYMMDD-HHMMSS.<ext>

Workflow

- [ ] Step 0: Load EXTEND.md ⛔ BLOCKING (interactive only)
- [ ] Step 1: Analyze content → analysis.md
- [ ] Step 2: Smart Confirm ⚠️ REQUIRED (Path A / B / C)
- [ ] Step 3: Generate images
- [ ] Step 4: Completion report

Step 0: Load EXTEND.md ⛔ BLOCKING

Check these paths in order; first hit wins:

.baoyu-skills/baoyu-image-cards/EXTEND.md

${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-image-cards/EXTEND.md

$HOME/.baoyu-skills/baoyu-image-cards/EXTEND.md

• Found → read, parse, print a summary (style / layout / watermark / language), continue.
• Not found + interactive → run first-time setup (see

  references/config/first-time-setup.md

  ) and save before anything else. Do NOT analyze content or ask style questions until preferences exist — this keeps first-run behavior predictable.
• Not found +

  --yes

  → skip setup, use built-in defaults (no watermark, style/layout auto-selected, language from content). Do not prompt, do not create EXTEND.md.

EXTEND.md keys: watermark, preferred style/layout, custom style definitions, language preference. Schema:

references/config/preferences-schema.md

Step 1: Analyze Content →

analysis.md

1. Save the source (backup rule applies if

   source.md

   exists).
2. Run the deep analysis in

   references/workflows/analysis-framework.md

   : content type, hook potential, audience, engagement signals, visual opportunity map, swipe flow.
3. Detect source language, pick recommended image count (2-10).
4. Auto-recommend strategy + style + layout + palette using the Auto-Selection table above.
5. Write everything to

   analysis.md

   .

Step 2: Smart Confirm ⚠️ REQUIRED

Goal: present the auto-recommended plan and let the user confirm or adjust. Skip this step entirely under

--yes

Display summary before asking:

📋 内容分析
  主题：[topic] | 类型：[content_type]
  要点：[key points]
  受众：[audience]

🎨 推荐方案（自动匹配）
  策略：[A/B/C] [name]（[reason]）
  风格：[style] · 布局：[layout] · 配色：[palette or 默认] · 预设：[preset]
  图片：[N]张（封面+[N-2]内容+结尾）
  元素：[background] / [decorations] / [emphasis]

Then ask one question — three paths. Verbatim option copy:

references/confirmation.md

Path A — Quick confirm (trust auto-recommendation): generate a single outline using the recommended strategy + style → save to

outline.md

Path B — Customize: ask five questions (strategy/style, layout, palette, count, optional notes) with the recommendation pre-filled — blanks keep the recommendation. Generate one outline with the user's choices →

outline.md

references/confirmation.md

Path C — Detailed mode: two sub-confirmations.

• Step 2a — Content understanding: ask selling points (multi-select), audience, style preference (authentic / professional / aesthetic / auto), optional context. Update

  analysis.md

  .
• Step 2b — Three outline variants: generate

  outline-strategy-a.md

  ,

  outline-strategy-b.md

  ,

  outline-strategy-c.md

  . Each MUST have a different structure AND a different recommended style — include

  style_reason

  in the frontmatter. Page-count heuristic: A ~4-6, B ~3-5, C ~3-4. Template:

  references/workflows/outline-template.md

  ; frontmatter example in

  references/confirmation.md

  .
• Step 2c — Selection: ask three questions (outline A/B/C/Combined, style, visual elements). Save selected/merged outline to

  outline.md

  → Step 3.

Step 3: Generate Images

With confirmed outline + style + layout + palette:

Visual consistency — image-1 anchor chain: character / mascot / color rendering drifts between calls unless you anchor them. Generate image 1 (cover) first WITHOUT

--ref

--ref

For each image (cover, content, ending):

1. Write the full prompt to

   prompts/NN-{type}-{slug}.md

   in the user's preferred language (backup rule applies).
2. Generate:
   • Image 1: no

     --ref

     (establishes the anchor).
   • Images 2+: add

     --ref <path-to-image-01.png>

     .
   • Backup rule applies to the PNG files.
3. Report progress after each image.

Watermark (if enabled in EXTEND.md): append to the generation prompt:

Include a subtle watermark "[content]" positioned at [position].
The watermark should be legible but not distracting.

See

references/config/watermark-guide.md

Backend selection: per the Image Generation Tools rule at the top — use whatever is available, ask once if multiple, before any generation. Under

--yes

Session ID (if the backend supports

--sessionId

cards-{topic-slug}-{timestamp}

Step 4: Completion Report

Image Card Series Complete!

Topic: [topic]
Mode: [Quick / Custom / Detailed]
Strategy: [A/B/C/Combined]
Style: [name]
Palette: [name or "default"]
Layout: [name or "varies"]
Location: [directory]
Images: N total

✓ analysis.md
✓ outline.md
✓ outline-strategy-a/b/c.md (detailed mode only)

- 01-cover-[slug].png ✓ Cover (sparse)
- 02-content-[slug].png ✓ Content (balanced)
- ...
- NN-ending-[slug].png ✓ Ending (sparse)

Content Breakdown Principles

sparse

balanced

dense

list

comparison

flow

sparse

balanced

For the style × layout compatibility matrix, see the Style × Layout Matrix above.

Image Modification

prompts/NN-{type}-{slug}.md

NN+1

NN-1

Always update the prompt file before regenerating — it's the source of truth and makes changes reproducible.

References

references/confirmation.md

references/style-presets.md

references/presets/<style>.md

references/palettes/<name>.md

references/elements/canvas.md

references/elements/image-effects.md

references/elements/typography.md

references/elements/decorations.md

references/workflows/analysis-framework.md

references/workflows/outline-template.md

references/workflows/prompt-assembly.md

references/config/preferences-schema.md

references/config/first-time-setup.md

references/config/watermark-guide.md

Notes

• Auto-retry once on generation failure before reporting an error.
• For sensitive public figures, use stylized cartoon alternatives.
• Smart Confirm (Step 2) is required; Detailed mode adds a second confirmation (2a + 2c).

Custom configurations via EXTEND.md. See Step 0 for paths and schema.