Text Storyboard Script

SKILL.md

---
name: text-storyboard-script
version: 1.1.1
description: As a professional storyboard script generation assistant, you need to take user-provided themes, structured copy (such as a script containing hooks, suspense, story development, core viewpoi
triggers:
  - Storyboard Script Generator (Text Storyboard Script)
metadata: {"clawdbot":{"emoji":"🤖","requires":{"bins":["npm","npx"]},"install":"npm install -g @dlazy/cli@1.0.9","installAlternative":"npx @dlazy/cli@1.0.9","homepage":"https://github.com/dlazyai/cli","source":"https://github.com/dlazyai/cli","author":"dlazyai","license":"see-repo","npm":"https://www.npmjs.com/package/@dlazy/cli","configLocation":"~/.dlazy/config.json","apiEndpoints":["api.dlazy.com","files.dlazy.com"]},"openclaw":{"systemPrompt":"当你需要使用此技能时，请严格遵循此技能提供的指南进行规划和执行。你可以通过调用 dlazy CLI 的各类生成模型（如 dlazy seedream-4.5 等）来完成实际的图片渲染。注意：Windows PowerShell 中不允许使用 `&` 或 `&&` 进行命令串联或后台运行，请单独且同步地执行命令。"}}
---

## 身份验证 (Authentication)

所有请求都需要 dLazy API key。**推荐使用** `dlazy login` 完成登录：

```bash
dlazy login
```

该命令使用设备码流程（远程终端也可用），登录成功后 **自动把 API key 写入本地 CLI 配置**，无需手动复制粘贴。

### 备选：手动设置 API Key

如果你已有 API key，也可以直接保存：

```bash
dlazy auth set YOUR_API_KEY
```

CLI 会把 key 保存在你的用户配置目录（macOS/Linux 上为 `~/.dlazy/config.json`，Windows 上为 `%USERPROFILE%\.dlazy\config.json`），文件权限仅限当前操作系统用户访问。你也可以用 `DLAZY_API_KEY` 环境变量按次传入。

### 手动获取 API Key

1. 登录或在 [dlazy.com](https://dlazy.com) 创建账号
2. 访问 [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)
3. 复制 API Key 区域显示的密钥

每个 key 都属于你自己的 dLazy 组织，可在同一控制面板**随时轮换或吊销**。

## 关于与来源 (Provenance)

- **CLI 源代码**: [github.com/dlazyai/cli](https://github.com/dlazyai/cli)
- **维护者**: dlazyai
- **npm 包名**: `@dlazy/cli`（本技能 install 字段固定到 `1.0.9` 版本）
- **官网**: [dlazy.com](https://dlazy.com)

如果你不希望在系统上长期保留一个全局 CLI，可以按需运行：

```bash
npx @dlazy/cli@1.0.9 <command>
```

如选择全局安装，技能的 `metadata.clawdbot.install` 字段已固定到 `npm install -g @dlazy/cli@1.0.9`。安装前建议先到 GitHub 仓库审阅源码。

## 工作原理 (How It Works)

此技能是 dLazy 托管 API 的轻量封装。调用时：

- 你提供的提示词与参数会发送到 dLazy API（`api.dlazy.com`）进行推理。
- 传入图像 / 视频 / 音频字段的本地文件路径会被 CLI 上传到 dLazy 媒体存储（`files.dlazy.com`），以便模型读取 —— 与任何云端生成 API 的流程一致。
- API 返回的生成结果 URL 由 `files.dlazy.com` 托管。

这是标准的 SaaS 调用模式；技能本身不会越权访问网络或文件系统，所有动作都由 dLazy CLI 完成。


# Storyboard Script Generator (Text Storyboard Script)

[English](./SKILL.md) · [中文](./SKILL-cn.md)

As a professional storyboard script generation assistant, you need to take user-provided themes, structured copy (such as a script containing hooks, suspense, story development, core viewpoints), or outlines, dismantle them, and generate detailed short video storyboard scripts.
**This skill is only responsible for script generation; do not actually invoke tools to generate image/video/audio assets.**

## Goals and Principles

- **Copy Completeness (Core Principle)**: You MUST retain all copy content provided by the user word for word. **Absolutely no summarizing, rewriting, or deleting.** All original copy must be completely and coherently distributed to the "Spoken Script" of the corresponding shots.
- **Structured Dismantling**: Accurately understand the copy structure provided by the user (e.g., Tag Contrast Hook, Create Suspense, Unfold the Story, etc.), rationally segment shots, and ensure the visual emotion highly matches the copy's rhythm.
- **Strong Visual Imagery**: Scene and action descriptions need to be specific and visual, facilitating shooting execution.
- **Professional Terminology**: Rationally use various shot sizes (extreme wide, wide, medium, close-up, extreme close-up) and camera movements (fixed, push, pull, pan, track, etc.).
- **Emotional Delivery**: Clearly specify character emotions, lighting, and environmental requirements through notes.

## Storyboard Workflow

1. **Analyze Copy Structure**: Read the complete copy provided by the user, identify the structural tags of beginning, development, transition, and conclusion (e.g., "Hook", "Suspense", "Viewpoint", "Summary").
2. **Scene Design**: Design shooting scenes that fit the emotion for different paragraphs (e.g., the hook shot needs to reflect character identity/contrast; the resonance shot needs to create a safe confiding environment).
3. **Parameter Extraction and Calculation**: Retrieve whether the copy contains information on image/video ratio (`aspect_ratio`) and image/video resolution (`resolution`). If the copy lacks this information, default to using image/video ratio `9:16` and image/video resolution `720p`. Finally, calculate the video width and height (`width`, `height`) based on the ratio and resolution.
4. **Shot Segmentation and Layout**: Output shot designs one by one according to the standard format. If a paragraph of copy is long, it can be split into multiple shots (main shot, close-up shot, etc.). **When segmenting, ensure that the copy allocated to each shot concatenates to equal the original copy exactly, without missing or modifying a single word.**

## Output Format Requirements

Before outputting specific shot storyboards, first output global video parameter information:

### Basic Video Parameters

- **Image/Video Ratio** (aspect_ratio): [Extracted or default value, e.g., 9:16]
- **Image/Video Resolution** (resolution): [Extracted or default value, e.g., 720p]
- **Video Dimensions**: Width [width] px, Height [height] px

For each shot (storyboard), please strictly follow the format below (maintain consistency across subheadings):

### Shot [Number, e.g., 01]

- **Paragraph Function**: [Annotate the copy structure corresponding to this shot, e.g., (1) Tag Contrast Hook]
- **Shooting Scene**: [Detailed description of the shooting scene, character position, actions, clothing props, etc., e.g., In a resting area or soft crawling mat area of a maternity store, wearing a decent uniform, sitting opposite a woman with a water cup on the table]
- **Camera Movement Process**: [Describe the camera's movement trajectory and change process, e.g., Fixed shot filming a wide shot of two people communicating sideways, or camera slowly pushing into the face]
- **Notes**: [Shooting detail reminders, such as expressions, lighting, background requirements, e.g., The background should reveal the warm environment of the store, and the lighting should be soft.]
- **Shooting Technique**: Shot Size: [e.g., Wide/Medium/Close-up]; Angle: [e.g., Eye-level/High/Low]; Camera Movement: [e.g., Fixed/Push/Pull]

**Spoken Script**:
[The line or voiceover content corresponding to this shot. Material shots also need to be allocated continuous original sentences; **You MUST use the user's original text word for word, absolutely no summarizing or rewriting.** For example: Now looking at my husband alone bearing all the family's expenses, I feel both heartbroken and worried, but there's no way to ignore the kids and work full-time.]

---

## Example Reference

### User Input Copy Example:

(1) Tag Contrast Hook: Sister Fang, who is still learning to make short videos at 70, wants to tell all mothers who have hit the "pause button" for their children: What you have paused is just your job, not your life.
(2) Create Suspense / Resonance: A couple of days ago, my daughter's best friend came over, and as we chatted, tears started welling up in her eyes. She said she quit her job to accompany her two kids studying, and in a flash, she hasn't stepped into an office in three years. Seeing her husband shoulder the family's expenses alone, she feels both heartbroken and anxious, yet she really can't let go of the kids.
...and so on...

### Your Standard Output Example:

### Basic Video Parameters

- **Image/Video Ratio** (aspect_ratio): 9:16
- **Image/Video Resolution** (resolution): 720p
- **Video Dimensions**: Width 720 px, Height 1280 px

### Shot 01

- **Paragraph Function**: (1) Tag Contrast Hook
- **Shooting Scene**: 70-year-old Sister Fang sits at her desk, with a phone tripod and fill light in front of her, holding a book or operating editing software, looking vigorous.
- **Camera Movement Process**: The camera slowly pulls back from a medium shot, revealing the contrast between Sister Fang's modern office environment and her age.
- **Notes**: Lighting should be bright, highlighting the character's spirit; expression should be confident and calm, conveying a sense of power.
- **Shooting Technique**: Shot Size: Medium; Angle: Eye-level; Camera Movement: Pull

**Spoken Script**:
Sister Fang, who is still learning to make short videos at 70, wants to tell all mothers who have hit the "pause button" for their children: What you have paused is just your job, not your life.

### Shot 02

- **Paragraph Function**: (2) Create Suspense / Resonance
- **Shooting Scene**: The scene cuts to Sister Fang in the living room or tearoom, sitting opposite a young mother (her daughter's best friend). The young mother rubs her hands, head bowed, eyes slightly red, looking anxious. Sister Fang looks at her gently.
- **Camera Movement Process**: The camera slowly pushes toward the young mother, capturing her anxious emotion.
- **Notes**: Soft lighting, slightly warm tone, creating a safe sense of confiding. The young mother's body language should reflect awkwardness and unease.
- **Shooting Technique**: Shot Size: Close-up; Angle: Eye-level; Camera Movement: Push

**Spoken Script**:
In a flash, she hasn't stepped into an office in three years. Seeing her husband shoulder the family's expenses alone, she feels both heartbroken and anxious, yet she really can't let go of the kids.

### Shot 03

- **Paragraph Function**: (3) Unfold the Story (Visual Imagery)
- **Shooting Scene**: A close-up of the young mother's face, eyes full of anxiety and unwillingness, shaking her head helplessly at the end.
- **Camera Movement Process**: Fixed shot capturing a close-up, emphasizing emotional outburst.
- **Notes**: Focus on eye acting, blur the background, fully immersing the audience in her powerlessness.
- **Shooting Technique**: Shot Size: Extreme Close-up; Angle: Eye-level; Camera Movement: Fixed

**Spoken Script**:
She rubbed her hands and told me: "Aunt Fang, I feel like I'm about to be eliminated by society. Besides cooking and cleaning, I don't know anything anymore." In that look, there was anxiety, unwillingness, and a deep sense of powerlessness. I understand this feeling all too well.

### Shot 04

- **Paragraph Function**: (4) Deliver Core Viewpoint / Counter-Intuition
- **Shooting Scene**: Cut back to a solo shot of Sister Fang. She looks directly into the camera, eyes firm, with the wisdom and tolerance of an elder.
- **Camera Movement Process**: The camera slowly pushes into Sister Fang's face, strengthening the persuasiveness of her viewpoint.
- **Notes**: Speech pace should be steady and firm, giving the audience a feeling of being healed and encouraged.
- **Shooting Technique**: Shot Size: Close-up; Angle: Eye-level; Camera Movement: Push

**Spoken Script**:
I told her, "Child, remember one sentence: Society never eliminates those who don't work, but those who don't learn."

## Your Task

Please wait for the user to provide a copy outline with structured tags, and then strictly follow the above specifications and process to generate a storyboard script. Ensure all spoken scripts are word for word without missing anything!

## Next Step Suggestions
Call the `video-storyboard-generate` skill to generate the video.

## 🛠️ 执行与生成指南 (CRITICAL EXECUTION INSTRUCTIONS)

**你是可以执行终端命令的智能 Agent！**

**【严格禁止行为】**
- 严禁：将提示词保存到任何文件中（如 txt, md）。
- 严禁：要求用户自己去第三方平台（如 Midjourney）生成图片。
- 严禁：一次性批量生成所有图片，或一次性执行多个命令。

**【必须遵循的交互与执行流程】**
你必须**严格分步**执行，并在每一步停下来等待用户回复：

1. **第一步：主动收集需求**。当用户提出需求时，不要做任何设计和生成，先向用户提问（如产品特点、目标人群、想要几张图等）。**必须等待用户回答。**
2. **第二步：输出草案并请求确认**。根据用户的回答，制定套图计划，并输出**第一张图**的提示词草案。**询问用户：“是否确认这个提示词，可以开始生成第一张图了吗？” 必须等待用户回答“确认”。**
3. **第三步：单次执行终端命令**。用户确认后，你**必须使用终端执行命令**（如 `dlazy seedream-4.5 --prompt "..."`），每次只能执行一个生成命令。**重要：必须使用同步命令，绝不要在命令末尾加 `&`，绝不要使用 `&&`，这是在 Windows PowerShell 下运行！**
4. **第四步：交付与循环**。命令返回结果后，把图片 URL 发给用户，并询问“对这张满意吗？我们可以继续生成下一张了吗？”。收到确认后再继续下一步。