$npx -y skills add talesofai/neta-skills --skill neta-creativeNeta API creative skill — generate images, videos, songs, and MVs, and deconstruct creative ideas from existing works. Use this skill when the user wants to create or edit images/videos/songs/MVs, or create based on character settings and existing works. Do not use it for feed br
| 1 | # Neta Creative Skill |
| 2 | |
| 3 | Used to interact with the Neta API for multimedia content creation, creation‑related character queries, and premium subscription flows where supported. |
| 4 | |
| 5 | ## Instructions |
| 6 | |
| 7 | 1. For tasks that **create or edit concrete assets** (images, videos, songs, MVs, background removal), follow this flow: |
| 8 | - Before creation, use **character queries** to fetch canonical character settings, then generate images/videos/songs based on them. |
| 9 | - To reverse‑engineer creative ideas from an existing work, call `read_collection` and combine the result with the guidance in the reference docs. |
| 10 | 2. If, during creation, you discover that the real need is more like “browse recommendations / casually explore / research topics”, combine this skill with `neta-community` or `neta-suggest` instead of overloading this skill. |
| 11 | 3. **Premium** (plans, orders, Stripe): use the commands below. Run **`get_current_premium_plan`** before and after checkout so the user can confirm tier (and end time if returned). Commerce needs the **global** Neta API—see the premium reference. If creation is blocked by **quota / credits (电量)** or **usage frequency (频率)**, say why in one beat; if an upgrade fits their goal, offer the path once (list plans → create order → pay)—**do not** repeat upgrade nudges in the same conversation unless the user asks. |
| 12 | |
| 13 | ## Commands |
| 14 | |
| 15 | ### Content creation |
| 16 | |
| 17 | **Generate image** |
| 18 | |
| 19 | ```bash |
| 20 | npx -y @talesofai/neta-skills@latest make_image --prompt "@character_name, /elementum_name, ref_img-uuid, description1, description2" --aspect "3:4" |
| 21 | ``` |
| 22 | |
| 23 | 📖 [Detailed guide](./references/image-generation.md) — prompt structure, aspect ratio choices, examples. |
| 24 | |
| 25 | **Generate video** |
| 26 | |
| 27 | ```bash |
| 28 | npx -y @talesofai/neta-skills@latest make_video --image_source "image URL" --prompt "action description" --model "model_s" |
| 29 | ``` |
| 30 | |
| 31 | 📖 [Detailed guide](./references/video-generation.md) — motion description principles, model selection. |
| 32 | |
| 33 | **Generate song** |
| 34 | |
| 35 | ```bash |
| 36 | npx -y @talesofai/neta-skills@latest make_song --prompt "style description" --lyrics "lyrics content" |
| 37 | ``` |
| 38 | |
| 39 | 📖 [Detailed guide](./references/song-creation.md) — style prompts, lyrics format. |
| 40 | |
| 41 | **Create MV** |
| 42 | |
| 43 | Combine an audio track and video to create a full MV. |
| 44 | |
| 45 | 📖 [Detailed guide](./references/song-mv.md) — end‑to‑end workflow. |
| 46 | |
| 47 | **Remove background** |
| 48 | |
| 49 | ```bash |
| 50 | npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid" |
| 51 | ``` |
| 52 | |
| 53 | **Upload local image or video** |
| 54 | |
| 55 | Registers a file from disk **or from an `http://` / `https://` URL** as a Neta artifact (after upload and moderation). Use the returned **`uuid`** or **`url`** in `make_image` (`ref_img-…`), `make_video` (`--image_source` URL), `remove_background`, or collection commands. |
| 56 | |
| 57 | ```bash |
| 58 | npx -y @talesofai/neta-skills@latest upload --file_path "/path/to/file.png" |
| 59 | # or: --file_path "https://example.com/asset.png" |
| 60 | ``` |
| 61 | |
| 62 | 📖 [Media upload](./references/media-upload.md) — supported types, size limits, and how outputs map to each downstream command. |
| 63 | |
| 64 | ### Character queries |
| 65 | |
| 66 | **Search characters** |
| 67 | |
| 68 | ```bash |
| 69 | npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "keywords" --parent_type "character" --sort_scheme "exact" |
| 70 | ``` |
| 71 | |
| 72 | 📖 [Detailed guide](./references/character-search.md) — search strategies and parameter choices. |
| 73 | |
| 74 | **Get character details** |
| 75 | |
| 76 | ```bash |
| 77 | npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "character_name" |
| 78 | ``` |
| 79 | |
| 80 | **Query by UUID** |
| 81 | |
| 82 | ```bash |
| 83 | npx -y @talesofai/neta-skills@latest request_character_or_elementum --uuid "uuid" |
| 84 | ``` |
| 85 | |
| 86 | ### Creative idea deconstruction |
| 87 | |
| 88 | **Derive creative ideas from a work** |
| 89 | |
| 90 | ```bash |
| 91 | npx -y @talesofai/neta-skills@latest read_collection --uuid "collection-uuid" |
| 92 | ``` |
| 93 | |
| 94 | 📖 [Detailed guide](./references/collection-remix.md) |
| 95 | |
| 96 | ### Premium subscription |
| 97 | |
| 98 | **Current plan (verify before / after upgrade)** |
| 99 | |
| 100 | ```bash |
| 101 | npx -y @talesofai/neta-skills@latest get_current_premium_plan |
| 102 | ``` |
| 103 | |
| 104 | Returns the signed-in user’s **current tier** (e.g. Basic, Starter, Pro, Master) and **subscription end** when applicable. Use it **before** starting checkout to record the baseline, and **again after** payment or renewal completes so the user can confirm the plan changed as expected. |
| 105 | |
| 106 | **List plans and SPU UUIDs** |
| 107 | |
| 108 | ```bash |
| 109 | npx -y @talesofai/neta-skills@latest list_premium_plans |
| 110 | ``` |
| 111 | |
| 112 | **Create an order** |
| 113 | |
| 114 | ```bash |
| 115 | npx -y @talesofai/neta-skills@latest create_premium_order --spu_uuid "spu-uuid" |
| 116 | ``` |
| 117 | |
| 118 | **Get one order** |
| 119 | |
| 120 | ```bash |
| 121 | npx -y @talesofai/neta-skills@latest get_premium_order --order_uuid "order-uuid" |
| 122 | ``` |
| 123 | |
| 124 | **List orders (paginated)** |
| 125 | |
| 126 | ```bash |
| 127 | npx -y @talesofai/neta-skills@latest list_pre |