1.0.1
Fixed
- Running scripts/prompt.mjs through a symlinked install now works. Before, it exited without writing anything.
video-prompt
Write video prompts in the project's brand, sized and timed for each platform, ready for any video generator. Reads the project's own brand file for palette, look, motion, tone and a don't list, and never stores brand values itself. Writes the prompt, a JSON with size, ratio, length and a suggested model, and on request short paste steps for a web tool. It never generates a video and never spends credits. Needs Node 18 or newer.
Say this you do not type commands, you ask
- “write a video prompt”
- “prompt for a reel”
- “make a prompt to animate this photo”
- “prompt for a product video”
- “give me a prompt I can paste into Kling”
- “how long should this reel be”
- “video prompt”
Once it is installed, that is the whole interface. Your agent picks the skill up on its own and runs whatever it needs to. The commands further down are there for anyone who would rather drive it themselves.
Install pick your agent
Changelog what changed, newest first
1.0.0
Added
- Write a short video prompt in the project's brand, from a brand file the project owns. No brand file is fine.
- Five shots: turntable, hero reveal, editorial, detail, and animating an existing photo.
- Sizes and accepted lengths for Reels, Stories, TikTok, YouTube, Shorts, LinkedIn, Facebook and product pages. A length a platform refuses is refused here too.
- A JSON beside each prompt with size, ratio, length and a suggested Higgsfield model, a cheaper draft model, and how many clips a longer piece needs.
- Short paste steps for any web video tool.
- A prompt log per project that stops the same prompt being written twice.
An agent that has this installed reads CHANGELOG.md in the skill folder.
The same history is at changelog.json,
and every tool's releases are at /updates.json.
Just ask
Once the skill is installed, say what you want in your own words:
"write a prompt for a 7 second reel of our tote bag turning slowly" "animate this product photo for a story" "give me a prompt I can paste into Kling for a launch teaser" "how long should a Facebook story video be?"
The agent writes the prompt, shows it to you, and says where it saved it. Nothing is generated and nothing is spent. To make the video, hand the prompt to a video generator: the higgsfield-studio skill when it is installed, which prices every job first, or any web tool by paste.
Why this exists
A good video prompt carries a lot: the brand's colours and look, the right size for the platform, what to avoid, and how things should move, and for how long. Writing that by hand every time is slow, and it drifts. This skill builds it the same way every time, from the brand file the project already keeps, and keeps a log so the same prompt is not written twice.
Requirements
Node 18 or newer. If you do not have it, the skill offers to install it:
sh scripts/setup-deps.sh --check # is everything present?
sh scripts/setup-deps.sh # show the install command, ask, then run it
.\scripts\setup-deps.ps1 # Windows
It works offline and needs no account.
The brand file
Keep a brand.md in the project (or pass --brand FILE). Sections are found by their headings: palette, photography, studio, motion, tone and don't. The full contract and an example are in references/brand-file.md. Without one, prompts carry no brand style.
If you prefer the command line
node scripts/prompt.mjs sizes
node scripts/prompt.mjs brand
node scripts/prompt.mjs --subject "a tan leather tote bag" --type hero-reveal --platform instagram_reel --seconds 7 --paste Kling
Each run writes prompt.txt, prompt.json and, with --paste, PASTE.md to a dated folder under .prompts/ (or --out DIR). .prompts/log.jsonl is the log the duplicate check reads. Keep it.
Built at Itqan Lab, a design and technology studio.
إتقان — itqan, the Arabic word for mastery: doing a thing precisely, and completely.