video-to-gif

by sallyxie2026

Install this Skill

curl -fsSL -o video-to-gif.zip https://skill.seembox.com/api/v1/skills/video-to-gif/download && unzip video-to-gif.zip

Download video-to-gif.zip

SKILL.md About

---
name: video-to-gif
description: Use when converting a video clip into a GIF with ffmpeg. Supports trimming by start time and duration, controlling frame rate and width, and returning the output file details. Includes bilingual Chinese-English guidance.
---

# Video to GIF / 视频转 GIF

## Purpose / 功能定位

### English

Use this skill when the task is to convert a video file into a GIF animation.

This skill is intended for requests such as:

- convert a video to GIF
- make a GIF from a clip
- export part of a video as a GIF
- create a smaller GIF by limiting width, frame rate, or duration

### 中文

当任务是把一个视频文件转换成 GIF 动图时，应使用这个 Skills。

这个 Skills 适合处理以下类型的请求：

- 把视频转成 GIF
- 从视频里截取一段做成 GIF
- 导出视频片段为 GIF
- 通过限制宽度、帧率、时长来生成更小的 GIF

## What This Skill Does / 这个 Skills 做什么

### English

This skill uses `ffmpeg` to convert video into GIF and supports:

- custom frame rate
- custom output width
- custom start time
- custom duration
- output file summary after conversion

### 中文

这个 Skills 使用 `ffmpeg` 将视频转换为 GIF，并支持：

- 自定义帧率
- 自定义输出宽度
- 自定义开始时间
- 自定义截取时长
- 转换完成后输出结果摘要

## Prerequisites / 前置依赖

### English

This skill requires:

- `ffmpeg`
- `ffprobe`

Before running the script, check:

```bash
command -v ffmpeg
command -v ffprobe
```

If either command is missing, ask the user to install ffmpeg first instead of trying to auto-install it silently.

### 中文

这个 Skills 依赖：

- `ffmpeg`
- `ffprobe`

运行脚本前先检查：

```bash
command -v ffmpeg
command -v ffprobe
```

如果缺少其中任意一个命令，应先提示用户安装 `ffmpeg`，而不是静默自动安装。

## Quick Start / 快速开始

### English

```bash
python3 scripts/convert.py input.mp4 output.gif
python3 scripts/convert.py input.mp4 output.gif --fps 12 --width 360
python3 scripts/convert.py input.mp4 output.gif --start 00:00:03 --duration 5
```

### 中文

## Parameters / 参数

| Parameter / 参数 | Type / 类型 | Required / 必填 | Default / 默认值 | Description / 说明 |
|---|---|---|---|---|
| `input` | string | yes | - | input video path / 输入视频路径 |
| `output` | string | yes | - | output GIF path / 输出 GIF 路径 |
| `fps` | number | no | 15 | output frame rate / 输出帧率 |
| `width` | number | no | 480 | output width in pixels / 输出宽度像素 |
| `start` | string | no | `0` | clip start time / 开始时间 |
| `duration` | string | no | - | clip duration / 持续时间 |

## Workflow / 工作流程

### English

1. Confirm the input file exists.
2. Confirm `ffmpeg` and `ffprobe` are installed.
3. Choose optional parameters such as `fps`, `width`, `start`, and `duration`.
4. Run the conversion script.
5. Return the output path, size, dimensions, and frame rate.

### 中文

1. 确认输入文件存在。
2. 确认 `ffmpeg` 和 `ffprobe` 已安装。
3. 选择需要的可选参数，例如 `fps`、`width`、`start`、`duration`。
4. 执行转换脚本。
5. 返回输出路径、文件大小、尺寸和帧率。

## When To Use / 适用场景

### English

Use this skill when the user wants a GIF generated from a local video file.

### 中文

当用户希望从本地视频文件生成 GIF 时，应使用这个 Skills。

## When Not To Use / 不适用场景

### English

Do not use this skill for:

- editing video timelines in a full editor
- downloading online videos
- generating animated stickers in platform-specific formats
- converting images into GIF slideshows

### 中文

以下场景不应使用这个 Skills：

- 完整的视频时间线编辑
- 下载在线视频
- 生成特定平台格式的动态贴纸
- 把多张图片拼接成 GIF 轮播

## Script / 脚本

### English

Use:

```bash
python3 scripts/convert.py <input> <output> [--fps N] [--width N] [--start T] [--duration T]
```

### 中文

使用方式：

```bash
python3 scripts/convert.py <input> <output> [--fps N] [--width N] [--start T] [--duration T]
```

_meta.json Metadata

{
  "ownerId": "kn72pgthvmk4vp4tz0ryqdv2r582qn9f",
  "publishedAt": 1773245032309,
  "slug": "video-to-gif",
  "version": "1.0.0"
}