Skill: sdk-team/alibabacloud-yike-storyboard (version 0.0.2)

--- 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 ```bash 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_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:** `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 bash scripts/upload_to_oss.sh <file_path> ``` **Returns:** `FileURL` (for subsequent job submission) ### Task 2: Submit Storyboard Job ```bash 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 ```bash 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:** | 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. ### Task 4: Get Storyboard Link Get `storyboardId` from `JobResult.StoryboardInfoList` and construct link: ``` https://www.yikeai.com/#/storyboard/editing?storyboardId={storyboardId} ``` --- ## Style Mapping Table | StyleId | Name | |---------|------| | RealisticPhotographyPro | Realistic Photography Pro | | RealisticGuzhuangPro | Realistic Chinese Period Pro | | RealisticPhotography | Realistic Photography | | RealisticGuzhuang | Realistic Chinese Period | | RealisticXianxia | Realistic Xianxia | | RealisticEra | Realistic Period | | RealisticWasteland | Realistic Wasteland | | GuofengAnime | 2D Chinese Style Anime | | GuofengAnime3D | 3D Chinese Style Anime | | Cartoon3D | 3D Cartoon | | Photorealistic3D | Photorealistic 3D Render | | SciFiRealism | Sci-Fi Realism | | Chibi3D | 3D Chibi | | ShojoManga | Shojo Manga | | NewPeriodAnime | New Era Anime | | FairyTale2D | 2D Fairy Tale | | Wasteland2D | 2D Wasteland | | InkWuxia | Ink Wuxia | | ShadiaoMeme | Panda Meme Style | | Chibi2D | 2D Chibi | | Ghibli | Ghibli | | SciFiComic | Cyberpunk | | AmericanSuperhero | American Superhero | | Hokusei | Hokusei | | RealisticComic | Realistic Comic | | CinematicRealism | Cinematic Realism | | MinimalistRealism | Minimalist Realism | | ShonenManga | Shonen Manga | --- ## Narration Voice Mapping Table | Voice ID | Description | |----------|-------------| | sys_ClassicMiddleAgedWoman | Classic Female Narrator (25-45, wise) | | sys_ClassicYoungWoman | Classic Young Female (18-25, intellectual) | | sys_IntellectualYoungWoman | Intellectual Young Female (18-25, intellectual) | | sys_GentleYoungMan | Gentle Young Male (18-25, gentle) | | sys_WiseYoungMan | Wise Young Male (18-25, wise) | | sys_ClassicYoungMan | Classic Young Male (18-25, charming) | | sys_thoughtfulBoy | Thoughtful Boy (10-15, well-behaved) | | sys_SereneIntellect | Serene Intellectual Male (18-25, cool and rational) | | sys_RichBassMale | Rich Bass Male (18-25, deep voice) | | sys_CalmDeepMale | Calm Deep Male (25-40, steady and deep) | | sys_MajesticBaritone | Majestic Baritone (40-60, authoritative) | | sys_GravellySoulful | Gravelly Soulful Male (40-60, weathered) | | sys_SweetBrightGirl | Sweet Bright Girl (10-15, lively) | | sys_GracefulPoisedWoman | Graceful Poised Woman (18-25, elegant) | | longbaizhi | Long Baizhi (20-30, witty female narrator) | | sys_YoungGracefulWoman | Young Graceful Woman (18-25, gentle) | | sys_MaturePoisedWoman | Mature Poised Woman (25-40, graceful) | | sys_MatureWiseWoman | Mature Wise Woman (25-40, elegant and wise) | | sys_ElderlyWistfulWoman | Elderly Wistful Woman (40-60, nostalgic) | --- ## Shot Split Mode | Mode | Description | Use Case | Supported Type | |------|-------------|----------|----------------| | dialogue | Dialogue Mode | Dialogue-heavy scripts, short dramas | Script only | | firstPersonNarration | First Person Narration | Stories from protagonist's perspective, diary style | Novel/Script | | firstPersonNarrationPureVO | First Person Pure VO | Inner monologue stories, prose | Novel/Script | | thirdPersonNarration | Third Person Narration | Omniscient perspective stories, fairy tales, historical | Novel/Script | > **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 | Reference | Description | |-----------|-------------| | [references/cli-installation-guide.md](references/cli-installation-guide.md) | CLI Installation Guide | | [references/ram-policies.md](references/ram-policies.md) | RAM Permission Policies | | [references/related-commands.md](references/related-commands.md) | Related CLI Commands | | [references/verification-method.md](references/verification-method.md) | Verification Methods | --- ## Error Handling | Error | Cause | Solution | |-------|-------|----------| | MainAccountUserNotFound | Yike service not activated | Apply for access at [Service Activation](#2-log-in-to-yikeai-platform) section | | InvalidAccessKeyId | Invalid AK/SK | Check credential configuration | | Forbidden | Insufficient permissions | See RAM Permissions section | | region can't be empty | OSS upload missing region | Add `--region cn-shanghai` | > **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](https://survey.aliyun.com/apps/zhiliao/0FZ3TNiNP).


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)