weshop-skill-pakage

Creative AI Skills for Codex, Claude Code, Cursor, and any Agent Skills-compatible runtime.

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 89 focused Atom Skills + 1 user-authoring Skill + 1 adaptive Router. It is a content-first package: 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

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. Describe the result you want and the Router will select and combine the right Skills.

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 shows the install destination before requesting confirmation. Independent review begins only if you later ask to upload or 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, review it, and show me the install target before copying anything.

Drafts default to ~/.weshop-skill-package/custom-skills/ and are not visible to the Agent until reviewed and approved. 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

The Router discovers installed Skills from their descriptions, decomposes compound requests, connects outputs to downstream inputs, selects verified WeShop models or Agents, and performs one focused acceptance check on the final result.

Complete Skill inventory 🧩

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

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

⌨️ 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:

🔒 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.