framefields is made to be driven by a coding agent. A film is a TypeScript file, every check is a function that returns data, and every review step produces a file the agent can open and look at. You describe the video; the agent writes, renders, inspects and fixes it.
Install the skills
Section titled “Install the skills”/plugin install framefieldsnpx skills add gatewai-dev/framefieldsWorks with Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Goose, Cline and 70+ others.
Then ask for a video:
Set up framefields in this project and render a 3-second title card that says "Hello".The skills are instructions only: no MCP servers, hooks or executables, and they send no data anywhere. Details per agent are on Install the skills.
Why it suits agents
Section titled “Why it suits agents”| Plain code | A video is a Composition in TypeScript. Diffs, reviews, tests and git all work. |
| Deterministic | (composition, frame) → pixels. The same frame renders the same way every time, so checks are repeatable. |
| Checks return data | comp.lint() and renderVideo({ qa }) return { severity, code, message } objects, not logs to parse. |
| Cheap feedback | One PNG frame or a contact-sheet grid in seconds, long before a full render. |
| People in the loop | The live preview saves notes a person pins on the picture to notes.json — exact feedback an agent can act on. |
| No creative suite | One npm package; no browser, no desktop apps, no licenses. |
The loop
Section titled “The loop”- Write
film.tsexportingbuildFilm(). - Check —
tsc --noEmit, thencomp.lint(). - Look — render key frames to PNG and open them.
- Look at motion — render a frame grid.
- Show — start the live preview; read the person’s pinned notes.
- Ship —
renderVideo({ qa: true }); stop ifqa.passedis false.
Full detail in The agent workflow.
Install the skillsClaude Code, Codex, Cursor, Gemini CLI, Copilot and more; project or global; team setup.
The skillsWhat each of the four skills teaches and when it loads.
The agent workflowWrite → check → look → show → ship, with code.
Example promptsPrompts that work well, from first render to vision effects.
Docs for agentsllms.txt, Markdown pages, and an AGENTS.md snippet.