@acedatacloud/skills 2026.712.2 → 2026.713.1

package/AGENTS.md

@@ -24,6 +24,7 @@ Skills are located in the `skills/` directory (also mirrored to `.agents/skills/
 - **hailuo-video** — Generate videos with Hailuo / MiniMax
 - **seedance-video** — Generate dance/motion videos with ByteDance Seedance
 - **wan-video** — Generate videos with Alibaba Wan
+- **maestro-video** — Produce complete videos from a brief with scripting, media, voiceover, editing, captions, and multilingual variants
 
 ### AI Chat & Tools
 - **ai-chat** — Unified LLM gateway — GPT, Claude, Gemini, Kimi, Grok (50+ models)

package/README.md

@@ -12,7 +12,7 @@
 
 Compatible with **30+ AI coding agents** via the [agentskills.io](https://agentskills.io/) open standard: Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, Cursor, Roo Code, Goose, and more.
 
-## Available Skills (30)
+## Available Skills
 
 ### AI Music & Audio
 
@@ -40,6 +40,7 @@ Compatible with **30+ AI coding agents** via the [agentskills.io](https://agents
 | [kling-video](skills/kling-video/) | Generate videos with Kuaishou Kling (motion control) |
 | [hailuo-video](skills/hailuo-video/) | Generate videos with Hailuo / MiniMax |
 | [seedance-video](skills/seedance-video/) | Generate dance/motion videos with ByteDance Seedance |
+| [maestro-video](skills/maestro-video/) | Produce complete videos from a brief with script, media, voiceover, captions, and editing |
 
 ### AI Chat & Tools
 
@@ -208,6 +209,7 @@ Skills provide **knowledge** (when to use, parameters, gotchas). MCP servers pro
 | veo-video | [mcp-veo](https://pypi.org/project/mcp-veo/) | `pip install mcp-veo` | `https://veo.mcp.acedata.cloud/mcp` |
 | seedream-image | [mcp-seedream](https://pypi.org/project/mcp-seedream/) | `pip install mcp-seedream` | `https://seedream.mcp.acedata.cloud/mcp` |
 | seedance-video | [mcp-seedance](https://pypi.org/project/mcp-seedance/) | `pip install mcp-seedance` | `https://seedance.mcp.acedata.cloud/mcp` |
+| maestro-video | [mcp-maestro](https://pypi.org/project/mcp-maestro/) | `pip install mcp-maestro` | `https://maestro.mcp.acedata.cloud/mcp` |
 | nano-banana-image | [mcp-nano-banana](https://pypi.org/project/mcp-nano-banana/) | `pip install mcp-nano-banana` | `https://nano-banana.mcp.acedata.cloud/mcp` |
 | short-url | [mcp-shorturl](https://pypi.org/project/mcp-shorturl/) | `pip install mcp-shorturl` | `https://short-url.mcp.acedata.cloud/mcp` |
 | wan-video | [mcp-wan](https://pypi.org/project/mcp-wan/) | `pip install mcp-wan` | `https://wan.mcp.acedata.cloud/mcp` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.712.2",
+  "version": "2026.713.1",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/_shared/mcp-servers.md

@@ -15,6 +15,7 @@ Each AceDataCloud service has a corresponding MCP server that provides tool-use
 | veo-video | `pip install mcp-veo` | `https://veo.mcp.acedata.cloud/mcp` |
 | seedream-image | `pip install mcp-seedream` | `https://seedream.mcp.acedata.cloud/mcp` |
 | seedance-video | `pip install mcp-seedance` | `https://seedance.mcp.acedata.cloud/mcp` |
+| maestro-video | `pip install mcp-maestro` | `https://maestro.mcp.acedata.cloud/mcp` |
 | nano-banana-image | `pip install mcp-nano-banana` | `https://nano-banana.mcp.acedata.cloud/mcp` |
 | short-url | `pip install mcp-shorturl` | `https://short-url.mcp.acedata.cloud/mcp` |
 | wan-video | `pip install mcp-wan` | `https://wan.mcp.acedata.cloud/mcp` |

package/skills/maestro-video/SKILL.md

@@ -0,0 +1,271 @@
+---
+name: maestro-video
+description: "Produce complete AI videos with Maestro via AceDataCloud API. Use when: Maestro, article-to-video, prompt-to-video, turn a brief or reference media into a finished captioned video, generate scripts/visuals/voiceover/music/editing in one workflow, create multilingual video variants, or remix/edit/extend a previous Maestro video. Covers task creation, progress polling, history, and final output retrieval."
+license: Apache-2.0
+metadata:
+  author: acedatacloud
+  version: "1.0"
+compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md). Optionally pair with mcp-maestro for tool-use.
+---
+
+# Maestro End-to-End Video Production
+
+Use Maestro when the user wants a **finished video**, not only a generated clip. A headless AI director turns one natural-language brief into a script, visual assets, voiceover, music, edit, captions, quality checks, and rendered video variants.
+
+> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
+
+## Choose Maestro When
+
+- The user wants an article, idea, product brief, or campaign turned into a complete video.
+- The workflow needs scripting, visuals, narration, captions, and editing handled together.
+- The user supplies product images, a logo, portrait, source footage, or reference audio.
+- One visual production must be rendered in multiple languages.
+- A completed Maestro video needs to be remixed, edited, or extended.
+
+Use a model-specific video API such as Seedance, Kling, or Veo when the user only needs a short generated shot and wants direct model controls. Maestro may use multiple media services internally and is optimized for the finished production.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.acedata.cloud/maestro/videos \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "prompt": "Create a 30-second beginner-friendly video explaining vector databases. End with one memorable takeaway.",
+    "aspect": "16:9",
+    "duration": 30,
+    "quality": "standard",
+    "scenario": "narrated",
+    "langs": ["en"]
+  }'
+```
+
+The response contains a `task_id`. Maestro is asynchronous, so query the task until it reaches `succeeded` or `failed`:
+
+```bash
+curl -X POST https://api.acedata.cloud/maestro/tasks \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"id": "<task_id>", "action": "retrieve"}'
+```
+
+Do not invent output URLs or report completion while the task is still running.
+
+## Core Workflow
+
+1. Translate the user's goal into a concrete production brief.
+2. Call `POST /maestro/videos` and preserve the returned `task_id` and `trace_id`.
+3. Poll `POST /maestro/tasks` at a reasonable interval.
+4. Continue through nonterminal states; stop only at `succeeded` or `failed`.
+5. On success, return every item in `response.data.variants`, including its language and `output_url`.
+6. If requested, iterate by creating a new task with `action`, `ref_task_id`, and a change-focused prompt.
+
+Polling and history queries are free; the video task is settled after production based on delivered output. Avoid submitting duplicate creation requests while an existing task is still running.
+
+## Creation Parameters
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `prompt` | string | required | Natural-language production brief: topic, audience, content, tone, and desired result |
+| `action` | string | `generate` | `generate`, `remix`, `edit`, or `extend` |
+| `ref_task_id` | string | - | Required for `remix`, `edit`, and `extend` |
+| `file_urls` | string[] | - | Public image, video, or audio references, up to the limits enforced by the API |
+| `langs` | string[] | `["zh-cn"]` | Output language codes; each creates a localized rendered variant |
+| `aspect` | string | `9:16` | `9:16`, `16:9`, or `1:1` |
+| `duration` | integer | `30` | Target duration from 1 to 600 seconds |
+| `quality` | string | `standard` | `draft`, `standard`, or `premium` |
+| `scenario` | string | `auto` | `auto`, `narrated`, `drama`, `avatar`, `motion`, or `slideshow` |
+| `style` | string | `auto` | Preset or freeform visual direction |
+| `voice` | string | `auto` | Cross-lingual voice preset or a 32-hex-character Fish reference ID |
+| `callback_url` | string | - | Optional webhook called on success or failure |
+
+### Quality
+
+- `draft`: fast rough cut for validating direction.
+- `standard`: balanced default for normal production.
+- `premium`: richer, more polished production with a higher cost and longer turnaround.
+
+### Scenarios
+
+- `auto`: let the director choose from the brief.
+- `narrated`: multi-scene explainer, documentary, brand, history, or product video with voiceover.
+- `drama`: acted short drama with characters and dialogue.
+- `avatar`: talking-head or digital-human video; normally provide a portrait in `file_urls`.
+- `motion`: kinetic typography, data, logo, or abstract motion graphics.
+- `slideshow`: presentation deck, pitch, or slide-led video.
+
+### Styles
+
+Named presets include `cinematic`, `glass`, `luxury`, `swiss`, `modern`, `editorial`, `warm`, `vibrant`, `neon`, `mono`, `pastel`, `bold`, `industrial`, `futuristic`, and `retro`. The API also accepts a freeform style hint.
+
+### Voices
+
+Available presets include:
+
+- Female: `warm-female`, `bright-female`, `anchor-female`, `clean-female`
+- Male: `calm-male`, `deep-male`, `documentary-male`, `energetic-male`, `storyteller-male`
+- Automatic: `auto`
+
+Voice controls timbre rather than language. The same preset speaks the language selected in `langs`.
+
+## Reference Media
+
+Pass public URLs in `file_urls`:
+
+```json
+{
+  "prompt": "Create a product launch video that clearly shows the camera body and logo. Use the supplied audio as the tone reference.",
+  "file_urls": [
+    "https://example.com/product.jpg",
+    "https://example.com/logo.png",
+    "https://example.com/reference.mp3"
+  ],
+  "scenario": "narrated",
+  "style": "editorial",
+  "aspect": "16:9"
+}
+```
+
+Reference URLs must be reachable by the service. Do not pass local file paths. Upload local assets first, then use their public URLs.
+
+## Multilingual Variants
+
+Use one request to reuse the production across languages:
+
+```json
+{
+  "prompt": "A concise product walkthrough for first-time customers",
+  "langs": ["en", "de", "ja"],
+  "voice": "warm-female",
+  "duration": 45
+}
+```
+
+The first language is primary. A successful task normally returns one item per delivered language in `response.data.variants`. Do not assume every requested language succeeded; inspect the actual variants.
+
+## Iterate on a Previous Video
+
+All iteration actions require `ref_task_id`.
+
+### Remix
+
+Use `remix` for a new creative interpretation that keeps the previous task as context:
+
+```json
+{
+  "action": "remix",
+  "ref_task_id": "previous-task-id",
+  "prompt": "Rework this as a faster social cut with a stronger opening hook and neon styling.",
+  "aspect": "9:16"
+}
+```
+
+### Edit
+
+Use `edit` for targeted revisions:
+
+```json
+{
+  "action": "edit",
+  "ref_task_id": "previous-task-id",
+  "prompt": "Keep the structure and visuals. Replace the final call to action and use a calmer narrator."
+}
+```
+
+### Extend
+
+Use `extend` to continue or lengthen the production:
+
+```json
+{
+  "action": "extend",
+  "ref_task_id": "previous-task-id",
+  "prompt": "Add a 15-second customer example before the conclusion.",
+  "duration": 60
+}
+```
+
+Iteration creates a new task. Continue polling the new `task_id`; do not overwrite or confuse it with the source task.
+
+## Task Response
+
+A task response exposes top-level progress for user feedback:
+
+```json
+{
+  "id": "task-id",
+  "status": "producing",
+  "progress": {
+    "percent": 52,
+    "stage": "visuals",
+    "message": "Generating scene assets",
+    "activity": "Creating scene 4"
+  },
+  "response": null
+}
+```
+
+On success, inspect the delivered variants:
+
+```json
+{
+  "status": "succeeded",
+  "response": {
+    "success": true,
+    "data": {
+      "variants": [
+        {
+          "lang": "en",
+          "output_url": "https://cdn.example/video.mp4",
+          "captions_url": "https://cdn.example/captions.vtt",
+          "cover_url": "https://cdn.example/cover.jpg",
+          "duration": 31.2,
+          "qc_score": 0.96
+        }
+      ]
+    }
+  }
+}
+```
+
+Treat the fields above as a shape guide. Return fields that are actually present; never fabricate missing captions, covers, durations, or QC scores.
+
+## List Recent Tasks
+
+The live task endpoint also supports account history:
+
+```bash
+curl -X POST https://api.acedata.cloud/maestro/tasks \
+  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "retrieve_batch", "limit": 20}'
+```
+
+Optional Unix timestamp filters are `created_at_min` and `created_at_max`. The authenticated identity determines which tasks are returned; do not supply or trust a body-level user ID.
+
+## Prompting Guidance
+
+A useful brief answers:
+
+- What is the subject and desired outcome?
+- Who is the audience?
+- What facts, products, people, or scenes must appear?
+- What should the viewer feel or do afterward?
+- Which platform determines aspect ratio and pacing?
+- Are there exact brand, compliance, or wording constraints?
+
+Prefer a concrete production brief over a list of low-level model instructions. Maestro is responsible for choosing and orchestrating media tools.
+
+## Gotchas
+
+- This API is asynchronous. Always preserve and poll the returned `task_id`.
+- Terminal states are `succeeded` and `failed`; other status names may evolve as the production pipeline changes.
+- `remix`, `edit`, and `extend` fail without `ref_task_id`.
+- `file_urls` must be public URLs, not local paths.
+- `avatar` usually needs a usable portrait reference.
+- Requested duration is a target; report the actual delivered duration from the result.
+- Multilingual requests may return fewer variants than requested if one output fails.
+- Do not resubmit the same brief merely because a long-running poll has not finished.
+- Do not expose the API token in logs, output, source files, or examples.
+
+> **MCP:** `pip install mcp-maestro` | Hosted: `https://maestro.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)

package/skills/reddit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: reddit
-description: Submit posts (link or text) to subreddits and read your Reddit identity / content via the Reddit API. Use when the user mentions Reddit, posting to a subreddit, submitting a link or self-post, or checking their Reddit profile / submissions.
+description: Submit posts (link or text) to subreddits and read your Reddit identity / submissions using either official OAuth or your own Reddit login cookies. Use when the user mentions Reddit, posting to a subreddit, submitting a link or self-post, or checking their Reddit profile / submissions.
 when_to_use: |
   Trigger when the user wants to submit a post to a subreddit (link or
   self/text post), or read their own Reddit identity and submissions.
@@ -8,75 +8,88 @@ when_to_use: |
   / karma requirements — confirm the target subreddit, title and body
   before submitting.
 connections: [reddit]
-allowed_tools: [Bash]
+allowed_tools: [Bash, publish_artifact]
 license: Apache-2.0
 metadata:
   author: acedatacloud
-  version: "1.0"
+  version: "2.0"
 ---
 
-Call the **Reddit API** (OAuth endpoints) with `curl + jq`. The user's bearer
-token is in `$REDDIT_TOKEN`. **Every call MUST send a `User-Agent` header** or
-Reddit returns `429`. Use the OAuth host `https://oauth.reddit.com`.
+# Reddit — OAuth or login-cookie access
 
-```bash
-UA="web:cloud.acedata.connectors:v1.0 (by /u/acedatacloud)"
-```
+The connector injects exactly one of these credentials:
 
-Errors are JSON; a submit returns `{"json":{"errors":[...], "data":{...}}}` —
-if `errors` is non-empty, show them verbatim. `401` → token expired, re-connect.
+- `REDDIT_COOKIES`: JSON cookie array captured by the ACE browser extension.
+  It includes `reddit_session` and grants full account access. **Secret — never
+  echo, print, log or return it.**
+- `REDDIT_TOKEN`: official OAuth bearer token (`identity read submit`).
 
-**Always start by confirming identity:**
+The helper automatically prefers Cookie when present and otherwise uses OAuth.
+It sends Reddit's required descriptive User-Agent and never forwards cookies
+outside `reddit.com`.
 
-```bash
-curl -sS -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
-  "https://oauth.reddit.com/api/v1/me" | jq '{name, total_karma, link_karma}'
-```
+## Script resolution
 
-## Submit a post
-
-**Confirm the subreddit + title + body with the user first.** `sr` is the
-subreddit name WITHOUT the `r/` prefix.
-
-```bash
-# Self (text) post: kind=self + text. Link post: kind=link + url.
-curl -sS -X POST "https://oauth.reddit.com/api/submit" \
-  -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
-  --data-urlencode "sr=test" \
-  --data-urlencode "kind=self" \
-  --data-urlencode "title=My title" \
-  --data-urlencode "text=My self-post body in markdown" \
-  --data-urlencode "api_type=json" \
-  | jq '.json | {errors, url: .data.url, id: .data.id}'
+Bash calls do not share shell variables. Resolve the helper inside **every**
+fenced Bash invocation before using it:
+
+```sh
+R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
+[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
+python3 "$R" whoami
 ```
 
-For a link post:
+If authentication fails, ask the user to reconnect at
+<https://auth.acedata.cloud/user/connections>. Do not loop-retry a blocked or
+expired session.
+
+## Read
 
-```bash
-curl -sS -X POST "https://oauth.reddit.com/api/submit" \
-  -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
-  --data-urlencode "sr=test" --data-urlencode "kind=link" \
-  --data-urlencode "title=My title" --data-urlencode "url=https://example.com" \
-  --data-urlencode "api_type=json" | jq '.json'
+```sh
+R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
+[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
+python3 "$R" whoami
+python3 "$R" submissions --limit 10
 ```
 
-## Read my submissions
+## Submit a post — GATED
 
-```bash
-curl -sS -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
-  "https://oauth.reddit.com/user/USERNAME/submitted?limit=10" \
-  | jq '.data.children[] | .data | {title, subreddit, ups, num_comments, permalink}'
-```
+Posting is public. **Always show the subreddit, final title and final body/URL,
+then obtain explicit confirmation.** Without a trailing `--confirm`, both write
+commands are dry-runs and make no network request.
+
+```sh
+R="${SKILL_DIR:-}/scripts/reddit.py"; [ -f "$R" ] || R=$(find /tmp -maxdepth 8 -path '*/skills/*/reddit/scripts/reddit.py' -print -quit 2>/dev/null)
+[ -f "$R" ] || { echo "reddit script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
 
-## Gotchas
+# Text post: use a file for long Markdown.
+python3 "$R" submit-text --subreddit test --title "My title" --text-file post.md
+python3 "$R" submit-text --subreddit test --title "My title" --text-file post.md --confirm
+
+# Link post.
+python3 "$R" submit-link --subreddit test --title "My title" --url "https://example.com"
+python3 "$R" submit-link --subreddit test --title "My title" --url "https://example.com" --confirm
+```
 
-- **User-Agent is mandatory** on every request — omitting it → `429`.
-- Many subreddits gate posting on **account age / karma / flair**; a submit can
-  return `errors` like `[["SUBREDDIT_NOTALLOWED", ...]]` — surface it and try
-  `r/test` to validate the flow.
-- Respect rate limits: read the `X-Ratelimit-Remaining` response header; space
-  out bulk submits.
-- Use `r/test` as a safe target when validating that the connection works.
+`--confirm` is honored only when it is the final argument. A title or body that
+contains the text `--confirm` can never trigger a write.
+
+## Safety and failure handling
+
+- Never print `REDDIT_COOKIES`, `REDDIT_TOKEN`, `reddit_session` or the modhash.
+- Do not vote, send private messages, evade bans, automate engagement, or
+  cross-post identical content. This skill intentionally exposes none of those
+  operations.
+- Follow each subreddit's rules. Account age, karma and flair requirements can
+  reject a post; report the rejection without exposing Reddit's raw authenticated
+  response, which may contain reflected credential material.
+- Do not retry a write automatically. A timeout may occur after Reddit accepted
+  it, and replaying could create a duplicate.
+- Respect rate limits and never bulk-submit. Use `r/test` only for a deliberate
+  end-to-end validation.
+- Cookie mode drives Reddit's first-party web JSON endpoints and may drift when
+  Reddit changes its site. Report unexpected HTML or route errors as upstream
+  drift instead of guessing another private endpoint.
 
 
 ## Record the output