# Lianhuanhua

> Create a narrated vertical comic-style short video from a story, audio file, or video plus one or more character reference images. Use for 连环画, comic slideshow, illustrated narration, emotional Douyin/TikTok/Reels videos, character-consistent image sequences, Doubao Speech 2.0 TTS, subtitle timelines, Codex image generation, and FFmpeg assembly. Do not use for fully generated cinematic video, lip…

- **Type:** Skill
- **Install:** `agentstack add skill-littlewindy123-lianhuanhua-skills-lianhuanhua`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [littlewindy123](https://agentstack.voostack.com/s/littlewindy123)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [littlewindy123](https://github.com/littlewindy123)
- **Source:** https://github.com/littlewindy123/lianhuanhua-skills/tree/main/plugins/lianhuanhua/skills/lianhuanhua
- **Website:** https://github.com/littlewindy123/lianhuanhua-skills#readme

## Install

```sh
agentstack add skill-littlewindy123-lianhuanhua-skills-lianhuanhua
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Lianhuanhua

Create a complete, reproducible comic-video project. Codex directs the story and images. Bundled scripts handle audio, timelines, validation, and FFmpeg rendering.

## Non-negotiable constraints

- Support Codex CLI workflow and local Studio V0.3.
- Use Doubao Speech 2.0 as the only hosted TTS provider.
- Use `X-Api-Resource-Id: seed-tts-2.0`.
- For TTS 2.0 timing, request `audio_params.enable_subtitle=true`; do not rely on the TTS 1.0-only `enable_timestamp` behavior.
- Default Studio image workflow is Codex automatic generation with node confirmations. Do not use visual inspection unless the user chooses strict review.
- Do not call text-to-video or image-to-video models.
- Never claim success until the final media passes ffprobe validation.
- Preserve raw service events and generated prompts for debugging and reproducibility.
- Do not generate all story panels in parallel when using Codex image generation. Generate anchors first, then panels sequentially.
- Default Studio image workflow is `mode=codex`, `review=none`, `repair=ask`.
- Before generating any panel from a reference image that looks like a meme, sticker, network character, IP, logo, text-marked character, or viral image, search the web and record the identity. Do not guess the species or identity from first glance.
- Studio-first startup: when the user says they want to create/start/make a Lianhuanhua video without already providing complete files and settings, launch or reuse the local Studio page first. Do not ask for story text, reference images, voice, ratio, or style in chat before opening Studio.

## Resolve paths

Treat the directory containing this `SKILL.md` as `SKILL_ROOT`.

The CLI entry point is:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py"
```

Use an absolute path when the shell or operating system makes relative paths ambiguous.

Run the local Studio V0.3 web UI with:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" studio --workspace 
```

Studio is a local-only HTML/CSS/JavaScript interface backed by Python's standard library HTTP server. It is for local project work, not production hosting.

## Studio-first startup

For ordinary creation requests such as “我要开始创作了”, “我要做视频”, “连环画 Skills 我要来做视频了”, or similar:

1. Initialize or locate the current Lianhuanhua workspace.
2. Start or reuse the Studio server before asking for creative inputs.
3. Open or navigate the browser to the Studio URL.
4. Let the user enter narration, Doubao key, voice, speech rate, aspect ratio, reference image or style text, and image density in the page.
5. Use chat follow-ups only for Studio handoff actions such as “继续”, troubleshooting, or explicit user questions.

Only skip Studio-first startup when the user explicitly asks for CLI-only operation, batch automation without UI, or has already supplied complete inputs and asks Codex to proceed without the page.

## Inputs

Require:

1. Either at least one character/reference image, or a concrete visual style description.
2. Exactly one story source:
   - written narration text, or
   - existing audio, or
   - existing video.

Optional:

- Desired mood and visual style.
- Desired voice in ordinary language, such as “温柔成熟女声” or “沉稳男声”.
- Advanced override: a Doubao speaker ID.
- Image workflow:
  - `external`: export prompts only; the user generates images elsewhere and returns files.
  - `codex`: Codex uses `$imagegen`.
  - `hybrid`: Codex generates key images only; the user generates the rest externally.
- Existing SRT or timeline JSON.
- Background music.
- Output dimensions; default to 1080x1920, 30 fps.
- Target subtitle font.

## Outputs

Always preserve and return:

1. `output/silent_video.mp4`
2. `output/narration.*`
3. `output/subtitles.srt`
4. `output/final_video.mp4`
5. `output/timeline.json`
6. `output/storyboard.json`
7. `output/panels/`
8. `logs/`

Also preserve the character/style/continuity JSON files and panel prompts in `work/`.
Studio also preserves:

1. `work/studio_state.json`
2. `output/prompts-package.zip`
3. `output/prompts.json`

## Read references progressively

Read only the reference needed for the current phase:

- Overall phases: `references/workflow.md`
- Doubao TTS: `references/doubao-tts-2.0.md`
- Existing audio/video: `references/audio-timeline.md`
- Character lock: `references/character-consistency.md`
- Storyboard creation: `references/storyboard-rules.md`
- Image generation: `references/image-generation.md`
- Rendering: `references/rendering.md`
- Output checks: `references/output-contract.md`
- Failures: `references/troubleshooting.md`

## Phase 0: Preflight

1. Inspect all supplied files.
2. Determine the source mode: `text`, `audio`, or `video`.
3. Confirm that reference images are readable and suitable for the requested aspect ratio.
4. If any reference image looks like a meme, sticker, known IP, logo, text-marked character, or viral image, search the web before image generation and record the result in `work/character_bible.json` under `identity_research`.
5. Run:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" doctor
```

6. Initialize a workspace:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" init --workspace 
```

7. Copy inputs into the initialized `input/` directories without overwriting originals.
8. Do not continue when FFmpeg or ffprobe is missing.

## Studio V0.3 handoff protocol

When the user says "继续" in Codex while working from Studio:

1. Find the current project workspace.
2. Read `work/studio_state.json`.
3. Execute only the task named by `action`.
4. If `panel_id` exists, process only that one panel.
5. Stop at the next confirmation node and let the user return to Studio.
6. Do not score all images, repair all images, or retry unrelated panels unless the current action explicitly asks for it.
7. If the action would call `$imagegen` and a real reference image has `identity_research.status=pending`, do not generate images yet. Search suspected IP/meme identity first, update `work/character_bible.json`, then continue.

Studio V0.3 is a single creation cockpit. Users enter narration, Doubao key, voice, speech rate, aspect ratio, reference images or style text, and image density. The main flow is Codex automatic generation, with confirmations at `voice_ready`, `storyboard_ready`, `images_ready`, and `video_ready`.

Allowed stages are `create`, `voice`, `storyboard`, `images`, and `video`.

Allowed actions are:

- `generate_voice`
- `generate_full_project`
- `generate_storyboard_and_prompts`
- `generate_all_panels`
- `regenerate_panel`
- `validate_manual_panels`
- `render_video`
- `confirm_voice`
- `confirm_storyboard`
- `confirm_images`

Do not write Doubao API keys to `project.json`, `studio_state.json`, `prompts.json`, or exported packages. Studio may store the key only in `work/.secrets.json`, which is excluded by `.gitignore`.

## Phase 1A: Text narration mode

1. Read `references/doubao-tts-2.0.md`.
2. Normalize punctuation and line breaks without changing the story's meaning.
3. Create `work/narration_plan.json` from the bundled template.
4. Select the voice automatically from the story, mood, audience, language, and requested style. Do not ask ordinary users for a speaker ID.
5. Search the bundled official TTS 2.0 catalog when choosing:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" voices --query ""
```

6. The catalog contains all 442 official TTS 2.0 voices captured from the official voice list on 2026-06-25. Write the chosen voice name or natural-language preference to `project.tts.voice_preference`.
7. If the user explicitly supplies a speaker ID, write it to `project.tts.speaker`; it overrides automatic selection.
8. If the user asks where to find or create a voice, explain:
   - preset voices: audition and copy the ID from the Doubao Speech console's voice library,
   - custom voices: create an authorized voice through Voice Replication, then copy its speaker ID,
   - official voice list: `https://www.volcengine.com/docs/6561/1257544`,
   - console: `https://console.volcengine.com/speech/app`.
9. Require only `DOUBAO_API_KEY` for a bundled catalog voice. Treat `DOUBAO_SPEAKER` as an advanced optional override.
10. Prefer one continuous TTS request for naturalness unless the story requires major voice-direction changes.
11. Use `seed-tts-2.0-expressive` when voice instructions are required and the selected voice supports it.
12. Put the primary voice direction in `additions.context_texts`; only its first item is relied upon.
13. Generate audio and subtitle events:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" tts --workspace 
```

14. Verify that `work/audio/narration.*`, `work/timeline.json`, and `work/subtitles.srt` exist.
15. If the API returns audio but no subtitles, keep the audio and raw event log, then use the media transcription fallback only after explaining the fallback in the project log.

## Phase 1B: Existing audio/video mode

1. Read `references/audio-timeline.md`.
2. Extract normalized WAV from the supplied file:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" extract-media --workspace  --input 
```

3. Prefer a supplied SRT or timeline JSON.
4. Otherwise transcribe locally with faster-whisper:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" transcribe --workspace 
```

5. This transcription is a local alignment utility, not another TTS provider.
6. Review names and emotionally important wording against the user's source before continuing.

## Phase 2: Build the visual identity lock

1. Read `references/character-consistency.md`.
2. Inspect every reference image carefully.
3. If a reference image resembles a meme, sticker, network character, IP, logo, text-marked character, or viral image, search the web for the actual identity. Do not label it as a generic animal, mascot, or person unless search confirms that no known identity is available.
4. Write `work/character_bible.json` using the schema in `assets/schemas/character_bible.schema.json`, including `identity_research`.
5. If identified, record the real IP/name, aliases, creator or owner when discoverable, source URLs, confidence, observable traits, and the exact `prompt_identity` that future panel prompts must use.
6. If search is inconclusive, record `status=unidentified` and describe only observable traits. If no reference image exists, record `status=not_needed`.
7. Separate:
   - immutable identity traits,
   - mutable pose/expression traits,
   - forbidden changes.
8. Write `work/style_bible.json` using the bundled schema.
9. If the user chose `codex` or `hybrid`, use `$imagegen` to create `work/character_sheet.png` from the original reference image only after identity research is no longer pending.
10. If the user chose `external`, do not call `$imagegen`; keep the original reference images as the visual lock and let the exported prompt pack describe the desired panels.
11. Only visually inspect the character sheet when the user chose `codex`, `hybrid`, or explicitly asked for visual checking.

## Phase 3: Create the storyboard

1. Read `references/storyboard-rules.md`.
2. Read `work/timeline.json` and preserve its absolute timing.
3. Split each narration segment into one to four visual beats based on actions, time changes, location changes, emotional turns, and duration.
4. Do not split merely by character count.
5. Create `work/storyboard.json` using `assets/schemas/storyboard.schema.json`.
6. Each shot must define:
   - absolute start/end,
   - source narration segment,
   - story action,
   - character state,
   - scene state,
   - composition,
   - motion preset,
   - transition,
   - whether it is an anchor frame.
7. Create `work/continuity_ledger.json` and carry state between shots.
8. Validate before image generation:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" validate --workspace 
```

## Phase 4: Generate consistent panels

1. Read `references/image-generation.md`.
2. If `project.image_workflow.mode` is missing or `ask`, Studio V0.3 should default to `codex`. In CLI-only workflows, stop once and ask the user to choose:
   - `external`: cheapest; export prompt pack only, user generates images in GPT or another image tool.
   - `codex`: most automatic; use `$imagegen` inside Codex.
   - `hybrid`: Codex generates anchors/key images, user generates ordinary panels externally.
3. Save the choice to `project.image_workflow.mode`. Studio defaults to `codex`; default review is `none`; default repair is `ask`.
4. Build deterministic prompt files and the external prompt pack:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" build-prompts --workspace 
```

This writes both `work/prompts/*.md` and:

- `output/image_prompt_pack.md`
- `output/image_prompt_pack.json`
- `output/prompts-package.zip`
- `output/prompts.json`

5. For `external` mode:
   - Do not call `$imagegen`.
   - Return `output/image_prompt_pack.md` to the user.
   - Tell the user they can paste the pack into GPT or another image generator, create all panels in one batch, save files with the exact `Output path`, then return them.
   - When the user returns images, run low-cost validation only: existence, readability, target aspect ratio, schema checks, and later ffprobe.
   - Do not inspect visual quality, character drift, or style drift unless the user explicitly asks.
6. For `codex` mode, generate anchor frames first:
   - opening state,
   - major scene changes,
   - emotional turning point,
   - ending state.
7. Invoke `$imagegen` explicitly for every generated or edited image only in `codex` or selected `hybrid` steps.
   - Before invoking `$imagegen`, check `work/character_bible.json`.
   - If a real reference image exists and `identity_research.status` is not `searched`, `identified`, `unidentified`, or `not_needed`, stop and complete identity research first.
   - If `identity_research.is_known_ip=true`, panel prompts must use the real IP/name, aliases, user reference image, and observable traits. Do not replace it with a generic label such as “cat”, “bear”, or “mascot”.
8. Attach, in this order when available:
   - original character reference,
   - approved character sheet,
   - current scene anchor,
   - previous approved panel.
9. Prefer editing the previous approved panel for small changes. Generate from references only when the scene changes substantially.
10. Save output exactly to the path assigned in `storyboard.json`.
11. Do not write `work/panel_reviews.json` by default. If `project.image_workflow.review` is `manual`, list generated image paths for the user to inspect. If it is `strict`, visually inspect panels and write/update `work/panel_reviews.json`.
12. If a file is missing or unreadable, report the exact path. Do not auto-generate or auto-repair unless `project.image_workflow.repair` is `codex` or the user explicitly asks.
13. If the user says a panel is wrong, either export a targeted repair prompt (`prompt-only`) or use `$imagegen` to repair only that panel when the user chooses Codex repair.

## Studio Phase 4A: Manual image package

For manual image generation, provide `output/prompts-package.zip`.

The ZIP must contain:

- `README.md`
- `prompts.md`
- `prompts.csv`
- `prompts.json`
- `panels/panel_001.txt`, `panels/panel_002.txt`, and so on.

When manual images are returned, perform deterministic checks only: filenames, duplicates, missing panels, file size, readability, target aspect ratio, schema checks, and later ffprobe. Do not judge image quality or style drift unless explicitly asked.

## Phase 5: Render

1. Read `references/rendering.md`.
2. Confirm every storyboard image exists.
3. Use low-cost image checks only unless the user requested strict visual review:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" validate --workspace  --require-images
```

4. Render the silent video:

```bash
python "$SKILL_ROOT/scripts/lianhuanhua_cli.py" render --workspace  --silent-only
```

5. Render final video with narration and optional subtitles:

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [littlewindy123](https://github.com/littlewindy123)
- **Source:** [littlewindy123/lianhuanhua-skills](https://github.com/littlewindy123/lianhuanhua-skills)
- **License:** MIT
- **Homepage:** https://github.com/littlewindy123/lianhuanhua-skills#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-littlewindy123-lianhuanhua-skills-lianhuanhua
- Seller: https://agentstack.voostack.com/s/littlewindy123
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.