前言¶

做短视频、分镜预览或互动内容时，画面往往先定稿，音效却要单独找素材库、对节奏、再剪辑对齐。纯靠 Agent 写提示词，也很难直接得到与画面一致的短音效。若希望 Coding Agent 在对话里根据场景描述或某一帧画面生成配套音效，需要一条把「文本 / 帧图像」接到 Kling SFX 能力上的 Skill 路径。

下面介绍 SkillHub 社区技能 keling sfx（坐标 @user_f95f21b8/dlazy-keling-sfx，当前版本 1.0.9）：它面向 design-media 类任务，用 Kling SFX 生成与场景匹配的声音效果。

这是什么¶

keling sfx 是发布者 user_f95f21b8 在 SkillHub 上架的社区 Skill（来源标注为 community）。官方简介为：

Generate matching scene sound effects based on text descriptions or video frames using Kling SFX.

一句话：让 Agent 根据文字场景描述或视频帧，调用 Kling SFX 生成对应的场景音效。Skill 采用通用 SKILL.md 格式，安装后由 Agent 读取技能说明并按其中步骤调用后端能力。

SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-keling-sfx
API 条目：https://api.skillhub.cn/user_f95f21b8/dlazy-keling-sfx

核心功能¶

依据已公开资料，可确认的能力边界如下：

1. 文本驱动：用自然语言描述场景（环境声、动作声等），生成匹配的音效。
2. 视频帧驱动：以视频中的某一帧为参考，生成与该画面氛围一致的音效。
3. 底层模型：能力来自 Kling SFX（可灵音效相关能力），Skill 本身负责在 Agent 工作流里暴露调用方式。
4. 需 API 密钥：SkillHub 标签为 requires_api_key=true，使用前需按 SKILL.md 配置密钥；具体字段名与获取方式以安装包内文档为准。

未在官方页面单独列出的参数、输出格式或计费细则，本文不展开，避免与 SKILL.md 不一致。

安装与启用¶

SkillHub 推荐的安装方式是：先按官方安装说明准备 skillhub CLI，再把该 Skill 装到当前 Agent 能识别的 skills 目录（装错目录会导致 Agent 读不到技能）。

1. 检查或安装 skillhub CLI¶

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 文档执行完整安装（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. 安装 keling sfx¶

官方页面给出的安装提示为：根据上述安装文档，安装 @user_f95f21b8/dlazy-keling-sfx。

命令形态与 SkillHub 通用约定一致（--dir 必须指向本机 Agent 的 skills 目录）：

skillhub install user_f95f21b8/dlazy-keling-sfx --dir <你的 Agent skills 目录>

常见路径（摘自 SkillHub 安装文档，按你实际使用的客户端选择其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后重启或刷新 Agent，使其加载新 Skill；API Key 等配置请打开技能目录中的 SKILL.md 按发布者说明填写。

典型用法¶

公开 SkillHub 页未附带独立示例仓库，典型流程应遵循 SKILL.md 中的 Agent 指引，与简介一致的使用意图如下：

1. 在对话中说明要生成的音效场景（例如「雨夜街道、远处车流」「木门缓慢推开」），由 Agent 走文本生成路径。
2. 若已有视频或分镜，提供某一帧或让 Agent 截取帧，走「画面 → 音效」路径。
3. 因标记了 requires_api_key=true，首次使用前在 SKILL.md 要求的位置配置 API 密钥，再发起生成。

具体子命令、请求字段与返回 JSON 结构以安装后的 SKILL.md 为准；不要在未读文档的情况下臆造 CLI 参数。

适用场景与注意¶

适合谁

• 需要在 Cursor、Claude Code、Codex 等带 Skills 的 Agent 里，把「写分镜 / 描述场景」和「出音效」放在同一条对话链路里的创作者或开发者。
• 已具备或可申请 Kling SFX 相关 API 访问（Skill 依赖密钥）。

限制与注意

• 社区来源（community），升级与维护节奏跟随发布者 user_f95f21b8，使用前可看 SkillHub 上的版本号（当前 v1.0.9）。
• SkillHub 统计（以 API 抓取为准）：评分 100000，下载 977，安装 3；数字仅作商店参考，不代表效果保证。
• 涉及上传视频帧或调用云端 API 时，注意素材版权、隐私与服务商条款。
• 安装务必使用 --dir 指向正确 skills 目录；否则默认可能落在 ./skills/，Agent 无法识别。

结尾¶

keling sfx 把 Kling SFX 的「文本 / 视频帧 → 场景音效」能力封装成 Agent Skill，减轻找素材和对轨的成本。若你要在本地 Agent 中启用，可从 SkillHub 页面与安装文档入手：

• https://www.skillhub.cn/skills/user_f95f21b8/dlazy-keling-sfx
• https://skillhub.cn/install/skillhub.md