flovart

name	flovart
description	Flovart official agent skill. Use when operating Flovart canvas, media, workflow, providers, models, assets, or project state through the deterministic Flovart CLI. External agents plan; Flovart CLI executes explicit commands. Do not invent HTTP calls, scrape the UI, or expose API keys.

Flovart CLI Skill

Flovart is an AI Canvas Studio runtime for images, videos, workflows, storyboards, assets, and publish review. Agents should operate it through the local deterministic CLI:

npm run flovart:cli -- <command> --json

The source of truth for command names and options is:

npm run flovart:cli -- command.list --json
npm run flovart:cli -- command.schema --command <command> --json

If this skill disagrees with command.list or command.schema, trust the CLI output and update the skill docs.

Non-Negotiable Rules

• Flovart is not the planner. The external agent writes scripts, shot lists, prompts, retry strategy, and final summaries.
• Use the CLI for canvas/project/model/media operations. Do not hand-roll private HTTP requests or add protocol servers.
• Never read, print, copy, or store API keys in CLI output or chat transcripts.
• Provider-backed generation requires the browser UI because keys stay in browser storage.
• Canvas automation for external agents is media-first. Prefer image/video elements for production artifacts; use text elements only when explicitly documenting canvas structure.
• Send explicit prompts and structured JSON. Do not pass vague natural-language instructions into deterministic commands.
• For slow or failed jobs, inspect status and patch the smallest affected element or workflow node. Do not rebuild the whole canvas by default.

Setup

1. Run npm install if dependencies are missing.
2. Run npm run dev.
3. Keep the Flovart browser tab open for provider-backed commands.
4. Check local state:

npm run flovart:cli -- status --json

5. If models or providers are missing, open safe setup:

npm run flovart:cli -- provider.begin-setup --purpose both --json

Runtime Modes

• file-state: local shadow runtime. Supports canvas inspection, media add/update/select/remove, workflow load/update, and export metadata without a browser.
• file-bridge: queued browser execution. Used for provider status/model selection/readiness checks, image/video generation, workflow run, and element ignite. The Vite app polls .flovart/command-queue.json through /__flovart/queue.
• Browser UI: the only place API keys are entered and used.

Documentation Map

Read only the file needed for the current task.

Topic	File
Install, setup, host init	scripts/install.md
Project context	commands/project.md
Group context	commands/group.md
LibTV-style node operations	commands/node.md
Upload local media	commands/upload.md
Runtime status and diagnostics	commands/status.md
Provider setup, model selection, readiness	commands/provider.md
Canvas inspect, media upload/add/update/remove	commands/canvas.md
Element create, prompt, slots, ignite, watch	commands/element.md
Workflow inspect/load/update/run	commands/workflow.md
Assets, generated history, project export	commands/asset.md
Image/video generation commands	commands/generate.md
Image shortcuts	commands/image.md
Script/storyboard commands	commands/script.md
Prompt helpers, model list, preferences	commands/model.md
Canvas element types	node-types/README.md
Model and provider schema notes	model-schema/schema.md
Common end-to-end cases	examples/README.md

Common Workflows

Inspect Before Acting

npm run flovart:cli -- status --json
npm run flovart:cli -- canvas.inspect --json
npm run flovart:cli -- provider.status --json

Add Reference Media

npm run flovart:cli -- canvas.upload-image --path "C:/absolute/ref.png" --name "character-a-ref" --x 120 --y 160 --json

Create a Generated Image Element

npm run flovart:cli -- element.create --type image --name "unit-01-keyframe" --x 520 --y 160 --width 320 --height 180 --json
npm run flovart:cli -- element.update-prompt --element-id <id> --text-prompt "cinematic keyframe..." --json
npm run flovart:cli -- element.ignite --element-id <id> --wait --timeout-ms 120000 --json

Generate Directly

npm run flovart:cli -- generate.image --prompt "premium product hero shot..." --aspect-ratio 16:9 --place-on-canvas true --wait --json
npm run flovart:cli -- generate.video --prompt "8 second locked-off product reveal..." --source-image-ids id1,id2 --duration 8 --aspect-ratio 16:9 --wait --json

Delivery Checklist

For creative jobs, return:

• What was created or changed on the canvas.
• Main media element IDs, job IDs, and output URLs when available.
• Failed or pending nodes with the smallest retry plan.
• Any user action needed in the browser UI, especially provider setup.