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 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](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](#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](#style-mapping-table) and [Voice Mapping Table](#narration-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](references/related-commands.md#3-submit-storyboard-job).

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](references/related-commands.md#4-query-job-status).

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.