/alibabacloud-yike-storyboard

name: alibabacloud-yike-storyboard
description: |
  Yike Storyboard Creation Skill - Complete AI video creation workflow from novel/script to storyboard via conversational interface.
  Use this skill when users want to create storyboards, produce videos, convert novels/scripts to videos, or generate shot scripts.
  Trigger scenarios: "storyboard", "novel to video", "shot script", "script parsing", "video creation", "convert novel to video", "generate storyboard".

Yike Storyboard Creation Skill

Help users complete the AI video creation workflow from novel/script to storyboard via conversational interface.

---

Prerequisites

1. Aliyun CLI Check

> **Pre-check: Aliyun CLI >= 3.3.3 required** > > ```bash > aliyun version > ``` > > Verify version >= 3.3.3. If not installed or version is too low, > run `curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash` to update, > or see [references/cli-installation-guide.md](references/cli-installation-guide.md) for installation instructions. > > Then **[MUST]** run the following commands to configure CLI: > ```bash > # Enable auto plugin installation > aliyun configure set --auto-plugin-install true > > # Update plugins to latest > aliyun plugin update > > # Set region to cn-shanghai (required for ICE service) > aliyun configure set --region cn-shanghai > ```

**[MUST] CLI User-Agent** — Every `aliyun` CLI command invocation must include: `--user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard`

2. ICE Plugin Installation

> **Pre-check: ICE CLI Plugin required** > > ```bash > aliyun plugin install --names ice > ``` > > Verify plugin is installed: > ```bash > aliyun ice --help > ```

---

Service Activation

1. Activate IMS (Intelligent Media Services)

> **Activation Link:** https://ice.console.aliyun.com/guide/default > > Log in with your Alibaba Cloud account and activate ICE Intelligent Media Services.

2. Log in to yikeai platform

> **Platform Link:** https://www.yikeai.com/#/home > > Visit the product website and authorize login with your Alibaba Cloud account. > Currently Wanjing Yike is in invitation-only phase. Click [Apply for Access](https://survey.aliyun.com/apps/zhiliao/0FZ3TNiNP?spm=yikecom.4ad070b.0.0.53f53564Lny1lL) to submit your application.

---

Credential Verification

> **Pre-check: Alibaba Cloud Credentials Required** > > **Security Rules:** > - **DO NOT** read, print, or output AK/SK values > - **ONLY USE** `aliyun configure list` to check credential status > > ```bash > aliyun configure list > ``` > > **If no valid profile exists, STOP and:** > 1. Get credentials from [Alibaba Cloud Console](https://ram.console.aliyun.com/manage/ak) > 2. Run `aliyun configure` to set up credentials

---

RAM Permissions

This skill requires ICE permissions: `ice:CreateYikeAssetUpload`, `ice:SubmitYikeStoryboardJob`, `ice:GetYikeStoryboardJob`.

For complete permission policies, see [references/ram-policies.md](references/ram-policies.md).

> **[MUST] Permission Error Handling:** When any command fails due to permission errors, read `references/ram-policies.md` for required permissions.

---

Parameter Confirmation

> **Confirm key parameters with user before file upload through natural dialogue.**

| Parameter | Required | Description | Default | |-----------|----------|-------------|---------| | file_path | ✅ | Text file path (txt/docx, ≤5MB, ≤30K chars) | User provides | | title | ✅ | Storyboard title | Extract from text | | source-type | ✅ | `Novel` or `Script` | Based on content analysis | | style | ✅ | Visual style ID | Based on genre | | voice | ✅ | Narration voice ID | Based on protagonist | | shot-split-mode | ✅ | Shot split mode | Based on narrative style | | ratio | Optional | `16:9`, `9:16`, `4:3`, `3:4` | `9:16` | | resolution | Optional | `720P`, `1K`, `2K`, `4K` | `720P` |

See [Task 0: Parameter Confirmation](#task-0-parameter-confirmation) for recommendation guide.

---

Text Type Classification

| Type | Value | Description | |------|-------|-------------| | Novel | `Novel` | Primarily narrative, descriptive, psychological content for reading | | Script | `Script` | Primarily scenes, dialogue, action descriptions for performance/filming |

**Classification Guide:**

Evaluate the following features to determine if text is novel or script (don't judge solely by dialogue presence - novels can have extensive dialogue too):

| Feature | Script | Novel | |---------|--------|-------| | Scene Markers | ✅ Has scene numbers, time, location, INT/EXT | ❌ No explicit scene markers | | Structure | ✅ "Character Name + Dialogue" dominant | ❌ Narrative text dominant | | Action Cues | ✅ Has stage directions, camera directions | ❌ No performable features | | Literary Expression | ❌ Minimal | ✅ Rich environmental descriptions, psychology, emotions |

**Classification Rules:**

1. **Script**: Dominated by scenes, dialogue, action descriptions 2. **Novel**: Dominated by narration, description, psychological activity 3. **Mixed Content**: Determine dominant feature, output "more like script" or "more like novel"

> **Important**: After classification, confirm text type with user or let user specify directly.

---

Core Workflow

Task 0: Parameter Confirmation

Before upload, analyze the text and confirm key parameters with the user.

Step 1: Analyze Text Content

head -c 1000 <file_path>

Determine: genre, narrative style (first/third person), protagonist characteristics.

Step 2: Recommend & Confirm Parameters

Based on analysis, make recommendations and confirm with user through natural dialogue.

**Recommendation Guide:**

| Parameter | Based On | Examples | |-----------|----------|----------| | style | Genre | Modern Urban → `CinematicRealism`; Period Drama → `RealisticGuzhuangPro`; Fantasy → `RealisticXianxia`; Anime → `Ghibli` | | voice | Protagonist | Young Female → `sys_ClassicYoungWoman`; Young Male → `sys_GentleYoungMan`; Mature Male → `sys_Ca