How do I install the Cutr skill?

Run npx skillmds@latest add luisfer-cli/cutr in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cutr?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

luisfer-cli (@luisfer-cli) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cutr by luisfer-cli — Agent Skill

Name: Cutr
Rating: 4.2 (5 reviews)
Author: luisfer-cli

Cutr

Explains and uses cutr, a minimal Kdenlive-as-code DSL that compiles video timelines to ffmpeg. Use when editing .cutr files, validating cutr projects, generating ffmpeg/render commands, or explaining how cutr's timeline, assets, filters, transitions, audio, subtitles, and output options work.

luisfer-cli Updated Sep 22, 2026

File contents

cutr

Use this skill when the user works with cutr or .cutr timeline files.

What cutr is

cutr is a tiny video DSL: one line per timeline item, key=value options, compiled to an ffmpeg command.

Basic flow:

Declare reusable inputs with asset id=... path=....
Add timeline items: video, image, gif, audio, text, subtitle, concat.
Set final export with output ....
Run cutr check, cutr ffmpeg, or cutr render.

Commands

cargo run -- check proyecto.cutr
cargo run -- ffmpeg proyecto.cutr
cargo run -- render proyecto.cutr --from 10 --to 20
cargo run -- ffmpeg proyecto.cutr --preview
cargo run -- proyecto.cutr

Use ffmpeg mode first when debugging; it prints the generated command without rendering.

Minimal file

asset id=clip path=video.mp4

video asset=clip at=0 duration=5
text text="Hola" at=1 duration=2 align=center y=80 size=56 color=white

output path=out.mp4 duration=5 size=1920x1080 fps=30 preset=youtube

Timeline model

at places an item on the timeline.
from, to, duration trim or bound input/time.
Items layer by track or z_index; higher values render later/on top.
x/y, anchor_x/anchor_y, scale, rotate, opacity control overlay placement.
*_kf values are keyframes: time:value[:linear|ease-in|ease-out]|....

Common features

Video/image/GIF:

video asset=clip at=0 from=2 duration=5 track=1 \
  x_kf=0:0|2:400:ease-out y=0 scale_kf=0:1|2:1.2 \
  fade_in=0.3 fade_out=0.3 transition=slide transition_from=left transition_duration=0.5

Audio:

audio asset=music at=0 duration=8 volume=0.8 fade_in=1 normalize=true compressor=true

Subtitles/text:

text text="Mi título" at=1 duration=3 align=center y=80 size=56 color=white outline=2 shadowx=2 shadowy=2
subtitle text="hola mundo" at=4 duration=2 y=900 size=36 outline=2

Output:

output path=out.mp4 duration=8 size=1920x1080 fps=30 preset=youtube bitrate=8M

Agent rules

Prefer the smallest valid .cutr file that renders the requested result.
Reuse existing assets by id; do not duplicate asset declarations.
Run cutr check before render when possible.
If render is slow, use --preview or --from/--to.
For exact supported keys and edge cases, read references/cutr-reference.md.

---name: cutrdescription: Explains and uses cutr, a minimal Kdenlive-as-code DSL that compiles video timelines to ffmpeg. Use when editing .cutr files, validating cutr projects, generating ffmpeg/render commands, or explaining how cutr's timeline, assets, filters, transitions, audio, subtitles, and output options work.license: MIT---# cutrUse this skill when the user works with `cutr` or `.cutr` timeline files.## What cutr is`cutr` is a tiny video DSL: one line per timeline item, `key=value` options, compiled to an `ffmpeg` command.Basic flow:1. Declare reusable inputs with `asset id=... path=...`.2. Add timeline items: `video`, `image`, `gif`, `audio`, `text`, `subtitle`, `concat`.3. Set final export with `output ...`.4. Run `cutr check`, `cutr ffmpeg`, or `cutr render`.## Commands```bashcargo run -- check proyecto.cutrcargo run -- ffmpeg proyecto.cutrcargo run -- render proyecto.cutr --from 10 --to 20cargo run -- ffmpeg proyecto.cutr --previewcargo run -- proyecto.cutr```Use `ffmpeg` mode first when debugging; it prints the generated command without rendering.## Minimal file```cutrasset id=clip path=video.mp4video asset=clip at=0 duration=5text text="Hola" at=1 duration=2 align=center y=80 size=56 color=whiteoutput path=out.mp4 duration=5 size=1920x1080 fps=30 preset=youtube```## Timeline model- `at` places an item on the timeline.- `from`, `to`, `duration` trim or bound input/time.- Items layer by `track` or `z_index`; higher values render later/on top.- `x/y`, `anchor_x/anchor_y`, `scale`, `rotate`, `opacity` control overlay placement.- `*_kf` values are keyframes: `time:value[:linear|ease-in|ease-out]|...`.## Common featuresVideo/image/GIF:```cutrvideo asset=clip at=0 from=2 duration=5 track=1 \ x_kf=0:0|2:400:ease-out y=0 scale_kf=0:1|2:1.2 \ fade_in=0.3 fade_out=0.3 transition=slide transition_from=left transition_duration=0.5```Audio:```cutraudio asset=music at=0 duration=8 volume=0.8 fade_in=1 normalize=true compressor=true```Subtitles/text:```cutrtext text="Mi título" at=1 duration=3 align=center y=80 size=56 color=white outline=2 shadowx=2 shadowy=2subtitle text="hola mundo" at=4 duration=2 y=900 size=36 outline=2```Output:```cutroutput path=out.mp4 duration=8 size=1920x1080 fps=30 preset=youtube bitrate=8M```## Agent rules- Prefer the smallest valid `.cutr` file that renders the requested result.- Reuse existing assets by `id`; do not duplicate asset declarations.- Run `cutr check` before render when possible.- If render is slow, use `--preview` or `--from/--to`.- For exact supported keys and edge cases, read `references/cutr-reference.md`.

Frequently asked questions