weshopai/weshop-skill-package

适用于 Codex、Claude Code、Cursor 以及任何兼容 Agent Skills 运行时的创意 AI 技能。

WeShop Skills 可将自然语言的创意请求转化为由 WeShop OpenAPI 驱动的、可直接用于生产的图像、视频、产品、人像、布局和空间工作流。你可以安装完整合集，也可以只挑选你需要的技能。

本仓库包含 138 个专注创意技能 + 1 个用户创作技能。更高层级的选择逻辑位于受保护的 routing/guide.md 包资源中，维护的组合则位于 workflows/catalog.json。两者都不会作为技能安装或暴露。

包边界

- skills/ 包含 139 个可独立发现的面向用户技能和创作技能。
- routing/ 包含受保护的、面向宿主的选取指导。它不是技能、工具、执行器，也不是第二个 Agent 循环。
- workflows/ 包含维护的跨技能依赖定义及其执行边界。工作流不是技能。
- shared/ 包含由多个技能共享的、包自有的指导内容，例如模型选择。技能仅在当前任务需要该决策时链接到它。
- scripts/weshop-skills.mjs 负责安装和更新技能内容；它不是媒体生成 CLI。
- 原生宿主工具或单独版本化的官方 weshop CLI 负责执行。工具 schema、凭据、审批、回执、重试和产物交付不会在本包中重复实现。

这样可让常规技能发布独立于可执行 CLI 以及任何宿主应用的发布周期。

🚀 用一条提示安装

打开 Codex、Claude Code 或 Cursor，粘贴以下内容：

从 npm 全局安装最新的稳定版 weshop-skill-package，在你所运行的 agent 中执行 weshop-skills install，验证托管的 Skill 安装，并告诉我是否需要重启 agent。不要让我粘贴或打印我的 WeShop API key。保留所有用户拥有的自定义 Skills。

Agent 应使用 npm 包，并将 Skills 安装到其自身的全局 Skill 目录中。

📦 手动安装

1. 下载最新的稳定版包

npm install -g weshop-skill-package@latest
weshop-skills version

需要 Node.js 22 LTS 和 npm。该 npm 包是公开的，无需 GitHub checkout。其版本始终与对应的稳定版 GitHub Release 一致。

2. 选择你的 agent

Codex

weshop-skills install --agent codex

默认目标位置是 ~/.codex/skills。

Claude Code

weshop-skills install --agent claude

Cursor

weshop-skills install --agent cursor

首次安装后重启 agent，以便它能够发现新的 Skills。

对于其他兼容 Agent Skills 的运行时或项目本地设置，请显式选择目标位置：

weshop-skills install --all --target /absolute/path/to/skills

使用 weshop-skills list 查看包内容，或按名称安装单个 Skill，而不是安装整个集合。

3. 检查并安装更新

将你机器上安装的版本与发布到 npm 的最新版本进行比较：

weshop-skills version
npm view weshop-skill-package version

你也可以使用 npm 的过期报告。当全局包为最新版本时，它不会输出任何内容：

npm outdated -g weshop-skill-package

每个稳定的 GitHub Release 都会向 npm 发布相同的版本。显式升级到当前的 latest 版本，然后同步托管的安装：

npm install -g weshop-skill-package@latest
weshop-skills sync --all
weshop-skills status --all

默认情况下，托管的安装是符号链接。现有的符号链接 Skills 会立即跟随升级后的 npm 包，而 sync --all 还会安装新添加的官方 Skills。复制式安装仅通过 sync 刷新。当 Agent 缓存 Skill 元数据时，请在更新后重启 Agent。

包更新绝不会扫描、修改、上传或删除用户拥有的自定义 Skills。自定义草稿保留在 ~/.weshop-skill-package/custom-skills/ 下，用户安装的自定义 Skills 仍归用户所有。
若要在不运行命令的情况下跟进未来版本，请使用 GitHub Releases，通过仓库的 Watch → Custom → Releases 选项订阅，或关注 release Atom feed。

默认情况下，安装使用符号链接。如果你需要隔离的副本，请添加 --copy：

weshop-skills install --agent codex --copy

4. 配置 WeShop OpenAPI

从 WeShop OpenAPI 获取密钥，然后仅将其提供给执行生成的可信本地进程：

read -s WESHOP_API_KEY && export WESHOP_API_KEY
weshop-skills api-key check

切勿将密钥粘贴到聊天、源文件、前端代码、Git 历史、URL 或命令参数中。

💬 使用它

你不需要记住 Skill 名称。兼容宿主会公开一个按类别分组的注册表，仅在归属不明显时使用受保护的路由指南，并按需加载所选的 Skill。只有真正的跨 Skill 依赖或具有独立价值的交付物才会进入维护的工作流定义。

尝试这样的提示：

Turn this product photo into a clean white-background marketplace hero image. Keep the product shape, label, and colors unchanged.

Put this jacket on the model, preserve the garment logo and fit, then create a matching lifestyle campaign image.

Remove the person in the background, expand this photo to 16:9, and animate it into a five-second cinematic shot.

Create one minimal logo for NORTHLINE COFFEE: an original N plus mountain-path symbol in black and cream.

你也可以直接调用 Skill，例如 $remove-background、$virtual-try-on、$create-logo 或 $generate-video。

创建你自己的 Skill

用自然语言请求一个可复用的、用户拥有的 Skill。$create-custom-skill 负责完整的本地生命周期：它创建或修订一个隔离的草稿，检查结构和路由边界，并在验证通过后将其安装到本地。创建、保存、导入或上传请求本身即授权该本地安装；只有冲突或更高风险的副作用才会停下来等待单独许可。只有当你之后要求将该 Skill 贡献到官方包时，才会开始独立审查。

Save the workflow we just completed as my own reusable Skill. Keep it local, compare it with similar installed Skills, run intake and validation, then install it into my local Skill directory.

草稿默认位于 ~/.weshop-skill-package/custom-skills/，在通过接收和验证之前对 Agent 不可见。它们始终归用户所有，并且不会被包更新覆盖。还提供确定性的脚手架和机械审查：

weshop-skills custom init my-custom-skill
weshop-skills custom check ~/.weshop-skill-package/custom-skills/my-custom-skill

✨ 你将获得

| 能力 | 示例 |
| --- | --- |
| 🛒 产品与电商 | 产品场景、包装、白底样机图、虚拟试穿、模特替换 |
| 🎨 图像创作 | 标志、角色、动物、横幅、海报、缩略图、信息图 |
| ✂️ 图像编辑 | 移除物体或背景、扩展、重新着色、修饰、清理、修复 |
| 🧑 人像与外观 | 头像照、证件照、化妆、发型、姿势、眼镜、纹身 |
| 🎬 视频 | 图像动画、说话视频、片头、特效、编辑、合成、超分辨率 |
| 🏠 空间与设计 | 房间重新设计、景观预览、平面图、流程图、CAD |
| 🧠 多步骤编排 | 并行或有序 Skills、资产交接、复合工作的最终 QA |
| 🛡️ 安全执行 | 稳定操作键、重复消费保护、轮询、恢复记录 |

对于复合工作，Host 从 workflows/catalog.json 读取一个定义，将接受的输出连接到下游输入，并让每个选定的 Skill 负责其操作。Host Runtime 仍然负责工具、审批、认证、回执、恢复和发布。

路由指导

routing/guide.md 是受保护的包资源，不是 Skill 或计划编译器。当需要路由时，Agent 读取它一次并选择：

- 一个完整结果的 Skill；
- 一个维护的工作流，用于真实的跨 Skill 依赖或独立请求的交付物；或
- 一个改变路由的澄清。

其有界常见任务映射可加速频繁工作，而不会成为关键词分类器或封闭操作枚举。workflows/catalog.json 是维护组合的机器可读权威。运行时 Skill 可用性仍然是权威。

路由指南仅考虑结果、提供的输入角色、保留约束、请求的交付物、当前证据需求和改变路由的歧义。Host 策略、记忆、权限、执行状态、回执和恢复仍由 Agent Runtime 拥有。没有 Router Tool 往返或第二个 Agent 循环。

完整 Skill 清单 🧩

skills/ 目录包含 138 个创意 Skills 和一个平台工具 Skill——总共 139 个 Skills。路由和工作流资源有意放在此目录之外，因此普通的 Agent Skills 发现无法暴露或遮蔽它们。以下类别仅供浏览。

客户端目录契约
已发布的包中包含 catalog/skills.json，这是一个带版本、客户端中立的目录，由已安装的 SKILL.md 文件生成。其 139 个公开条目涵盖 138 个 Atom Skills 以及用户创作 Skill；两个仅限系统的路由 Skill 被有意从客户端目录中隐藏。它为每个公开 Skill 提供封面引用、分类与标签、描述、用法摘要与示例，以及最多三个差异化的相关 Skill。客户端可将其用于展示，但必须继续从 SKILL.md 中发现并执行 Skill：该目录是可选的，因此单独复制的 Skill、较旧的包版本以及第三方/自定义目录仍保持兼容。

| 分类 | Skills |
| --- | --- |
| 用户创作 | create-custom-skill |
| 商业产品与服饰 | ai-product、change-pose、create-white-background-product-mockup、fashion-model-replacement、outfit-design、product-packaging、virtual-try-on |
| 版式与营销 | ai-banner-design、add-speech-bubble、apply-photo-filter、article-handdrawn-illustrations、compose-lookbook、create-image-deck、create-social-carousel、image-combiner、legal-diagram-redraw、legal-evidence-timeline、make-infographic、make-silhouette、make-thumbnail、minimal-zine-poster、mono-color、photo-collage、poster-design、product-detail-page、recolor-object、recreate-social-photo、social-knowledge-notes、technical-visual-explainer、translate-image-text、urban-daylight-documentary-grade |
| 个人外貌 | add-braces、add-tattoo、apply-makeup、change-bangs、eye-color-change、hair-color-change、hairstyle-change、make-selfie、shave-head |
| 人像制作 | id-photo-format、professional-headshot |
| 图像修复与实用工具 | clean-room、colorize-image、expand-image、remove-background、remove-glasses、remove-image-mark、remove-object、remove-photo-filter、retouch-blemish、smooth-wrinkles |
| 角色、动物与品牌 | casting、character-reference-sheet、create-animal、create-avatar、create-character、create-flag、create-logo、create-mascot-logo、create-npc、make-pet-portrait |
| 叙事与漫画 | develop-story、narrative-video-storyboard、plan-comic-storyboard、plan-film-storyboard、render-comic-page、write-short-drama-series、write-short-video-hooks |
| 空间、图表与 CAD | create-cad、make-flowchart、preview-landscape、preview-paint、restyle-room、spatial-four-view、visualize-floor-plan |
| 视频 | 3d-animation-short-generator, add-video-effect, animate-image, backrooms-dreamcore, brand-promo-video-generator, brand-stream-mg, cinematic-video-prompt, character-toy-grid-motion, children-english-story-episode, co-op-game-intro-generator, combine-videos, correct-video-color, cross-model-video-prompt-adapter, data-driven-ad-creative-video, decorative-print-short, detail-page-skill-course, digital-product-promo-generator, dodge-game-video-generator, dot-matrix-brand-wordmark-motion, editorial-cutout-explainer, edit-social-video, film-reference-prompt-writer, fpv-tour-video-generator, generate-video, h3-prompt-expert, handdrawn-live-action-fusion, handdrawn-story-video, line-doodle-explainer, lip-product-commercial, live-sketch-motion, make-beat-synced-video, make-explainer-video, make-kinetic-typography, make-music-video, make-podcast-video, make-product-commercial, make-talking-video, make-video-intro, micro-expression-performance, minimalist-product-ad-generator, music-video-subtitle-generator, narrative-video-prompt, paper-collage-explainer-generator, papercraft-stop-motion-explainer, poster-motion, pov-short-film-generator, primitive-folk-cgi-restyle, product-launch-video, remove-video-mark, restyle-video, short-audiovisual-prompt, suspense-title-sequence-generator, testimonial-quote-video, transcript-broll-plan, upscale-video, video-model-advisor, video-prompt-failure-diagnosis |
| 社交与纪念 | make-birthday-video, make-holiday-card, make-mugshot-photo, make-wallet-photo, make-wedding-photo |

从终端列出它们：

weshop-skills list

只安装你需要的：

weshop-skills install create-logo --agent codex

⌨️ 官方 WeShop CLI

执行时使用 agent 在可用时暴露的原生 WeShop 工具。否则仅使用官方 weshop CLI。单独安装并验证它：

npm install -g weshop-cli
weshop --version
weshop --help

使用其原生 Agent 命令：

weshop gpt-image --help
weshop gpt-image --prompt "Create a clean geometric logo"

标签 GPT Image 2 映射到 Agent ID gpt-image，而不是 gpt-image-2。官方 CLI 不支持 list-agents；请使用 weshop --help 或 weshop info 。

如果 weshop 不存在，请在 upload 或 generation 之前停止并安装它；此仓库有意不包含 OpenAPI 客户端或执行回退。认证、验证、超时或提交不明确的错误不是更换客户端或重试 create 调用的信号。

🔄 检查更新

随时检查一个受管理的 Skill，或将本地包版本与 npm 进行比较：

weshop-skills status create-logo --agent codex
weshop-skills version
npm view weshop-skill-package version
status 检查已安装的 Skill 内容；它不会查询 npm。使用上面的两个版本命令来判断是否存在新的包发布。

🏗️ 面向维护者

请从 CONTRIBUTING.md 和维护者指南开始。该仓库包含用于创建 Skill 和将外部项目适配到 WeShop 的独立工作流。

实用命令：

| 命令 | 用途 |
| --- | --- |
| npm run build | 清理并编译兼容性验证库 |
| npm run check | 运行 TypeScript 检查 |
| npm test | 测试路由、安全策略、安装和更新 |
| npm run models:validate | 验证模型目录 |
| npm run models:routing-validate | 验证所有 138 个创意 Atom Skills 的模型路由 |
| npm run workflows:validate | 验证工作流所有者、依赖项和路由指南覆盖范围 |
| npm run docs:validate | 验证此 README 和 Skill 清单 |
| npm run maintainers:validate | 验证维护者文档 |
| npm run web:build | 构建生成的视觉 Skill 目录 |
| npm run skills:intake -- ... | 启动来源安全的 外部 Skill 引入 |
| npm run media:upload -- ... | 将 Skill 封面、源图像或封面视频上传并验证到选定的腾讯 COS 目标（--market cn|global|both；global 是兼容性默认值） |
| npm run skills:custom:init -- ... | 启动隔离的用户自有自定义 Skill 草稿 |
| npm run skills:custom:check -- ... | 对自定义 Skill 运行机械式本地检查 |
| npm run skills:auto-update -- ... | 安装或检查基于 Release 的后台更新程序 |
| npm run api-key:check | 检查本地 WeShop API 密钥是否存在，但不打印它 |
| npm run package:check | 在发布前检查确切的 npm 包内容 |

🔒 安全性

- WESHOP_API_KEY 从环境变量中读取，并且仅发送到 https://openapi.weshop.ai。
- 每次生成在提交前都会使用一个持久化操作键。
- 缺失或含糊的执行回执会阻止自动重新提交，以避免重复输出和花费。
- 已接受的运行会通过执行 ID 进行轮询；下游下载或发布失败不会触发重新生成。

📄 许可证

在 MIT License 下提供。

由 WeShop AI 团队用 ❤️ 构建。