前言¶
点播业务往往横跨上传、转码、媒资查询和 AIGC 能力，接口多、参数细，查文档和拼请求会占掉不少时间。若在 Cursor、Claude Code 等环境里用自然语言描述需求，再由 Skill 按腾讯云 VOD 的语义生成对应命令或调用思路，可以把「记接口名、对字段」的负担降下来。下面介绍 SkillHub 上的 Tencent VOD Intl.（@tencent-adm/tencent-vod-intl），以及它的能力边界与安装方式。
这是什么¶
Tencent VOD Intl. 是腾讯云点播（Video on Demand，VOD）的命令生成助手：当用户请求涉及 VOD 相关操作时，Agent 应触发该 Skill，按场景产出可执行的命令或操作指引。
- 坐标：
@tencent-adm/tencent-vod-intl - 当前版本：1.1.3（SkillHub 页面标注为 v1.1.3）
- 来源：enterprise
- 分类：it-ops-security
- 发布者：腾讯视频云 MPaaS 团队（SkillHub 预抓取元数据）
- 标签：
requires_api_key=true（使用腾讯云 VOD 通常需要配置 API 密钥，具体字段以 Skill 内说明与控制台为准）
Skill 采用通用 SKILL.md 格式，托管在 SkillHub；页面入口为 SkillHub - Tencent VOD Intl.，API 元数据地址为 https://api.skillhub.cn/tencent-adm/tencent-vod-intl。
核心功能¶
以下能力均来自 SkillHub 官方简介，按业务域归纳；Skill 会在对应话题出现时主动参与，而不是替代控制台或 SDK 的全部细节。
上传（Upload）¶
- 本地上传、URL 拉取上传
- 过期时间、SessionId、存储路径等相关配置
媒体处理（Media Processing）¶
- 转码、TESHD、截图、雪碧图
- 画质增强、真人相关处理、剧集/场景转码
- 重封装、HLS、GIF、自适应码率
- 审核、任务流（task flow）、编排（procedure）
媒资查询（Media Query）¶
- 按 FileId 查询详情、转码结果、字幕、封面、元数据等
AIGC¶
- 文生图、文生视频、图生视频（官方列出的模型包括 Kling、Kling 2.1、Hunyuan、Vidu、GEM、GEM 2.5、GV、Hailuo 等）
- LLM 对话（GPT、Gemini 等）
- 场景图/视频生成、换装、扩图、商品图、360° 展示、自定义元素等
AIGC Token 与用量¶
- Token 管理、用量统计
搜索（Search）¶
- 按名称、语义、知识库检索
- 按标签、存储类型、审核结果、过期时间等筛选
图像处理（Image Processing）¶
- 超分、降噪、增强、图像理解
子应用与任务（Sub-app / Task）¶
- 子应用查询、任务状态查询
明确不触发的范围¶
官方说明：不要因以下需求触发本 Skill——MPS 相关操作、COS 直传、直播 CSS（Cloud Streaming Service）等。这类问题应走对应产品文档或其它 Skill，避免生成错误的 VOD 命令。
安装与启用¶
安装分两种方式：让 Agent 按 SkillHub 安装文档执行，或使用 skillhub CLI 装到当前环境的 skills 目录。
方式一：通过 Agent 安装（SkillHub 页面推荐）¶
将下面提示词发给当前使用的 AI 客户端，由其读取安装说明并完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencent-vod-intl`。
方式二：使用 SkillHub CLI¶
先确认是否已安装 CLI（SkillHub 安装与优先源配置）：
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档中的推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。文档给出的常见路径示例：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装本 Skill 的命令形式如下（将 <skills 目录> 换成上表对应路径）：
skillhub install @tencent-adm/tencent-vod-intl --dir <skills 目录>
也可先搜索再安装：
skillhub search tencent-vod-intl
skillhub install @tencent-adm/tencent-vod-intl --dir <skills 目录>
因标签为 requires_api_key=true，启用后还需在 Skill 指引或腾讯云控制台中配置 VOD 访问所需的 API 密钥；具体变量名以 Skill 包内 SKILL.md 为准，本文不臆造配置项名称。
典型用法¶
本 Skill 的定位是「按需触发 + 生成命令」，没有单独公布的 REST 演示工程；典型用法是在已安装 Skill 的 Agent 里用自然语言描述 VOD 意图，由 Agent 引用 Skill 后输出 CLI、API 参数或操作步骤。下列表述与官方能力列表一致，可作为复现起点（实际输出以 Agent 与 Skill 版本为准）：
- 上传：「帮我把这个公网视频 URL 拉到 VOD，并说明 SessionId 和存储路径要怎么填。」
- 转码：「对 FileId
xxx做 HLS 自适应码率转码，走默认任务流。」 - 查询：「根据 FileId 查转码产物、字幕和封面信息。」
- AIGC：「用 Kling 做一段文生视频，并说明如何查任务状态。」
- 搜索：「在媒资里按语义搜带某标签、未过期的视频。」
若问题属于 MPS、COS 直传或直播 CSS，应换用对应工具或文档，而不是强行走本 Skill。
适用场景与注意¶
适合谁
- 已在用或计划用腾讯云国际站/点播 VOD 的开发者、运维、媒资工程师
- 希望在 IDE Agent 里用对话完成「查接口、拼参数、理流程」，而不是每次翻长篇 API 手册的团队
使用注意
- 能力是命令与流程辅助，不替代账号权限、计费与合规审核；生产变更仍需在控制台或自有流水线中复核。
- API Key 敏感，勿提交到仓库；与
requires_api_key=true一致，密钥应放在环境变量或密钥管理服务中。 - 版本以 SkillHub 为准（当前页面为 1.1.3）；升级可用
skillhub的更新能力（参见 安装文档第三节）。 - SkillHub 预抓取统计显示评分为 100000、下载约 846 次、安装约 4 次；页面数据会变动，引用时以 SkillHub 实时页面为准。
结尾¶
Tencent VOD Intl. 把点播上传、处理、查询、AIGC、搜索与任务状态等常见话题收敛成一套 Agent 触发规则与命令生成逻辑，并划清了与 MPS、COS 直传、直播的边界。若你的日常工作流已经围绕腾讯云 VOD，可以按上文安装到 Cursor 或 Claude Code 的 skills 目录，从一次真实的 FileId 查询或转码需求试起。
