Emily2040 · Emily2040 · May 30, 2026 · May 30, 2026
@@ -2,6 +2,26 @@
 
 All notable changes to this project are documented here.
 
+## [5.4.2] — 2026-05-30
+
+### Added
+
+- Added `references/api-workflow.md` and `references/examples-by-mode.md` so API usage, Runway/Volcengine workflow differences, edit/extend, audio-reference handling, FLF2V, and mode-specific examples are discoverable from active skills.
+- Added new eval coverage for audio-reference conflicts, Chinese official-style reference formulas, edit/extend routing, Russian structured prompts, shot-list continuity, gallery-safety classification, VFX reference repair, and extension degradation.
+- Added richer Runway Seedance 2 and Volcengine May 28-29 source records, including `seedance2`, task lifecycle, first/last-frame role wording, pricing-page caveats, and Runway MCP context.
+
+### Changed
+
+- Rebuilt the README hero image as a cinematic Seedance production-control scene with reference frames, timeline, product reveal, camera rig, and audio waveform.
+- Expanded Japanese, Korean, and Spanish vocabulary references into production-ready tables with reference-tag preservation, camera, motion, lighting, audio, edit, extend, and safety language.
+- Tightened active skill routing so prompt, camera, motion, audio, pipeline, recipe, troubleshoot, copyright, and filter modules load the new deep references when the task needs them.
+- Replaced shallow community-mining records with classified multilingual patterns that preserve reusable structures while rejecting unsafe IP, celebrity, brand, and bypass content.
+
+### Fixed
+
+- Corrected Codex Agent Skill install language so repo-root files are not described as automatically loaded unless installed or scanned from the right path.
+- Kept migrated legacy material warning-only and isolated so stale local notes cannot override current source-gated guidance.
+
 ## [5.4.1] — 2026-05-30
 
 ### Added

@@ -6,17 +6,17 @@
 
 Text-to-video · Image-to-video · Video-to-video · Reference-to-video · Audio-aware prompting · Copyright-safe rewrites · Agent Skills
 
-[![Version](https://img.shields.io/badge/version-5.4.1-111827?labelColor=0f172a)](#changelog)
+[![Version](https://img.shields.io/badge/version-5.4.2-111827?labelColor=0f172a)](#changelog)
 [![Skills](https://img.shields.io/badge/sub--skills-23-0ea5e9?labelColor=0f172a)](#skill-map)
-[![References](https://img.shields.io/badge/references-29-8b5cf6?labelColor=0f172a)](#reference-library)
-[![Evals](https://img.shields.io/badge/evals-33-22c55e?labelColor=0f172a)](#validation)
+[![References](https://img.shields.io/badge/references-31-8b5cf6?labelColor=0f172a)](#reference-library)
+[![Evals](https://img.shields.io/badge/evals-41-22c55e?labelColor=0f172a)](#validation)
 [![License](https://img.shields.io/badge/license-MIT-f59e0b?labelColor=0f172a)](LICENSE)
 
 Author: [Iamemily2050 (@iamemily2050)](https://github.com/Emily2040) · [Instagram](https://instagram.com/iamemily2050) · [X](https://x.com/iamemily2050) · [Website](https://iamemily2050.com)
 
-Platform context: [ByteDance Seedance 2.0](https://seed.bytedance.com/en/seedance2_0) · [Dreamina](https://dreamina.capcut.com) · [Jimeng](https://jimeng.jianying.com) · [BytePlus ModelArk](https://docs.byteplus.com/en/docs/ModelArk/2291680)
+Platform context: [ByteDance Seedance 2.0](https://seed.bytedance.com/en/seedance2_0) · Dreamina · Jimeng · Doubao · [Volcengine Ark](https://www.volcengine.com/docs/82379/2291680?lang=zh) · [BytePlus ModelArk](https://docs.byteplus.com/en/docs/ModelArk/2291680) · [Runway Seedance 2](https://docs.dev.runwayml.com/guides/seedance/)
 
-Updated: **2026-05-30** · **v5.4.1 final source sweep, agent compatibility notes, and infographic polish**
+Updated: **2026-05-30** · **v5.4.2 section-depth refresh, Runway/Volcengine surface updates, deeper vocabulary, and new cinematic hero**
 
 ---
 
@@ -31,10 +31,10 @@ The repository gives an AI assistant a public, auditable operating system for Se
 This skill package turns Seedance 2.0 work into a repeatable assistant workflow:
 
 - Routes vague ideas into short creative interviews instead of premature prompt dumps.
-- Writes full or compressed prompts for T2V, I2V, V2V, R2V, audio-aware, and first/last-frame workflows.
+- Writes full or compressed prompts for T2V, I2V, V2V, R2V, FLF2V, edit, extend, audio-aware, and first/last-frame workflows.
 - Separates every reference asset by role: identity, environment, motion, camera rhythm, audio tempo, style, or endpoint.
 - Keeps model and platform claims source-dated so API, pricing, region, quota, and model-ID details are not guessed.
-- Provides multilingual cinematic vocabulary in Chinese, Japanese, Korean, Spanish, and Russian.
+- Provides deeper multilingual cinematic vocabulary in Chinese, Japanese, Korean, Spanish, and Russian, including role binding, first/last-frame phrasing, edit/extend wording, safety wording, and audio cues.
 - Rewrites unsafe celebrity, protected IP, private-person, brand, logo, song, or voice requests into safer creative equivalents.
 - Diagnoses failed outputs with concrete repair levers: camera, lighting, motion, reference role, duration, framing, audio, or safety wording.
 - Ships validation scripts, eval cases, source data, and design checks so maintainers can review changes before release.
@@ -50,14 +50,19 @@ This skill package turns Seedance 2.0 work into a repeatable assistant workflow:
 | “Use this as first frame and that as final frame.” | [`first-last-frame-guide`](references/first-last-frame-guide.md) | A continuous transition with endpoint locks. |
 | “It failed or looks bad.” | [`seedance-troubleshoot`](skills/seedance-troubleshoot/SKILL.md) | A root-cause diagnosis and repaired prompt. |
 | “This uses a character, brand, celebrity, or real person.” | [`seedance-copyright`](skills/seedance-copyright/SKILL.md) | A safer rewrite preserving the creative function. |
+| “I need API, Runway, pricing, model ID, or production workflow guidance.” | [`api-workflow`](references/api-workflow.md) | A source-gated operational checklist. |
 | “Is this Seedance Pro/Fast/V2?” | [`model-name-map`](references/model-name-map.md) | Source-dated naming and surface caveats. |
 | “I am installing or reviewing this as an agent skill.” | [`agent-compatibility`](references/agent-compatibility.md) | Codex/Agent Skills structure and distribution notes. |
 
 ## Current Status Rule
 
 Seedance platform behavior changes quickly. Before making factual claims about API availability, face or portrait authorization, upload limits, pricing, regional availability, or model names, load [`references/api-status.md`](references/api-status.md) and check its `last_verified` date.
 
-As of 2026-05-30, public official sources describe Seedance 2.0 as supporting text, image, audio, and video inputs. Official launch and model-card material says references can include up to 9 images, 3 video clips, and 3 audio clips. Volcengine's May 29 tutorial keeps `doubao-seedance-2-0-260128` and `doubao-seedance-2-0-fast-260128` visible as current Ark model IDs, but access, pricing, upload limits, regions, and authorization requirements remain surface-specific.
+As of 2026-05-30, public official sources describe Seedance 2.0 as supporting text, image, audio, and video inputs. Official launch and model-card material says references can include up to 9 images, 3 video clips, and 3 audio clips.
+
+Volcengine's May 29 docs keep `doubao-seedance-2-0-260128` and `doubao-seedance-2-0-fast-260128` visible as current Ark model IDs and document first/last-frame role usage on that surface. Runway documents `seedance2` with 5-15 second duration and optional image, video, and audio references.
+
+Access, pricing, upload limits, regions, resolution, audio-combination rules, and authorization requirements remain surface-specific.
 
 ## Research Snapshot
 
@@ -133,6 +138,8 @@ The visual map is intentionally text-light so it remains clean in GitHub and reu
 | [`source-registry.md`](references/source-registry.md) | Source hierarchy and evidence labels. |
 | [`research-2026-05-30.md`](references/research-2026-05-30.md) | Dated source and field-observation snapshot. |
 | [`agent-compatibility.md`](references/agent-compatibility.md) | Agent Skills structure, Codex compatibility, and packaging notes. |
+| [`api-workflow.md`](references/api-workflow.md) | Volcengine, BytePlus, Runway, async task, reference-file, pricing, and production workflow checklist. |
+| [`examples-by-mode.md`](references/examples-by-mode.md) | Mode-specific prompt examples for T2V, I2V, V2V, R2V, FLF2V, edit, extend, and troubleshooting. |
 | [`platform-surface-matrix.md`](references/platform-surface-matrix.md) | Model-vs-surface claim boundaries. |
 | [`model-name-map.md`](references/model-name-map.md) | Seedance naming, Fast variant, and Pro-label caveats. |
 | [`first-last-frame-guide.md`](references/first-last-frame-guide.md) | FLF2V, first-frame, and last-frame prompting. |
@@ -161,7 +168,11 @@ The visual map is intentionally text-light so it remains clean in GitHub and reu
 
 ## Install
 
-Client support for Agent Skills is still tool-specific. Codex documents a skill as a directory with a required `SKILL.md`, optional `scripts/`, `references/`, `assets/`, and optional `agents/` metadata. It also distinguishes local skill authoring from plugins, which are the installable distribution unit for reusable skills and apps. This repository follows the skill-folder shape at the root and keeps dense facts in references so the active skill stays small.
+Client support for Agent Skills is still tool-specific. Codex documents a skill as a directory with a required `SKILL.md`, optional `scripts/`, `references/`, `assets/`, and optional `agents/` metadata.
+
+Codex scans `.agents/skills` locations from the working directory upward, plus user/admin/system skill locations. A repository root with `SKILL.md` is shaped like a skill folder, but it still needs to be installed/copied under a scanned skills directory or distributed as a plugin for automatic discovery.
+
+This repository keeps dense facts in references so the active skill stays small.
 
 If your client supports installing a skill directly from a GitHub repository, use this repository URL:
 
@@ -201,7 +212,7 @@ The v5.4 front page uses a generated cinematic bitmap hero, a generated operatin
 
 ## Changelog
 
-See [`CHANGELOG.md`](CHANGELOG.md). Current release: **v5.4.1**.
+See [`CHANGELOG.md`](CHANGELOG.md). Current release: **v5.4.2**.
 
 ## License
 

@@ -5,9 +5,35 @@ license: MIT
 user-invocable: true
 tags: [seedance]
 metadata:
-  version: "5.4.1"
+  version: "5.4.2"
 ---
 
 # seedance-20
 
-Router. Load interview for vague ideas, prompt for full scenes, prompt-short for compression, troubleshoot for bad outputs, and safety modules for IP or filters. Preserve reference tags, keep prompts compact, and check api-status for platform claims.
+Seedance 2.0 operating loop for agent-directed video work. Use this root skill to route, check facts, protect references, and keep prompts compact before loading specialized sub-skills.
+
+## Operating Loop
+
+1. Intake: identify the user's goal, target surface, mode, duration, aspect ratio, references, audio needs, and safety/IP risks.
+2. Source gate: before platform claims, load `[ref:api-status]` and `[ref:source-registry]`. For Runway or Volcengine specifics, also load `[ref:platform-surface-matrix]`.
+3. Mode gate: choose T2V, I2V, V2V, R2V, FLF2V, edit, extend, or troubleshoot before writing prose.
+4. Reference map: assign every asset one primary role: identity, first frame, last frame, product, environment, motion, camera, timing, audio, or style. State what must not transfer.
+5. Safety gate: route IP, likeness, voice, brand, real-person, graphic, or bypass-like wording through `[skill:seedance-copyright]` or `[skill:seedance-filter]`.
+6. Prompt build: route to `[skill:seedance-interview]`, `[skill:seedance-prompt]`, `[skill:seedance-prompt-short]`, or a domain skill for camera, motion, audio, characters, VFX, style, recipes, or pipeline.
+7. Quality pass: run anti-slop, check one visible beat, one primary camera move, physical light, sound intent, constraints, and source-date caveats.
+8. Repair loop: if output fails, diagnose root cause before adding adjectives; use `[skill:seedance-troubleshoot]`.
+
+## Load Map
+
+| Situation | Load |
+|---|---|
+| Vague idea or missing brief | `[skill:seedance-interview]` or `[skill:seedance-interview-short]` |
+| Production prompt | `[skill:seedance-prompt]`, `[ref:quick-ref]`, `[ref:prompt-examples]` |
+| Compact prompt or Chinese compression | `[skill:seedance-prompt-short]`, language vocab reference |
+| Image reference / first frame | `[ref:i2v-guide]`, `[ref:reference-workflow]` |
+| First and last frame | `[ref:first-last-frame-guide]` |
+| API, Runway, Volcengine, workflow, pricing, model IDs | `[skill:seedance-pipeline]`, `[ref:api-workflow]`, `[ref:model-name-map]` |
+| Genre template or examples | `[skill:seedance-recipes]`, `[ref:examples-by-mode]`, `[ref:genre-guides]` |
+| Bad result | `[skill:seedance-troubleshoot]` |
+
+Preserve reference tags exactly, keep prompts short, and never convert field-observed community tricks into official platform guarantees.
@@ -1,47 +1,137 @@
 {
-  "schema_version": "seedance-community-patterns.v1",
+  "schema_version": "seedance-community-patterns.v2",
   "generated_at": "2026-05-30",
-  "source": "external-awesome-seedance-2-prompts local checkout plus open web community guides; May 30 pass rechecked for structure, not raw prompt import",
-  "usage_rule": "Mine structure, vocabulary, timing syntax, and constraints only. Do not copy unsafe or IP-sensitive prompts into active examples.",
+  "usage_rule": "Mine structure, vocabulary, timing syntax, failure modes, and constraints only. Do not copy unsafe, IP-sensitive, real-person, celebrity, brand, or bypass prompts into active examples.",
   "labels": [
     "safe-example-candidate",
     "safe-structure-only",
     "ip-risk",
     "real-person-risk",
     "brand-risk",
     "violence-risk",
-    "low-quality"
+    "low-quality",
+    "bypass-risk"
   ],
   "patterns": [
     {
       "id": "timed-15s-three-beat",
       "label": "safe-structure-only",
+      "source_url": "https://github.com/YouMind-OpenLab/awesome-seedance-2-prompts",
+      "source_language": "multi",
+      "surface": "community corpus",
+      "claim_status": "field-observed",
+      "confidence": "medium",
+      "risk_flags": [],
       "features": ["0-5s / 5-10s / 10-15s timing blocks", "shot-specific camera", "action endpoint per beat"],
       "safe_use": "Use as a format for original scenes."
     },
+    {
+      "id": "director-instruction-stack",
+      "label": "safe-structure-only",
+      "source_url": "https://www.volcengine.com/docs/82379/2222480?lang=zh",
+      "source_language": "zh",
+      "surface": "official prompt guide",
+      "claim_status": "official",
+      "confidence": "medium",
+      "risk_flags": [],
+      "features": ["subject", "action", "space", "time", "camera", "style", "sound", "constraints"],
+      "safe_use": "Use as the main prompt skeleton after removing filler."
+    },
     {
       "id": "strict-i2v-preservation",
       "label": "safe-example-candidate",
+      "source_url": "https://seed.bytedance.com/en/blog/seedance-2-0-official-launch",
+      "source_language": "en",
+      "surface": "official launch examples",
+      "claim_status": "official",
+      "confidence": "high",
+      "risk_flags": [],
       "features": ["preserve logo/label/shape/color", "only light and environment change", "locked or slow camera"],
       "safe_use": "Use for product images owned or authorized by the user."
     },
     {
       "id": "reference-role-map",
       "label": "safe-example-candidate",
+      "source_url": "https://www.volcengine.com/docs/82379/2222480?lang=zh",
+      "source_language": "zh",
+      "surface": "official prompt guide",
+      "claim_status": "official",
+      "confidence": "medium",
+      "risk_flags": [],
       "features": ["image identity", "video camera rhythm", "audio tempo", "explicit no identity transfer"],
       "safe_use": "Use in R2V templates and multilingual examples."
     },
+    {
+      "id": "first-last-frame-role-control",
+      "label": "safe-structure-only",
+      "source_url": "https://www.volcengine.com/docs/82379/2298881?lang=zh",
+      "source_language": "zh",
+      "surface": "official platform docs",
+      "claim_status": "official",
+      "confidence": "medium",
+      "risk_flags": [],
+      "features": ["first_frame role", "last_frame role", "continuous transition", "mode-combination caveats"],
+      "safe_use": "Use in FLF2V docs after rechecking active surface field names."
+    },
+    {
+      "id": "audio-video-reference-conflict",
+      "label": "safe-structure-only",
+      "source_url": "https://www.reddit.com/r/generativeAI/comments/1tqsvb5/seedance_20_doesnt_really_follow_reference_audio/",
+      "source_language": "en",
+      "surface": "community forum",
+      "claim_status": "anecdotal",
+      "confidence": "medium",
+      "risk_flags": [],
+      "features": ["mute competing reference video", "audio controls tempo", "video controls camera only"],
+      "safe_use": "Use as troubleshooting advice labeled field-observed."
+    },
+    {
+      "id": "russian-structured-prompt-sections",
+      "label": "safe-structure-only",
+      "source_url": "https://vc.ru/ai/2809326-seedance-2-0-kak-sozdat-video-neirosyetyu",
+      "source_language": "ru",
+      "surface": "community guide",
+      "claim_status": "field-observed",
+      "confidence": "medium",
+      "risk_flags": [],
+      "features": ["Камера:", "Свет:", "Движения:", "Звук:", "Ограничения:"],
+      "safe_use": "Use as Russian prompt section vocabulary without copying scenes."
+    },
     {
       "id": "negative-constraint-block",
       "label": "safe-structure-only",
+      "source_url": "https://github.com/YouMind-OpenLab/awesome-seedance-2-prompts",
+      "source_language": "multi",
+      "surface": "community corpus",
+      "claim_status": "field-observed",
+      "confidence": "medium",
+      "risk_flags": [],
       "features": ["no text", "no watermark", "no subtitles", "no logo redesign", "no identity change"],
       "safe_use": "Convert into positive constraints where possible."
     },
     {
       "id": "protected-style-name",
       "label": "ip-risk",
-      "features": ["named studio", "named franchise", "named public figure"],
+      "source_url": "https://www.youware.com/seedance-2-0-prompts",
+      "source_language": "en",
+      "surface": "public prompt gallery",
+      "claim_status": "field-observed",
+      "confidence": "high",
+      "risk_flags": ["ip-risk", "brand-risk", "real-person-risk"],
+      "features": ["named studio", "named franchise", "named public figure", "brand prompt"],
       "safe_use": "Rewrite into medium, palette, texture, composition, and motion descriptors."
+    },
+    {
+      "id": "face-limit-workaround-claims",
+      "label": "bypass-risk",
+      "source_url": "https://docs.comfy.org/zh/tutorials/partner-nodes/bytedance/seedance-2-0",
+      "source_language": "zh",
+      "surface": "partner docs plus community discussion",
+      "claim_status": "mixed",
+      "confidence": "medium",
+      "risk_flags": ["real-person-risk", "bypass-risk"],
+      "features": ["portrait verification", "liveness", "asset authorization", "unsupported workaround claims"],
+      "safe_use": "Route to official authorization or virtual portrait assets; do not import workaround advice."
     }
   ]
 }