Agent skill · creative production · bighardperson
zenstudio
ZenStudio 官方 AI 内容创作 CLI 工具 (zencli)。支持 AI 生图、AI 生视频、项目管理、资产库、媒资管理、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, manage projects, upload files, download assets, manage
Why this skill is useful
Adds a comprehensive CLI tool with executable commands for image and video generation, project management, and asset handling that the AI cannot generate on its own.
What it needs
Requires zenstudio-cli installed locally. Requires zenstudio account access. About 3k tokens when loaded. Last updated 2026-04-26. 34 stars on the source repository.
What this skill does
ZenStudio CLI (zencli) AI 内容创作全流程命令行工具，封装 ZenStudio 平台 19+ 核心能力。 安装 & 配置 API Key 申请：Claw 配置 命令速查 输出格式: -o json(默认, Agent 推荐) -o table(人类阅读) -o text(管道/脚本) zencli config set outputformat <fmt> 关键工作流：上传文件 概念：媒资库(asset) = 项目级文件池；资产库(material) = 树形目录(人物/道具/场景/网盘文件夹)。资产库的素材只能从媒资库挂载。 步骤 1→2 强制绑定，上传后必须入媒资库。视频/音频为私有读，只有入库后的 URL 才带签名。 步骤 3 由 Agent 判断："上传文件" → 两步 "上传到角色/道具/场景/文件夹" → 三步 "媒资素材添加到资产库" → 仅步骤 3 ⚠️ 重要规则 1. 前端链接必须用 zencli url build 生成，严禁自行拼接 URL 2. 模型 ID 必须动态获取：image-models / video-models，严禁猜测或硬编码 3. canvas ≠ project：画布用 canvas，短番项目用 project，不要混用 4. build-draft 实时生效：写入后正在查看画布的用户会立即看到变更，无需刷新页面 5. build-draft 默认增量合并：只需传变更的节点（新增/修改），已有节点自动保留。删除用 -d，全量覆盖用 --mode overwrite 6. build-draft 支持多人协同：CLI 写入画布时不会覆盖其他用户的并发编辑，可安全地与浏览器用户同时操作同一画布 7. build-draft 节点数据校验： type 必须是 image/video/audio/imageGenerator/videoGenerator/artboard/text/freehand 之一 image/video/audio 节点必须包含 data.asset.id（非空字符串），否则被拒绝 text 节点必须包含 data.text.content（文本内容，最大2000字符），可选 fontSize/fontWeight/textAlign/color freehand 节点必须包含 data.freehand.points（笔触坐标数组）和 data.freehand.initialSize（{width,height}），可选 color/size audio 节点默认尺寸 260×80；artboard 节点缺少尺寸时默认 600×800 服务端会自动修正常见问题（如空 style、缺少 measured、text/freehand 默认属性），但关键必填字段缺失无法修正 8. 素材命名最佳实践： 画布内生成：使用 --name 传入"画布名称素材特征"作为名字（如"产品设计画布蓝色运动鞋"），通过 canvas list 获取画布名称 非画布生成：使用 --name 传入自定义名称，从 prompt 中提取核心关键词 9. 不确定参数时用 --help 或 tools describe 自行探索 环境变量 ZENSTUDIOAPIKEY — API Key (Bearer Token) ZENSTUDIOENDPOINT — API 端点 (默认 https://ai.tvi.v.qq.com/zenstudio/api/mcp) ZENCLICONFIGDIR — 配置文件目录 (默认 ~/.zencli，非持久化容器建议指向持久卷) ZENCLINOUPDATECHECK=1 — 禁用自动版本检查 (CI/CD 推荐) 工具说明 本技能使用以下工具： Read: 读取项目文件和配置
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/ZenStudio