WeShop Skills turns plain-language creative requests into production-ready image, video, product, portrait, layout, and spatial workflows powered by WeShop OpenAPI. Install the complete collection or pick only the Skills you need.

This repository contains 117 focused Atom Skills + 1 user-authoring Skill + 1 Router + 1 multi-step orchestration Skill. weshop-router decides whether to call one Atom directly or escalate to orchestration. Media execution uses a native WeShop harness tool or the official weshop CLI, never a package-owned fallback client.

🚀 Install with one prompt

Open Codex, Claude Code, or Cursor and paste this:

Install the latest stable `weshop-skill-package` from npm globally, run `weshop-skills install` for the agent you are running in, verify the managed Skill installation, and tell me whether I need to restart the agent. Do not ask me to paste or print my WeShop API key. Preserve all user-owned custom Skills.

The Agent should use the npm package and install the Skills into its own global Skill directory.

📦 Install manually

1. Download the latest stable package

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

Node.js 22 LTS and npm are required. The npm package is public and does not require a GitHub checkout. Its version always matches the corresponding stable GitHub Release.

2. Choose your agent

weshop-skills install --agent codex

The default destination is ~/.codex/skills.

weshop-skills install --agent claude

weshop-skills install --agent cursor

Restart the agent after the first installation so it can discover the new Skills.

For another Agent Skills-compatible runtime or a project-local setup, choose the destination explicitly:

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

Use weshop-skills list to inspect the package or install one Skill by name instead of the full collection.

3. Check for and install updates

Compare the version installed on your machine with the latest version published to npm:

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

You can also use npm's outdated report. It prints nothing when the global package is current:

npm outdated -g weshop-skill-package

Every stable GitHub Release publishes the same version to npm. Upgrade explicitly to the current latest version, then synchronize managed installations:

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

By default, managed installations are symlinks. Existing symlinked Skills follow the upgraded npm package immediately, while sync --all also installs newly added official Skills. Copy installations are refreshed only by sync. Restart the Agent after an update when it caches Skill metadata.

Package updates never scan, modify, upload, or delete user-owned custom Skills. Custom drafts remain under ~/.weshop-skill-package/custom-skills/, and user-installed custom Skills remain owned by the user.

To follow future releases without running a command, use GitHub Releases, subscribe through the repository's Watch → Custom → Releases option, or follow the release Atom feed.

By default, installation uses symlinks. Add --copy if you need an isolated copy:

weshop-skills install --agent codex --copy

4. Configure WeShop OpenAPI

Get a key from WeShop OpenAPI, then provide it only to the trusted local process that performs generation:

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

Never paste the key into chat, source files, frontend code, Git history, URLs, or command arguments.

💬 Use it

You do not need to memorize Skill names. $weshop-router sends a clear one-result request straight to its Atom; it escalates only compound work to the multi-step orchestration Skill.

Try prompts like:

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.

You can also invoke a Skill directly, for example $remove-background, $virtual-try-on, $create-logo, or $generate-video.

Create your own Skill

Ask for a reusable user-owned Skill in plain language. $create-custom-skill owns the complete local lifecycle: it creates or revises an isolated draft, checks structure and routing boundaries, and installs it locally after validation. The create, save, import, or upload request itself authorizes that local installation; only conflicts or higher-risk side effects stop for separate permission. Independent review begins only if you later ask to contribute the Skill to the official package.

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.

Drafts default to ~/.weshop-skill-package/custom-skills/ and are not visible to the Agent until intake and validation pass. They remain user-owned and are not overwritten by package updates. Deterministic scaffolding and mechanical review are also available:

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

✨ What you get

| Capability | Examples | | --- | --- | | 🛒 Product & e-commerce | Product scenes, packaging, white-background mockups, virtual try-on, model replacement | | 🎨 Image creation | Logos, characters, animals, banners, posters, thumbnails, infographics | | ✂️ Image editing | Remove objects or backgrounds, expand, recolor, retouch, clean, restore | | 🧑 Portrait & appearance | Headshots, ID photos, makeup, hair, pose, glasses, tattoos | | 🎬 Video | Image animation, talking video, intros, effects, editing, combining, upscaling | | 🏠 Space & design | Room restyling, landscape previews, floor plans, flowcharts, CAD | | 🧠 Multi-step orchestration | Parallel or ordered Skills, asset handoff, final QA for compound work | | 🛡️ Safe execution | Stable operation keys, duplicate-spend protection, polling, recovery records |

For compound work, orchestrate-multi-step-workflow discovers installed Skills from their descriptions, connects outputs to downstream inputs, selects verified WeShop models or Agents, and performs one focused acceptance check on the final result. It is not the Router: a clear single-Atom request never enters it.

Complete Skill inventory 🧩

The skills/ directory contains 134 creative Atom Skills, one platform-tooling Skill, one Router, and one multi-step orchestration Skill. Categories below are for browsing only and do not participate in hard-coded selection.

Client catalog contract

Published packages include catalog/skills.json, a versioned, client-neutral catalog generated from the installed SKILL.md files. It provides each Skill's cover reference, category and tags, description, usage summary and examples, plus up to three differentiated related Skills. Clients may use it for presentation, but must continue to discover and execute Skills from SKILL.md: the catalog is optional so individually copied Skills, older package versions, and third-party/custom directories remain compatible.

| Category | Skills | | --- | --- | | Router | weshop-router | | Multi-step orchestration | orchestrate-multi-step-workflow | | User authoring | create-custom-skill | | Commercial products and apparel | ai-product, change-pose, create-white-background-product-mockup, fashion-model-replacement, outfit-design, product-packaging, virtual-try-on | | Layout and marketing | 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, photo-collage, poster-design, product-detail-page, recolor-object, recreate-social-photo, social-knowledge-notes, technical-visual-explainer, translate-image-text | | Personal appearance | add-braces, add-tattoo, apply-makeup, change-bangs, eye-color-change, hair-color-change, hairstyle-change, make-selfie, shave-head | | Portrait production | id-photo-format, professional-headshot | | Image repair and utilities | clean-room, colorize-image, expand-image, remove-background, remove-glasses, remove-image-mark, remove-object, remove-photo-filter, retouch-blemish, smooth-wrinkles | | Characters, animals, and brands | casting, character-reference-sheet, create-animal, create-avatar, create-character, create-flag, create-logo, create-mascot-logo, create-npc, make-pet-portrait | | Narrative and comics | develop-story, narrative-video-storyboard, plan-comic-storyboard, plan-film-storyboard, render-comic-page, write-short-drama-series, write-short-video-hooks | | Spaces, diagrams, and CAD | create-cad, make-flowchart, preview-landscape, preview-paint, restyle-room, visualize-floor-plan | | Video | 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 | | Social and commemorative | make-birthday-video, make-holiday-card, make-mugshot-photo, make-wallet-photo, make-wedding-photo |

List them from your terminal:

weshop-skills list

Install only what you need:

weshop-skills install create-logo --agent codex
weshop-skills install weshop-router --agent codex
weshop-skills install orchestrate-multi-step-workflow --agent codex

⌨️ Official WeShop CLI

Execution uses a native WeShop tool exposed by the agent when available. Otherwise it uses only the official weshop CLI. Install and verify it separately:

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

Use its native Agent commands:

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

The label GPT Image 2 maps to the Agent ID gpt-image, not gpt-image-2. The official CLI does not support list-agents; use weshop --help or weshop info <agent>.

If weshop is absent, stop before upload or generation and install it; this repository intentionally contains no OpenAPI client or execution fallback. An authentication, validation, timeout, or ambiguous submission error is not a signal to change clients or retry the create call.

🔄 Inspect updates

Inspect one managed Skill at any time, or compare the local package version with npm:

weshop-skills status create-logo --agent codex
weshop-skills version
npm view weshop-skill-package version

status checks installed Skill content; it does not query npm. Use the two version commands above to determine whether a new package release exists.

🏗️ For maintainers

Start with CONTRIBUTING.md and the maintainer guide. The repository includes separate workflows for creating a Skill and adapting an external project to WeShop.

Useful commands:

| Command | Purpose | | --- | --- | | npm run build | Clean and compile the multi-step orchestration validation library | | npm run check | Run TypeScript checks | | npm test | Test routing, safety policy, installation, and updates | | npm run models:validate | Validate the model catalog | | npm run models:routing-validate | Validate model routes across all 117 creative Atom Skills | | npm run docs:validate | Validate this README and Skill inventory | | npm run maintainers:validate | Validate maintainer documentation | | npm run web:build | Build the generated visual Skill catalog | | npm run skills:intake -- ... | Start a provenance-safe external Skill intake | | npm run media:upload -- ... | Upload and verify a Skill cover, source image, or cover video in the reviewed Tencent COS prefix | | npm run skills:custom:init -- ... | Start an isolated user-owned custom Skill draft | | npm run skills:custom:check -- ... | Run mechanical local checks on a custom Skill | | npm run skills:auto-update -- ... | Install or inspect the Release-based background updater | | npm run api-key:check | Check local WeShop API key presence without printing it | | npm run package:check | Inspect the exact npm package contents before publishing |

🔒 Security

• WESHOP_API_KEY is read from the environment and sent only to https://openapi.weshop.ai.
• Every generation uses a durable operation key before submission.
• A missing or ambiguous execution receipt blocks automatic resubmission to avoid duplicate output and spend.
• Accepted runs are polled by execution ID; downstream download or publication failures do not trigger regeneration.

📄 License

Available under the MIT License.

Built with ❤️ by the WeShop AI team.