WAN3 Agent Skills

Portable image and video generation skills for agents that can run local commands. They call the WAN3 Developer API, use the caller's WAN3 account credits, poll asynchronous jobs, and download completed media.

This repository contains:

• skills/wan3-image-generation - image generation and editing
• skills/wan3-video-generation - text, image, reference, and video workflows
• integrations/deepseek-harness - optional DeepSeek Harness discovery adapter

Requirements

• Node.js 20 or newer
• A WAN3 account with credits
• A user-created WAN3 API key from https://wan3.net/settings/api-keys

The skills do not require or contain an upstream provider credential.

Install

Copy the two skill folders into the skill directory used by your agent. For Codex:

mkdir -p ~/.codex/skills
cp -R skills/wan3-image-generation ~/.codex/skills/
cp -R skills/wan3-video-generation ~/.codex/skills/

For Claude Code, copy them into ~/.claude/skills/. For DeepSeek Harness, copy them into the project .dsh/skills/ directory or the user DSH skill directory; the optional adapter has additional instructions in integrations/deepseek-harness/README.md.

Keep the API key in a local secret manager or environment variable:

export WAN3_API_KEY="wan3_live_your_key_here"

Do not commit the key, paste it into an issue, or place it in browser code.

Verify the connection

The clients discover the current model and input contract at runtime:

node skills/wan3-image-generation/scripts/wan3-client.mjs models
node skills/wan3-video-generation/scripts/wan3-client.mjs models

Each SKILL.md explains the upload, submission, polling, idempotency, and download workflow. Current public API documentation is at https://wan3.net/developers.

Credential and privacy boundaries

• Production calls are pinned to https://wan3.net/api/v1.
• WAN3_API_KEY is read only at runtime and is never bundled or printed.
• Preview testing requires a different WAN3_PREVIEW_API_KEY, an explicit HTTPS origin, and WAN3_ALLOW_NON_PRODUCTION_API=1. The Production key is rejected in Preview mode.
• Official clients send x-wan3-client with a versioned image or video Skill ID so WAN3 can attribute API usage to the Skill. This is source attribution, not an advertising tracker.
• Uploading local media necessarily sends the selected file bytes and upload metadata to WAN3. No other local files, environment variables, or shell history are collected by these clients.

See SECURITY.md before reporting a security issue.

License

MIT