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".
Help users complete the AI video creation workflow from novel/script to storyboard via conversational interface.
Pre-check: Aliyun CLI >= 3.3.3 required
aliyun versionVerify version >= 3.3.3. If not installed or version is too low, run
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bashto update, or see references/cli-installation-guide.md for installation instructions.Then [MUST] run the following commands to configure CLI:
# 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
Pre-check: ICE CLI Plugin required
aliyun plugin install --names iceVerify plugin is installed:
aliyun ice --help
Activation Link: https://ice.console.aliyun.com/guide/default
Log in with your Alibaba Cloud account and activate ICE Intelligent Media Services.
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.
Pre-check: Alibaba Cloud Credentials Required
Security Rules:
- DO NOT read, print, or output AK/SK values
- ONLY USE
aliyun configure listto check credential statusaliyun configure listIf no valid profile exists, STOP and:
- Get credentials from Alibaba Cloud Console
- Run
aliyun configureto set up credentials
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.mdfor required permissions.
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 for recommendation guide.
| 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:
Important: After classification, confirm text type with user or let user specify directly.
Before upload, analyze the text and confirm key parameters with the user.
head -c 1000 <file_path>
Determine: genre, narrative style (first/third person), protagonist characteristics.
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_CalmDeepMale |
| shot-split-mode | Narrative | Third person → thirdPersonNarration; First person → firstPersonNarration; Dialogue-heavy Script → dialogue |
| ratio | Platform | TikTok/Douyin → 9:16; YouTube → 16:9 |
| resolution | Quality | Default 720P; Higher quality 1K/2K/4K |
Defaults: 9:16, 720P (vertical HD for mobile)
⚠️ Constraint:
dialoguemode is ONLY available forScripttype, NOT forNovel.
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.
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)
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.
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:
| Status | SubStatus | Current Phase | User Prompt | Action |
|---|---|---|---|---|
| Configuring | Parsing | Entity Asset Parsing | "Parsing your script, AI is extracting characters, scenes and props..." | Wait |
| Configuring | ParseSucc | Entity Asset Image Generation | "Script parsed! Now generating images for characters, scenes and props. You can preview the progress here:" | Provide Entity Management Link |
| Editing | Creating | Shot Script Generation | "Entity assets ready! Now creating shot script, almost done..." | Wait |
| Editing | CreateSucc | Complete ✅ | "Shot script complete! You can now view and edit your storyboard:" | Provide Editing Link |
| Editing | CreateFailed | Failed ❌ | "Shot script generation failed, please check error message or resubmit." | Troubleshoot |
Interactive Links:
| Status | Link | Purpose |
|---|---|---|
| ParseSucc | https://www.yikeai.com/#/storyboard/entitiesManagement?storyboardId={storyboardId} | Preview entity assets (characters, scenes, props) generation progress |
| CreateSucc | https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId} | Edit storyboard, generate videos, export final video |
Job Status Description:
| JobStatus | Description | User Prompt |
|---|---|---|
| Running | Job in progress | "Job is processing, usually takes a few minutes, please wait..." |
| Succeeded | Job succeeded | "Job completed!" |
| Failed | Job failed | "Job failed, please check error message." |
| Suspended | Job suspended | "Job suspended, some shots failed, can be manually fixed in storyboard." |
Query Recommendation: Jobs usually take a few minutes. Recommend querying status every 30 seconds.
Get storyboardId from JobResult.StoryboardInfoList and construct link: