agentleFS
godot-fungodot-fun/godot-agent/.agents/skills/video-to-mp4/SKILL.md

video-to-mp4

Skill210 starsChanged 2 days agoMITView on GitHub

Converts a single video file to a broadly compatible MP4 using FFmpeg (H.264 video, AAC audio, yuv420p, and faststart), while preserving source resolution and frame rate. Stream-copies an already compatible H.264/AAC MP4 to avoid generation loss. Use when the user wants to convert MKV/MOV/WebM/AVI/OGV or another video to MP4, transcode a video for browser/device compatibility, or mentions H.264, AAC, libx264, faststart, or MP4 export.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 4 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Add faststart metadata for web playback.

    line 13
  2. Very specific:

    Read and follow dependency-manager.

    line 18
  3. Very specific:

    Never overwrite the source.

    line 53
  4. Distinctive:

    Use the bundled script instead of writing an ad-hoc FFmpeg command.

    line 57
  5. Distinctive:

    Keep the default quality and compatibility settings unless the user explicitly asks otherwise.

    line 58
  6. Distinctive:

    Do not resize or change frame rate.

    line 59
  7. Very specific:

    Use --force-encode only when the user explicitly wants re-encoding of an already compatible MP4.

    line 60
  8. Very specific:

    If Python or FFmpeg is missing, populate .dependency/ per dependency-manager and retry.

    line 62

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Video to MP4

Convert one supported video file to a broadly compatible MP4 via FFmpeg.

  • Encode video as H.264 (libx264), CRF 18, preset slow, yuv420p.
  • Encode audio as AAC 192 kbps.
  • Preserve source resolution, frame rate, audio sample rate, and channel layout.
  • Add faststart metadata for web playback.
  • Stream-copy an already compatible H.264/AAC MP4.

Rules

Read and follow dependency-manager. Run the bundled script as documented and install missing tools into .dependency/.

Quick Start

.dependency/python/python .ai/video-to-mp4/convert.py --video path/to/video.mkv

Default output:

assets/video/intro.mkv
  -> assets/video/video-to-mp4/intro.mp4

Format Defaults

SettingDefaultNotes
ContainerMP4+faststart enabled
VideoH.264 / libx264CRF 18, preset slow, high profile
Pixel formatyuv420pBroad hardware/browser compatibility
AudioAAC 192 kbpsSource rate and channels preserved
Resolution / frame ratePreserve sourceNo scaling or FPS conversion
Compatible H.264/AAC MP4Stream copyNo generation loss

Common Flags

--video · -o / --output · --crf · --preset · --audio-bitrate · --force-encode

.dependency/python/python .ai/video-to-mp4/convert.py --video path/to/video.webm --output path/to/out.mp4
.dependency/python/python .ai/video-to-mp4/convert.py --video path/to/video.mov --crf 20 --preset medium

Never overwrite the source. Input must be one video file, not a directory. Supported inputs: .mp4, .mkv, .mov, .avi, .webm, .wmv, .flv, .m4v, .mpeg, .mpg, .ts, .mts, .m2ts, .3gp, .ogv.

Agent Notes

  1. Use the bundled script instead of writing an ad-hoc FFmpeg command.
  2. Keep the default quality and compatibility settings unless the user explicitly asks otherwise.
  3. Do not resize or change frame rate.
  4. Use --force-encode only when the user explicitly wants re-encoding of an already compatible MP4.
  5. Tell the user where the video-to-mp4/ output was written; do not replace the source.
  6. If Python or FFmpeg is missing, populate .dependency/ per dependency-manager and retry.
  7. See reference.md for the exact FFmpeg pipelines.

Tests

.dependency/python/python .ai/video-to-mp4/test_convert.py

Manual examples: cli/video-to-mp4.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.