| 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
- Run
npm install if dependencies are missing.
- Run
npm run dev.
- Keep the Flovart browser tab open for provider-backed commands.
- Check local state:
npm run flovart:cli -- status --json
- 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.
