前言¶
在 IDE 或 CLI 里做短视频、概念片或静图动效时，常见做法是单独打开某个视频生成站点，手工上传素材、等任务完成再下载。流程和对话上下文是割裂的，也不方便在同一轮任务里改提示词或换参考图。
agnes-视频模型 是 SkillHub 上的社区 Skill（坐标 @user_69c32a7b/agnes-video，版本 1.0.0），把 Agnes Video v2.0 的能力封装成 Agent 可遵循的说明：支持文生视频、图生视频、多图生视频与关键帧动画，并采用「提交任务 → 轮询结果」的异步工作流。当你的需求命中触发词（如「生成视频」「文生视频」「图生视频」「Agnes视频」等）时，Agent 会按 Skill 指引调用后端能力，而不是让你自己记 API 细节。
这是什么¶
一句话定位：面向设计/媒体类任务的 Agnes 视频生成 Skill，分类为 design-media，来源为社区（community），由 SkillHub 用户 user_69c32a7b 发布；SkillHub 页面标注作者为「醉吟先生」。
它解决的是：在支持 Skills 的 Agent 环境中，用自然语言或简短指令完成电影感（cinematic）视频生成，并统一处理异步任务的生命周期。
核心功能¶
以下能力均来自 SkillHub 官方简介，对应底层为 Agnes Video v2.0：
- 文生视频（text-to-video）：根据文本描述生成视频。
- 图生视频（image-to-video）：以单张图像为输入生成动态画面。
- 多图生视频（multi-image-to-video）：多张参考图参与生成。
- 关键帧动画（keyframe animation）：在关键帧之间做动画过渡。
工作流特点：异步任务。先提交作业（submit a job），再通过轮询（poll）获取最终结果，适合生成耗时较长的视频任务。
Skill 还声明了 Agent 应在用户提出下列意图时使用本 Skill，包括但不限于：生成视频、创建 AI 视频、制作短片、让图片动起来、从文字或图片生成视频、使用 Agnes 做视频生成。英文侧触发包括 generate video、create video、animate 等；中文侧包括「AI视频」「agnes-video」等。
SkillHub 标签 requires_api_key=true，表示使用前需要配置 Agnes 相关 API Key（具体环境变量名与申请入口以 Skill 安装包内 SKILL.md 为准，本文不臆造字段名）。
安装与启用¶
SkillHub 推荐通过其 CLI 安装，并必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已安装：
command -v skillhub && skillhub --version
未安装时可执行官方完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文见：https://skillhub.cn/install/skillhub.md。
2、安装本 Skill¶
官方页面给出的安装指引为：根据上述 skillhub.md，安装坐标 @user_69c32a7b/agnes-video。
在终端中可搜索并安装到对应目录，例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub search agnes-video
skillhub install @user_69c32a7b/agnes-video --dir ~/.cursor/skills/
其他环境的 skills 目录以 SkillHub 文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。安装后按你所用 Agent 的要求刷新或重启，使 Skill 被加载。
3、API Key¶
因标签要求 API Key，安装完成后应在 Agent 或本机环境中按 SKILL.md 配置 Agnes 访问凭证，再发起生成任务。
典型用法¶
本 Skill 没有单独暴露一套与 CLI 平行的「复制即用」脚本示例；典型用法是在对话中说明目标，由 Agent 读取 Skill 后走异步流程。
可参考的表述方式：
- 文生视频：说明画面、镜头与时长意向，例如「用 Agnes 文生视频：雨夜城市街道，电影感，约 5 秒」。
- 图生视频：提供本地或 URL 图片路径，并说明希望的运动方式，例如「把这张图做成缓慢推进的镜头」。
- 多图 / 关键帧：说明多张图的角色或关键帧顺序，例如「用这两张图做关键帧过渡，风格保持一致」。
Agent 侧一般会：解析你的意图 → 提交异步任务 → 轮询直到可下载或展示结果。若任务失败，应依据 Skill 内错误处理说明调整提示词、素材或 Key 配置后重试。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作，希望视频生成与编码、写稿在同一上下文完成。
- 需要文生视频、图生视频、多图或关键帧动画，且能接受异步等待。
限制与注意
- 社区来源：行为与 SLA 以发布者与 Agnes 服务为准，使用前自行评估合规与费用。
- 必须 API Key：未配置 Key 时无法真正调用生成接口。
- 异步轮询：不宜假设「秒出」；长任务需要 Agent 或你方接受轮询等待。
- 数据口径：SkillHub 页面显示评分
100000、下载约1498次（统计以 SkillHub 为准，会随时间变化）。
结尾¶
agnes-视频模型 把 Agnes Video v2.0 的多种生成模式与异步任务流程写进 Skill，让 Agent 在用户说「生成视频」「图生视频」等话时自动走正确路径。若你要安装或查看详情，请以 SkillHub 为准：
- Skill 页：https://www.skillhub.cn/skills/user_69c32a7b/agnes-video
- 安装坐标：
@user_69c32a7b/agnes-video - API 入口（Skill 元数据）：https://api.skillhub.cn/user_69c32a7b/agnes-video
