scenario-labs/skills

Get production-ready images, video, audio, and 3D from any AI agent: skills that pick the right model, price before spending, and keep characters and brands consistent through the Scenario MCP, plus expert teams that drive Blender, Maya, ZBrush, Unreal, and Unity.

概览

Scenario Agent Skills 是一套精选的 Agent Skills 集合——这些是小型、可重复使用的指令，让 AI 编程助手（如 Claude Code、Cursor、GitHub Copilot 等）能与 Scenario MCP 平台互动。Scenario 提供云端服务，用于生成生产级的创意资产（图像、视频、音频、3D 模型、纹理、天空盒、自定义训练模型），这些资产广泛应用于游戏、营销及其他娱乐制作流程中。

此仓库整合了 71 个独立技能，每个技能皆提供单一功能（例如 scenario-image、scenario-video-editing、scenario-3d）。开发者通过 npx skills add 指令安装技能后，即可赋予 AI 助手新的调用功能，并传递提示词、参考文件或风格设置等参数。随后，助手会与 Scenario MCP 服务器沟通、执行生成工作流程，并回传完成的资产。

关键点

目标受众 – AI 辅助创作者、游戏开发团队、营销制作人，以及任何希望通过 LLM 自动生成或编辑视觉/音频内容的用户。
技术堆栈 – 使用 Agent Skills 规范 (https://agentskills.io) 与 Scenario MCP HTTP API。这些技能仅为轻量级封装；繁重的工作（扩散模型、视频合成、3D 重建等）皆在 Scenario 的后端执行。
安装模式 – 技能通过 skills CLI (npx skills add …) 安装。用户可安装完整套件、基于角色的子集，或个别技能。
扩展性 – 遵循相同的文件夹与 SKILL.md 模式即可新增技能，随着 Scenario 发布更多资产类型，此集合将持续成长。

安装与使用

先决条件

Scenario MCP 服务器 – 您必须拥有 Scenario MCP 端点的访问权限（默认为 https://mcp.scenario.com/mcp）。
验证 – 使用 Scenario 账号登录 (OAuth) 或提供 API 密钥（可在 Scenario 应用程序设置中找到）。
skills CLI – 本仓库假设您已安装 skills 命令行工具（由 Agent Skills 生态系统提供）。

快速开始（安装所有项目）

npx skills add scenario-labs/skills \
  --skill scenario \
  --skill scenario-image \
  ... (列出所有 71 个技能) ...

这将从 main 分支拉取每个技能的最新版本。

基于角色的安装示例

游戏美术与 3D (22 个技能) – 安装精灵图、纹理、天空盒与 3D 生成工具。
营销与品牌视觉 (22 个技能) – 专注于产品照、品牌套件、广告变体与缩略图制作。
视频与音频 (23 个技能) – 提供文字转视频、视频编辑、音乐视频组装与音频合成功能。
ChatGPT 与 Codex 宠物 – 为 LLM 驱动的聊天机器人建立动画头像资产。

每个角色指令皆记录于 INSTALL.md 中。

连接至 MCP

claude mcp add --transport http scenario https://mcp.scenario.com/mcp

或使用端点与您的 API 密钥设置任何 MCP 客户端。scenario 技能包含完整的连接工作流程。

更新

在先前安装技能的目录中执行 npx skills update，或重复执行原始的 add 指令以获取最新的定义。

核心概念

概念	对用户的意义
Agent Skill	一个微小、独立的描述（位于 `SKILL.md`），告诉 AI 助手如何调用特定的 Scenario API、预期输入为何，以及回传何种输出。
MCP (Model-Control-Plane)	Scenario 的服务器，负责协调生成任务、存储资产并提供状态轮询。
Lead skill	`scenario` 技能 – 建立所有其他技能所依赖的基础“发现-执行-等待-下载”循环。
Sibling/lead-skill 关系	更专业的技能（例如 `scenario-video-editing`）会调用 `scenario` 的核心循环，并增加额外的参数或后处理步骤。
专家工具	选用的系列工具，用于驱动本地 DCC 软件（Blender、Unreal、Unity 等） – 它们不属于云端 MCP 流程的一部分，且需要在本机安装对应的应用程序。

值得注意的技能（精选）

技能	主要用途
scenario-image	文字转图像生成与遮罩修复；可选择模型、尺寸与参考图像。
scenario-video	文字转视频或图像转视频生成、唇形同步、动作提示与基础编辑工具。
scenario-3d	将文字或图像转换为 3D 网格 (GLB/FBX)，支持多视角重建与重新贴图。
scenario-game-assets	批次建立精灵图、图标、图块集与概念美术，并保持风格一致性。
scenario-audio	生成音乐、音效、配音；包含视频配乐工具。
scenario-brand-kit	根据简报制作完整的视觉识别套件（SVG 标志、调色盘、字体规格）。
scenario-chatgpt-pet-create	从概念或照片生成动画“宠物”头像（精灵图表、GIF、Codex 套件）。

每个技能皆位于各自的文件夹中，并附有 SKILL.md，详细说明所需的参数、选用旗标与提示词示例。

生态系统与整合

AI 编程助手 – 这些技能设计为由 Claude Code、Cursor、GitHub Copilot 等调用，让开发者能写下如“@scenario-image generate a cyberpunk cityscape”的提示词，并让助手自动执行该技能。
Scenario 平台 – 所有大型 AI 模型（Stable Diffusion、Runway、Gemini、ElevenLabs 等）皆由 Scenario 托管；本仓库不包含模型权重。
Agent Skills 注册表 – 顶部的徽章链接至公开技能索引 (skills.sh)，每个技能皆可搜索并具有版本控制。
发布工作流程 – 变更合并至 main 后，release-please 会建立 GitHub 发布版本、更新 CHANGELOG.md，并发布至 Scenario 更新日志页面。

优势与限制

优势

全面覆盖 – 71 个技能涵盖整个创意流程（概念、资产生成、编辑、最终组装）。
模块化 – 用户仅需选择所需的技能，保持 AI 助手的提示词界面简洁。
即时更新 – 技能从仓库拉取最新定义；无需手动锁定版本。
企业就绪 – 可与 Scenario 的验证机制配合，并链接至团队账号以进行资产治理。

限制

依赖 Scenario MCP – 所有生成皆在云端进行；无法离线使用。
学习曲线 – 用户必须理解 Agent Skills 语法以及如何设置 skills CLI。
专家工具系列 – 选用的 DCC 集成需要本地安装大型软件（Blender、Unreal 等），且不包含在核心 MCP 流程中。

谁应该使用此工具？

游戏开发者 – 希望直接从代码生成 AI 美术、纹理与 3D 道具。
营销团队 – 需要快速制作符合品牌风格的视觉内容（产品照、广告变体、缩略图）。
内容创作者 – 寻求自动化视频、音乐视频与音频生成。
LLM 工具工程师 – 建立自定义代理程序，无需编写客制化 API 代码即可请求视觉/音频资产。

取得协助

文档 – API 文档 (https://docs.scenario.com)、MCP 文档 (https://mcp.scenario.com/docs) 以及各技能专属的 README。
社区 – 在 X 上关注 @scenario_gg，并浏览 https://skills.sh/scenario-labs/skills 的技能索引。
支持 – 登录 Scenario 应用程序并使用说明中心处理账号或 API 密钥问题。

总结

Scenario Agent Skills 是一套包含 71 个插件定义的函数库，让 AI 编程助手能与 Scenario 的云端资产生成平台沟通。使用 npx skills add 安装所需的子集，连接至您的 Scenario MCP 端点，然后提示您的 LLM 生成图像、视频、音频、3D 模型或完整的品牌套件——完全无需自行编写任何 API 代码。