opencreator-skills

name	opencreator-skills
description	Operate and build OpenCreator workflows via API. Use when the user wants to search templates, run workflows, poll results, deliver generated media, or design custom workflow graphs with nodes and edges on OpenCreator. Triggers: opencreator, workflow, template, UGC, ecommerce images, storyboard video, lipsync, content creation pipeline.

OpenCreator Workflow Skill

Activation

Use this skill when the task involves any of:

• Searching or running OpenCreator templates
• Running an existing workflow and getting results
• Building or editing a workflow graph (nodes + edges)
• UGC, storyboard video, ecommerce multi-image, or similar content creation

Mode Decision

User request
  │
  ├─ Run template / get results / "帮我做 XX" ──► Operate Mode (default)
  │
  └─ Create workflow / edit graph / "从零搭" / no suitable template ──► Build Mode

Always try Operate Mode first. Switch to Build Mode only when:

• No suitable template exists after searching
• The user explicitly asks to create or edit a workflow
• The required graph differs materially from any available template

If a task needs both, do Build first (produce the graph), then Operate (run it).

---

Operate Mode

Must read: references/api-workflows.md

This single file covers the complete Operate flow:

1. Configuration (Base URL, API Key)
2. Search templates by keyword
3. Present candidates, user selects
4. Copy template → get flow_id
5. Query runtime parameters
6. Collect user inputs (ask every field, never use defaults)
7. Run workflow
8. Poll status
9. Deliver results (media directly, not just links)

Supplementary (read only when you need deeper tactics):

• references/best-practices.md — template-first strategy and design principles

Operate Hard Rules

• Always copy template before running (public templates are read-only)
• Always query parameters before each run (node IDs can change)
• inputs must be flat: { "node_id": "value" } — never wrap in extra object
• Never expose node_id / inputText / imageBase64 to users — use business language
• Search results must be ranked by relevance and only show top 5 to the user
• After starting a run, you MUST poll until terminal state (success/failed/cancelled) — never stop and wait for the user to ask. This is your #1 obligation.
• On success, immediately fetch results and deliver media to the user — do not end your turn without delivering.
• Poll every 10 s for text/image, 30 s for video
• Deliver media directly, not just URLs

---

Build Mode

When building or editing a workflow graph, follow these four steps in order. Do not skip any step.

Step 1: Structure Reverse-Planning

Work backward from the user's final deliverable to identify the abstract structure and module dependencies.

Answer these questions first:

• What is the final output?
• Does it need a semantic layer (text/script generation)?
• Does it need a visual branch (image/video)?
• Does it need an audio branch (TTS/music)?
• Does it need a compositing layer?
• Can all leaf inputs trace back to user input or generatable primitives?

Must read:

• references/step-1-reverse-plan/workflow-reverse-planner.md
• references/node-catalog.md

Output: Macro Format + Dependency Graph

Step 2: Generator Selection & Wiring

Map abstract modules to concrete generators and plan edges + naming.

Must read:

• references/step-1-reverse-plan/generator-wiring-naming-planner.md
• references/step-1-reverse-plan/generator-routing.md

Then read the matching file in references/step-2-generators/ (see routing table below).

Step 3: Model Selection & Parameters

Choose models, fill selectedModels and parameters for each node.

Hard rule before choosing any model:

• Treat the Confirmed model IDs tables in each Step 3 file as the source of truth for model IDs
• Only use model IDs that are explicitly mapped to the current node type / atom
• If a model is recommended in prose but its exact ID is not listed for that atom, do not use it
• Never translate a marketing name (for example Sora 2, GPT Image 1.5, Seedream 5.0 Lite) into a guessed model ID
• If an atom has no dedicated Step 3 file, use references/node-catalog.md as the fallback source of truth
• If an atom still has no stable model-selection entry after checking those docs, keep the documented fixed behavior and do not invent selectedModels

Read the matching file in references/step-3-models/ (see routing table below).

Step 4: Prompt Writing

Write prompts for nodes that need inputText.

Must read:

• references/step-4-prompts/prompt-prewrite-reasoner.md

Then read the matching prompt best-practices file (see routing table below).

---

Step 2 Generator Routing Table

Text Generation

• Text only → script: references/step-2-generators/reference-text-generator.md
• Reference image → text: references/step-2-generators/reference-image-text-generator.md
• Reference video → text: references/step-2-generators/reference-video-text-generator.md
• Multimodal input → text: references/step-2-generators/multimodal-text-generator.md
• Script → storyboard split: references/step-2-generators/storyboard-text-splitter.md

Image Generation

• Text → image: references/step-2-generators/text-to-image-generator.md
• Multi-image reference → image: references/step-2-generators/image-reference-generator.md
• Storyboard batch images: references/step-2-generators/storyboard-image-generator.md
• Relight: references/step-2-generators/relight-image-generator.md
• Angle control: references/step-2-generators/angle-control-image-generator.md

Video Generation

• Text → video: references/step-2-generators/text-to-video-generator.md
• Image → video: references/step-2-generators/image-to-video-generator.md
• Storyboard broadcast: references/step-2-generators/storyboard-video-generator.md
• Storyboard aligned: references/step-2-generators/storyboard-video-generator-aligned.md
• Omni video: references/step-2-generators/omni-video-generator.md
• Lipsync: references/step-2-generators/lipsync-video-generator.md
• Motion transfer: references/step-2-generators/motion-transfer-video-generator.md
• Video modify / style transfer: references/step-2-generators/video-modify-generator.md

Audio Generation

• Text → speech: references/step-2-generators/text-to-speech-generator.md
• Voice cloning: references/step-2-generators/voice-cloning-generator.md
• Music: references/step-2-generators/music-generator.md

Step 3 Model Routing Table

• Source of truth for exact IDs: the Confirmed model IDs table in each file below, with references/node-catalog.md as fallback for nodes without a dedicated Step 3 file
• textGenerator / scriptSplit: references/step-3-models/text-generator-model-selection.md
• imageMaker: references/step-3-models/text-to-image-model-selection.md
• imageToImage: references/step-3-models/image-to-image-model-selection.md
• videoMaker: references/step-3-models/image-to-video-model-selection.md
• textToVideo: references/step-3-models/text-to-video-model-selection.md
• textToSpeech: references/step-3-models/text-to-speech-model-selection.md
• Input nodes: references/step-3-models/input-block-skill.md
• Not listed above: check references/node-catalog.md

Step 4 Prompt Routing Table

• Before writing any prompt: references/step-4-prompts/prompt-prewrite-reasoner.md
• textGenerator prompts: references/step-4-prompts/text-prompt-best-practices.md
• Image node prompts: references/step-4-prompts/image-prompt-best-practices.md
• Video node prompts: references/step-4-prompts/video-prompt-best-practices.md

---

Key Concepts

Broadcast

1 image + N texts → N results. Must use imageInput as the reference image source, not a generated image.

Alignment

N images + N texts, 1:1 pairing. Counts must match exactly.

List Propagation

scriptSplit outputs a text list; downstream generators auto-expand per item — do not duplicate generator nodes.

Shared Semantic Layer

In complex scenarios (lipsync ads, multi-branch video), generate a shared structured brief first, then fork to visual and audio branches.

---

Scenario References

• UGC lipsync ad: references/scenarios/scenario-ugc-lipsync-ad.md
• Storyboard video: references/scenarios/scenario-storyboard-video.md
• Ecommerce multi-image: references/scenarios/scenario-ecommerce-multi-image.md

---

Build Mode Output

After completing the four steps, output standard nodes + edges JSON.

Node and edge schema: references/node-catalog.md

Save via create_workflow tool if available, otherwise via the Workflow PATCH API (see references/api-workflows.md §10).