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 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 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

> 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.

> [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.

See Task 0: Parameter Confirmation for recommendation guide.

Text Type Classification

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):

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:

Defaults: 9:16, 720P (vertical HD for mobile)

> ⚠️ Constraint: dialogue mode is ONLY available for Script type, NOT for Novel.

Example confirmation dialogue:

> "Based on your modern urban romance novel, I recommend:

> - Style: CinematicRealism (film-quality, great for emotional scenes)

> - Voice: sys_ClassicYoungWoman (matches your young female protagonist)

> - Shot Mode: thirdPersonNarration (for third-person narrative)

> - Format: 9:16, 720P (vertical HD for mobile platforms)

> - Title: "雨夜归途"

>

> Does this look good, or would you like to change anything?"

If user has no preference, use recommended defaults. For full options, see Style Mapping Table and Voice Mapping Table.

DO NOT proceed to Task 1 until user confirms.

Task 1: Upload Text File to OSS

> Prerequisite: Task 0 (Parameter Confirmation) MUST be completed.

Use helper script to automatically get credentials and upload:

bash scripts/upload_to_oss.sh <file_path>

Returns: FileURL (for subsequent job submission)

Task 2: Submit Storyboard Job

aliyun ice submit-yike-storyboard-job \
  --file-url "<FileURL>" \
  --source-type <SourceType> \
  --style-id <StyleId> \
  --narration-voice-id <VoiceId> \
  --aspect-ratio "9:16" \
  --resolution 720P \
  --shot-split-mode <ShotSplitMode> \
  --shot-prompt-mode multi \
  --video-model "wan2.6-r2v-flash" \
  --exec-mode StoryboardOnly \
  --title "<Title>" \
  --region cn-shanghai \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

> For complete parameter reference, see references/related-commands.md.

Task 3: Query Job Status

aliyun ice get-yike-storyboard-job \
  --job-id <JobId> \
  --region cn-shanghai \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-yike-storyboard

> For complete parameter and response reference, see references/related-commands.md.

Status Flow and User Prompts:

Interactive Links:

Job Status Description:

> Query Recommendation: Jobs usually take a few minutes. Recommend querying status every 30 seconds.

Task 4: Get Storyboard Link

Get storyboardId from JobResult.StoryboardInfoList and construct link:

https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId}

Style Mapping Table

Narration Voice Mapping Table

Shot Split Mode

> Restriction: When source-type is Novel, dialogue mode is NOT supported.

Recommendation Guide:

Choose appropriate mode based on text type and content analysis:

Script:

1. High dialogue ratio (short dramas, chat format, comedy) → Recommend dialogue
2. First person narration → Recommend firstPersonNarration
3. Pure inner monologue/narration (prose, reflections) → Recommend firstPersonNarrationPureVO
4. Third person narration → Recommend thirdPersonNarration

Novel:

1. "I" perspective + has dialogue (urban romance, mystery) → Recommend firstPersonNarration
2. Pure inner monologue/narration (prose, reflections) → Recommend firstPersonNarrationPureVO
3. Third person narration (fairy tales, mythology, history) → Recommend thirdPersonNarration

> Important: Before execution, describe mode features to user and let them confirm or choose.

Capability Scope

This skill automates:

• Upload novel/script files to OSS
• Entity asset parsing (characters, scenes, props extraction)
• Entity asset image generation
• Shot script generation
• Job status tracking

After shot script completion, continue in UI:

Once the job reaches CreateSucc status, this skill's automation is complete. The following steps require the Yike Storyboard web interface:

1. Edit shot script - Adjust shot content, descriptions, and prompts
2. Generate shot images/videos - AI generates images/videos for each shot
3. Edit and assemble - Fine-tune timing, add transitions
4. Export final video - Render and download the complete video

> Next Step: Open the storyboard editing link and continue your video creation journey!

Reference Links

Error Handling

> Note: If you receive MainAccountUserNotFound error, it means your account has not been whitelisted for the Yike service. Please visit https://www.yikeai.com and apply for access through the invitation application form.