Skip to content
Skills Library
Marketing & content · Conversion & formats

transcode

/transcode

Ad-hoc transcode of a video file or folder — pick codec, container, resolution, framerate, and rate-control on the spot. Uses the hardware encoder detected by profile-system when available, falls back to libx264/libx265. Use when the user says "transcode this", "convert these to h.265", "change the framerate to 30", "make these smaller", or "VBR to CBR".

Licence
MIT
Last repository change
03.05.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Ad-hoc transcode of a video file or folder — pick codec, container, resolution, framerate, and rate-control on the spot. Uses the hardware encoder detected by profile-system when available, falls back to libx264/libx265. Use when the user says "transcode this", "convert these to h.265", "change the framerate to 30", "make these smaller", or "VBR to CBR".

Triggers from the description

transcode thisconvert these to h.265change the framerate to 30make these smallerVBR to CBR
Original author description

Ad-hoc transcode of a video file or folder — pick codec, container, resolution, framerate, and rate-control on the spot. Uses the hardware encoder detected by profile-system when available, falls back to libx264/libx265. Use when the user says "transcode this", "convert these to h.265", "change the framerate to 30", "make these smaller", or "VBR to CBR".

How it works

  1. Procedure
Original SKILL.md headings · 86 lines, 344 words
SKILL.md preview
---
name: transcode
description: Ad-hoc transcode of a video file or folder — pick codec, container, resolution, framerate, and rate-control on the spot. Uses the hardware encoder detected by profile-system when available, falls back to libx264/libx265. Use when the user says "transcode this", "convert these to h.265", "change the framerate to 30", "make these smaller", or "VBR to CBR".
disable-model-invocation: false
allowed-tools: Bash(ffmpeg *), Bash(ffprobe *), Bash(test *), Bash(mkdir *), Bash(ls *), Bash(find *), Bash(jq *), Bash(stat *), Bash(basename *), Bash(dirname *), Bash(realpath *), Read, Write
---

# Transcode

Generic, on-demand transcoding. Unlike `render-with-profile` (which uses a saved preset), this skill takes parameters per invocation. Use it for one-offs, format conversions, framerate changes, or fixes (VBR → CBR).

## Procedure

### 1. Resolve system profile

```bash
DATA_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/video-editing"
SYS_FILE="$DATA_DIR/system-profile.json"
test -f "$SYS_FILE" && HAVE_SYS=1 || HAVE_SYS=0
```

If missing, warn the user that the skill will fall back to libx264/libx265 (slower, CPU-only) and offer to run `profile-system`.

### 2. Inputs

Ask if not provided:

| Field | Example |
|-------|---------|
| Source | file or folder |
| Codec | h264 / hevc / av1 / copy (stream-copy) |
| Container | mp4 / mkv / mov |
| Resolution | source / 1920x1080 / 1280x720 |
| Framerate | source / 24 / 30 / 60 |
| Rate control | crf / qp / cbr / vbr — with value |
| Output dir | default: sibling `transcoded/` folder |

### 3. Pick encoder

If `HAVE_SYS=1`, read `.encoders.<codec>.preferred` from `system-profile.json`. Otherwise:

| Codec | Software fallback |
|-------|-------------------|
| h264 | libx264 |
| hevc | libx265 |
| av1  | libsvtav1 |

For `codec=copy`, skip encoder selection — just `-c:v copy -c:a copy` (useful for container changes).

### 4. Build the ffmpeg command

VAAPI hardware path:

```bash
ffmpeg -hide_banner -i "$IN" \
  -vaapi_device "$RENDER_NODE" \
  -vf 'format=nv12,hwupload[,scale_vaapi=...]' \
  -c:v "$ENCODER" -qp "$QP" \
  -r "$FPS" \
  -c:a aac -b:a 192k \
  -movflags +faststart \
  "$OUT"
```

Software path:

```bash
ffmpeg -hide_banner -i "$IN" \
  [-vf scale=...] -r "$FPS" \
  -c:v "$ENCODER" -crf "$CRF" -preset medium \
  -c:a aac -b:a 192k \
  -movflags +faststart \
  "$OUT"
```

For CBR: `-c:v libx264 -b:v <rate> -minrate <rate> -maxrate <rate> -bufsize <2*rate>`.

Show the resolved command before running. Ask for confirmation when transcoding more than 1 file.

### 5. Loop and report

```bash
mkdir -p "$OUT_DIR"
for in in <inputs>; do
  out="$OUT_DIR/$(basename "${in%.*}").$CONTAINER"
  ffmpeg -hide_banner -y -i "$in" <args> "$out"
  echo "$in -> $out ($(stat -c%s "$out") bytes)"
done
```

Originals are never modified. Summarize input vs. output total bytes at the end.

Versions

The database has no other skills named transcode.

Database snapshot: 13.11.2026 · package version 18e228e0a17b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100video-framerate-enhance
    使用 meitu-cli 提升视频帧率/插帧(如 24fps → 60fps),让低帧率视频运动更流畅。当用户提到补帧、插帧、加帧、提帧率、升帧率、60 帧、120 帧、流畅度、帧率不够、视频卡顿时触发。
  • 100create-render-profile
    Build a named, reusable render profile (codec + resolution + bitrate/QP + container) by iterating on a 30-second test clip until file size and quality are right. Use when the user says "create a render profile", "tune my YouTube preset", "I want a render preset for archival", or…
  • 100ffmpeg-transcode
    Transcode video/audio between codecs and containers with ffmpeg (H.264, HEVC, AV1, VP9, ProRes, AAC, Opus; MP4, MKV, WebM, MOV). Use when the user asks to convert a video, change codec, re-encode, reduce file size with CRF, target a bitrate, do 2-pass encoding, change container,…
  • 100processing-video
    Audio and video processing with ffmpeg. Use when: user asks to convert, trim, merge, compress, or transcode video or audio files; extract audio from video; create GIFs or animated WebP from video; add subtitles or watermarks to video; change video resolution, framerate, or…
  • 95ponyflash
    Generate images, videos, speech audio, and music using the PonyFlash Python SDK. Also handle local media editing with FFmpeg, including clip, concat, transcode, extract audio, frame capture, subtitle capability checks, and ASS subtitle prep. Use when the user asks to create,…
  • 100transcode-jpeg-to-jxl-lossless
    Losslessly transcode JPEG files to JPEG XL, preserving the original JPEG bitstream while achieving ~20% file size reduction. Use when archiving JPEG photo libraries where the goal is smaller files without re-compression artifacts.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.