Organizing & declutter video generation#

Picture this: a messy pile of clothes, sorted by a bear’s paws into neat rows, colors shifting into a gradient rainbow—the moment the clear box lid clicks, the frame goes still in the best way. That’s what this skill delivers; describe the scene in one line and generate.

Dependencies: WERYAI_API_KEY + Node.js 18+. When you run the CLI, scripts/video_gen.js must exist; WERYAI_VIDEO_API.md must exist under resources/ (supply both via publish or pre-use assembly). Full commands and JSON fields: see resources/WERYAI_VIDEO_API.md. No other Cursor skills. Default parameters and model tiers are in the tables below; live API limits follow weryai models. Before installing or running, review the bundled video_gen.js to confirm it meets your requirements. Pay particular attention to how it handles local files if you choose to allow their usage, ensuring this behavior aligns with the skill's intended workflow for image-to-video requests.

Registry metadata: The only required runtime secret is WERYAI_API_KEY. It appears in YAML frontmatter as top-level requires.env (flow mapping, for tools that flatten root keys only), metadata.openclaw.primaryEnv, and metadata.openclaw.requires.env. Skill directories and registries should surface that requirement up front so installers see it before download. Never commit the key inside the package.

Before you install or set WERYAI_API_KEY#

Complete this checklist before installing the package or placing any API key in the environment:

1. Trust and account fit: Decide whether you trust WeryAI as a processor and whether your key’s permissions and quotas are acceptable for paid video generation.
2. Key hygiene: Do not paste a production key into chat or logs. Start with a limited-scope or test key until you are satisfied with behavior and cost.
3. Review scripts/video_gen.js: Read the bundled script yourself. Non– --dry-run runs send your prompt and image inputs (public https URLs and, when used, bytes uploaded per WERYAI_VIDEO_API.md) to https://api.weryai.com and https://api-growth-agent.weryai.com (models / upload paths as documented). Treat prompts and media as leaving the device.
4. Data sensitivity: If you must limit leakage, run in an isolated or test environment. Use --dry-run on wait / submit-* (see WERYAI_VIDEO_API.md) to inspect the JSON the CLI would send without performing a paid submit.
5. If you are not comfortable with authenticated network calls to WeryAI or with exposing prompts/media to that service, do not set WERYAI_API_KEY or run paid commands.

Prerequisites#

• WERYAI_API_KEY must be set in the environment before running video_gen.js.
• Node.js 18+ is required. Prefer public https image URLs. If the assembled scripts/video_gen.js supports local file paths, review and verify the script first, then get explicit consent before it reads a local image and uploads it to WeryAI to obtain a public URL.
• Each successful wait run consumes WeryAI credits; re-running creates new paid tasks.

Security, secrets, and API hosts#

• WERYAI_API_KEY: Treat as a secret. Only configure it if you trust this skill's source; it is listed in OpenClaw metadata as requires.env / primaryEnv so installers know it is mandatory at runtime (never commit it inside the skill package).
• API hosts (fixed in video_gen.js): Video tasks use https://api.weryai.com; the models list uses https://api-growth-agent.weryai.com. The bundled script pins these bases in code— only WERYAI_API_KEY is read from the environment for authentication. Do not rely on any environment variables to change API hostnames; requests only go to those official endpoints plus the documented upload URL when a local image is uploaded (see WERYAI_VIDEO_API.md).
• Local image handling disclosure: Prefer public https image URLs. If the assembled scripts/video_gen.js supports local file paths, it may read a local image and upload it to WeryAI to obtain a public URL; require review / verification and explicit consent before using that path.
• Higher assurance: Follow ## Before you install or set WERYAI_API_KEY above; use a short-lived or isolated environment for paid runs; review scripts/video_gen.js (HTTPS submit + poll loop) before production use. Verify whether the runtime can read local image files and upload them to WeryAI, and obtain explicit consent before using that path.

Prompt expansion (mandatory)#

video_gen.js does not expand prompts. Before every wait --json, turn the user's short or vague brief into a full English production prompt.

When: The user gives only keywords, one line, or loose intent—or asks for richer video language. Exception: They paste a finished long prompt within the model's prompt_length_limit and ask you not to rewrite; still show the full text in the confirmation table.

Always add (video language): shot scale and angle; camera move or lock-off; light quality and motivation; subject action paced to duration; one clear payoff for this niche; state 9:16 vertical when this skill defaults to vertical.

Length: Obey prompt_length_limit for the chosen model_key when this doc lists it; trim filler adjectives before removing core action, lens, or light clauses.

Confirmation: The pre-submit table must include the full expanded prompt (never a one-line summary). Wait for confirm or edits.

Niche checklist#

• Chaos → order: zones, containers, color unity, satisfying snap/align; overhead or 45° for layout reads.
• Character optional: anthropomorphic tidy arc or hands-only; strong before/after density change.
• Motion: time-lapse stack, fold, or slide-in—one clear payoff beat.

### Example prompts at the top of this file are short triggers only—always expand from the user's actual request.

Workflow#

1. Confirm the user request matches this skill's scenario (text-to-video and/or image-to-video as documented).
2. Collect the user's brief, optional image URL(s), tier ( best / good / fast) or an explicit model key.
3. Expand prompt (mandatory): Unless the user supplied a finished long prompt and explicitly asked not to rewrite it, expand the brief into a full English production prompt using ## Prompt expansion (mandatory) below. Do not call the API with only the user's minimal words.
4. Check the expanded prompt against the selected model's prompt_length_limit in the frozen tables in this document (when present); shorten if needed.
5. Verify duration, aspect_ratio, resolution, generate_audio, negative_prompt, and other fields against the frozen tables in this document and WERYAI_VIDEO_API.md.
6. Show the pre-submit parameter table including the full expanded prompt; wait for confirm or edits.
7. After confirmation, run node scripts/video_gen.js wait --json '...' with the expanded prompt.
8. Parse stdout JSON and return video URLs; on failure, surface errorCode / errorMessage and suggest parameter fixes.

CLI reference#

sh

node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>

Full reference: WERYAI_VIDEO_API.md.

Definition of done#

Done when the user receives at least one playable video URL from the API response, or a clear failure explanation with next steps. All parameters used must fall within the selected model's allowed sets in this document. The submitted prompt must be the expanded production prompt unless the user explicitly supplied a finished long prompt and asked not to rewrite it.

Boundaries (out of scope)#

• We do not review platform compliance, copyright, or likeness; we do not warrant commercial usability of outputs.
• We do not provide offline rendering outside WeryAI, traditional NLE projects, or API field combinations not documented in this SKILL or WERYAI_VIDEO_API.md.
• Do not link to weryai-model-capabilities.md or shared ../references/ paths; use resources/WERYAI_VIDEO_API.md for CLI/API details.
• Do not hard-code absolute paths in this doc; run from the skill package root (next to SKILL.md) so scripts/ and resources/ paths resolve.

Example prompts#

• Exploded closet, bear folds clothes into a color gradient, door close one-take
• From this messy desk: sort into boxes, labels aligned
• Fridge before/after, bottles turned uniform—OCD comfort
• Organizing satisfying 9:16, messy to perfectly aligned containers

---

Default parameters#

FieldValueModelKLING_V3_0_PROAspect9:16 (fixed, vertical short)Duration5 s ( duration: 5, peak moments first)AudioOff (pair with BGM; beat cuts work better)LookOverhead or ~45° close, soft diffuse light, strong color unity, extreme before/after contrast

API validity (default KLING_V3_0_PRO): Text-to-video: duration only 5 / 10 / 15, aspect_ratio only 9:16, 1:1, 16:9; image-to-video: aspect_ratio only 9:16, 16:9, 1:1; no resolution field—do not send. Fast VEO tier: text VEO_3_1_FAST, image CHATBOT_VEO_3_1_FAST, duration fixed 8, aspect_ratio only 9:16 or 16:9. For other model_key values, follow the allowed sets in this document and the API validity notes above; do not send unsupported fields such as resolution.

---

Anthropomorphic organizing#

Algorithm-friendly organizing: cute animals (bear / bunny / cat) take a space from total mess to obsessively neat—clear bins, unified palette, drawer zones are visual peaks.

User gives character type + space; the rest is prompt-filled.

Flow:

Collect character + scene → build a prompt with full chaos→order arc and key satisfying beats → show parameter confirmation → run node scripts/video_gen.js wait --json '…' (fields match the confirmation table)

Full parameters are shown before generate; wait for confirmation:

• model: KLING_V3_0_PRO
• aspect_ratio: 9:16
• duration: 5
• generate_audio: false
• seamless loop: off (reply "loop" to enable—append seamless loop to prompt)

Expanded prompt: Compose at generation time per ## Prompt expansion (mandatory) from the user's actual brief—do not reuse fixed sample paragraphs.

Expected outcome: Natural cute motions, clear satisfying beats on placement, unified palette visible in the final frame—high completion, strong “neat freak” appeal.

---

Space before/after (no character)#

Single organizing moves at peak satisfaction: drawer jam-packed → zoned; suitcase chaos → Tetris-perfect pack; empty clear box → filled in one beat—show the change; no character needed.

Prep: Name the space (closet / fridge / vanity / toolbox / desk / luggage) and the hook (unified color sort / clear bins / drawer zones / dense pack feel).

Flow:

1. Confirm space type and hook direction

2. Build prompt emphasizing motion paths, color unity, final visual density

3. Show all parameters in a table and wait for explicit user confirmation before submitting:

   📋 Ready to generate—please confirm:

   FieldThis runNotesmodel``KLING_V3_0_PROBest tier default; fast: text VEO_3_1_FAST, image CHATBOT_VEO_3_1_FAST ( duration fixed 8); good → KLING_V3_0_STA; or specify a model nameaspect_ratio``9:16Default KLING: 9:16, 1:1, 16:9 only; if you switch model, check that row’s aspect_ratios etc.duration``5sKLING family: 5 / 10 / 15; VEO fast: duration 8 onlygenerate_audio``falseAuto-generate audio or notpromptFull expanded English prompt (entire text for this run)Revise before confirmseamless loopoffReply "loop" to add seamless loop

   Reply "confirm" to start, or list what to change.

4. After confirmation, in the terminal from the skill package root: sh

   node scripts/video_gen.js wait --json '{"model":"(confirmed model)","prompt":"(full English prompt)","aspect_ratio":"9:16","duration":5,"generate_audio":false}'
   
   

   aspect_ratio, duration, generate_audio, model must match the table; add resolution only if the model supports it. Parse videos from stdout.

Expanded prompt: Compose at generation time per ## Prompt expansion (mandatory) from the user's actual brief—do not reuse fixed sample paragraphs.

---

Hook keyword cheat sheet#

Chaos→order: chaotic transforms to pristine, disorder gives way to perfect symmetry, before-after single frame, satisfying before/after reveal

Color unity: rainbow color gradient sorted by hue, uniform palette emerges, color-matched arrangement, chromatic order from chaos

Clear storage: clear acrylic containers, transparent labeled storage boxes, stackable organizer bins, see-through compartments reveal contents

Dense pack: zero wasted space, maximum density perfect fit, Tetris-perfect packing, compression reveals hidden capacity

Tip: Rhythm matters—add time-lapse with satisfying snap moments or speed ramp at key placement moments so placements feel on-beat for edited music.