@acedatacloud/skills 2026.926.0 → 2026.930.0

package/AGENTS.md

@@ -1,52 +1,19 @@
 # AceDataCloud Agent Skills
 
-This repository contains Agent Skills for [AceDataCloud](https://platform.acedata.cloud) AI services.
-
-## Available Skills
-
-Skills are located in the `skills/` directory (also mirrored to `.agents/skills/` and `.github/skills/`).
-
-### AI Music & Audio
-- **suno-music** — Generate AI music, lyrics, covers, and vocal extraction with Suno
-- **producer-music** — Generate music, covers, extend tracks, swap vocals with Producer
-- **fish-audio** — Text-to-speech and voice synthesis with Fish Audio
-
-### AI Image Generation
-- **flux-image** — Generate and edit images with Flux (Black Forest Labs)
-- **seedream-image** — Generate and edit images with ByteDance Seedream
-- **nano-banana-image** — Generate and edit images with Google Gemini (NanoBanana)
-
-### AI Video Generation
-- **luma-video** — Generate videos with Luma Dream Machine
-- **sora-video** — Generate videos with OpenAI Sora
-- **veo-video** — Generate videos with Google Veo (native audio)
-- **kling-video** — Generate videos with Kuaishou Kling (motion control)
-- **hailuo-video** — Generate videos with Hailuo / MiniMax
-- **happyhorse-video** — Generate and edit videos with Happy Horse
-- **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)
-- **google-search** — Search the web, images, news, maps, places, and videos via Google
-- **tgstat** — Discover and analyze public Telegram channels/groups (BYOC username; no login)
-- **face-transform** — Face analysis, beautification, age/gender transform, swap, cartoon
-- **short-url** — Create and manage short URLs
-- **onepage-pdf** — Convert an HTML page into one tall single-page PDF (local; no API token; needs Python + pymupdf + Chrome/Edge)
-- **apple-notes** — Manage Apple Notes on macOS: create, search, read, export, organize notes (macOS-only; local; no API token; drives Notes.app via AppleScript)
-- **acedatacloud** — Manage your AceDataCloud account — balance, usage/spend, API keys, services, orders, announcements
-
-## Authentication
-
-All skills require an API token:
-
-```bash
-export ACEDATACLOUD_API_TOKEN="your-token-here"
-```
-
-Get your token at [platform.acedata.cloud](https://platform.acedata.cloud).
-
-## Paired MCP Servers
-
-Each skill has a corresponding MCP server for tool-use capabilities. See the main [README](README.md) for the full mapping.
+The canonical skill files are `skills/<name>/SKILL.md`. Use `README.md`
+or the `skills/` directory to find the current catalog; do not maintain a
+second skill list here. `.agents/skills/` and `.github/skills/` are
+symlinks to `skills/`, so edit the canonical path.
+
+- Keep each skill's description short and specific to when that skill
+  should load. Put task procedures and examples in its body or relevant
+  supporting files.
+- Reuse `skills/_shared/` references for common AceDataCloud API
+  authentication, async tasks, and MCP guidance.
+- Skills that call AceDataCloud APIs need an AceDataCloud Bearer token.
+  Local skills such as `onepage-pdf` and `apple-notes` do not. Follow
+  the selected skill's authentication instructions; never commit or
+  print tokens.
+- When adding or changing a skill, update its own instructions and any
+  catalog entry that describes it, then run the applicable checks from
+  `.github/workflows/validate.yml`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.926.0",
+  "version": "2026.930.0",
   "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/ai-chat/SKILL.md

@@ -56,7 +56,7 @@ models include:
 
 | Family | Current examples |
 |--------|------------------|
-| OpenAI / reasoning | `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.6-sol`, `gpt-5.5`, `gpt-5.5-pro`, `gpt-5.4`, `gpt-5.4-pro`, `gpt-5.2`, `gpt-5.1`, `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-4o`, `gpt-4o-mini`, `o1`, `o3`, `o4-mini` |
+| OpenAI / reasoning | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-sol`, `gpt-6-luna`, `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.6-sol`, `gpt-5.5`, `gpt-5.5-pro`, `gpt-5.4`, `gpt-5.4-pro`, `gpt-5.2`, `gpt-5.1`, `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-4o`, `gpt-4o-mini`, `o1`, `o3`, `o4-mini` |
 | OpenAI free-tier chat-completions | `gpt-5.5:free`, `gpt-5:free`, `gpt-4.1:free`, `gpt-4o:free`, `gpt-4o-mini:free`, `gpt-oss:free` |
 | Claude | `claude-opus-5-5` (Messages only), `claude-fable-5-1`, `claude-fable-5`, `claude-opus-5`, `claude-sonnet-5`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6`, `claude-opus-4-5-20251101`, `claude-sonnet-4-6`, `claude-sonnet-4-5-20250929`, `claude-sonnet-4-20250514`, `claude-haiku-4-5-20251001`, `claude-3-7-sonnet-20250219` |
 | Gemini | `gemini-3.8-flash`, `gemini-3.6-flash`, `gemini-3.5-flash`, `gemini-3.1-pro`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3-pro-preview`, `gemini-2.5-flash-lite`, `gemini-2.0-flash-lite` |
@@ -65,6 +65,8 @@ models include:
 | Kimi | `kimi-k3`, `kimi-k2.6`, `kimi-k2.5`, `kimi-k2-thinking-turbo`, `kimi-k2-thinking` |
 | GLM | `glm-5.2`, `glm-5.1`, `glm-5`, `glm-5-turbo`, `glm-4.7`, `glm-4.6`, `glm-4.5`, `glm-4.5v`, `glm-3-turbo` |
 
+`gpt-6.1-sol` supports `low`, `medium`, `high`, `xhigh`, and `max` reasoning effort; do not send `none` or `minimal`. During its first week, access requires verified ACE T1+ holdings or an access grant. Check the platform access response for the opening time.
+
 `claude-opus-5-5` is available only through the dedicated Claude Messages API; do not send it to `/openai/chat/completions` or `/aichat2/conversations`.
 
 `/aichat2/conversations` also accepts `model_group` values

package/skills/ai-chat/references/platform.generated.json

@@ -425,6 +425,7 @@
     "gpt-6-astra",
     "gpt-6-luna",
     "gpt-6-sol",
+    "gpt-6.1-sol",
     "gpt-image-1",
     "gpt-oss:free",
     "gpt-realtime",
@@ -460,6 +461,6 @@
   ],
   "source": {
     "repository": "AceDataCloud/PlatformBackend",
-    "sha": "92a3426774282880f59b72c83c7e368ddadea99c"
+    "sha": "9ceee14efb863ca3d0889edccc45e6b014ece681"
   }
 }

package/skills/ai-chat/references/platform.generated.md

@@ -1,7 +1,7 @@
 <!-- Generated from PlatformBackend. Do not edit manually. -->
 # Platform contract
 
-Source: `AceDataCloud/PlatformBackend@92a3426774282880f59b72c83c7e368ddadea99c`
+Source: `AceDataCloud/PlatformBackend@9ceee14efb863ca3d0889edccc45e6b014ece681`
 
 ## Services
 
@@ -117,6 +117,7 @@ Source: `AceDataCloud/PlatformBackend@92a3426774282880f59b72c83c7e368ddadea99c`
 - `gpt-6-astra`
 - `gpt-6-luna`
 - `gpt-6-sol`
+- `gpt-6.1-sol`
 - `gpt-image-1`
 - `gpt-oss:free`
 - `gpt-realtime`

package/skills/personal-wechat/scripts/personal_wechat.py

@@ -286,7 +286,17 @@ def main() -> None:
     args = build_parser().parse_args()
 
     if args.cmd == "status":
-        _json(request("GET", "/api/status"))
+        status = request("GET", "/api/status")
+        logged_in = status.get("logged_in") is True
+        ready = status.get("status") == "ready" or status.get("ready") is True
+        if not logged_in or not ready:
+            status["scheduled_outcome"] = {
+                "version": 1,
+                "status": "skipped",
+                "code": "WECHAT_NOT_LOGGED_IN",
+                "side_effect_performed": False,
+            }
+        _json(status)
     elif args.cmd == "account":
         _json(request("GET", "/api/account"))
     elif args.cmd == "contacts":

package/skills/personal-wechat/tests/test_personal_wechat.py

@@ -198,3 +198,14 @@ def test_unattended_confirm_allows_a_preauthorized_skill(monkeypatch) -> None:
     calls, _ = run(["send", "Alice", "hi", "--unattended-confirm"], task_result={"sent": True})
 
     assert calls[0]["path"] == "/api/messages/send"
+
+
+def test_status_reports_not_logged_in_as_structured_skip() -> None:
+    _, stdout = run(["status"], responses={"/api/status": {"status": "ready", "logged_in": False}})
+
+    assert stdout[0]["scheduled_outcome"] == {
+        "version": 1,
+        "status": "skipped",
+        "code": "WECHAT_NOT_LOGGED_IN",
+        "side_effect_performed": False,
+    }

package/skills/x/scripts/x.py

@@ -300,10 +300,21 @@ async def cmd_whoami(client, args):
     if expected:
         expected_screen_name = normalize_screen_name(expected)
         if authenticated_screen_name.casefold() != expected_screen_name.casefold():
-            die(
-                f"connected X account is @{authenticated_screen_name}, not @{expected_screen_name}; "
-                "stopped without performing any write"
+            out(
+                {
+                    "error": (
+                        f"connected X account is @{authenticated_screen_name}, not @{expected_screen_name}; "
+                        "stopped without performing any write"
+                    ),
+                    "scheduled_outcome": {
+                        "version": 1,
+                        "status": "skipped",
+                        "code": "ACCOUNT_MISMATCH_SAFE_STOP",
+                        "side_effect_performed": False,
+                    },
+                }
             )
+            raise SystemExit(1)
     u, client = await retry_flaky_not_found(
         client,
         lambda c: c.get_user_by_screen_name(authenticated_screen_name),

package/skills/youtube/SKILL.md

@@ -64,20 +64,14 @@ YouTube has no "list my videos" call directly — read the channel's
 **uploads playlist**, then page its items.
 
 ```bash
-# 1. Get the uploads playlist id (UU... ) — same as channels call above.
-UPLOADS=$(curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-  "https://www.googleapis.com/youtube/v3/channels?part=contentDetails&mine=true" \
-  | jq -r '.items[0].contentDetails.relatedPlaylists.uploads')
-
-# 2. List recent uploads (50/page; follow .nextPageToken for more).
-curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-  -G "https://www.googleapis.com/youtube/v3/playlistItems" \
-  --data-urlencode "part=snippet,contentDetails" \
-  --data-urlencode "playlistId=$UPLOADS" \
-  --data-urlencode "maxResults=50" \
-  | jq '.items[] | {videoId: .contentDetails.videoId, title: .snippet.title, published: .snippet.publishedAt}'
+python3 skills/youtube/scripts/list_uploads.py --max-pages 20
 ```
 
+The helper follows every `nextPageToken` until the upload history is complete
+(or the explicit safety limit is reached). Its compact JSON keeps `videoId`,
+`title`, and `published` for each item, plus `complete`, `pages_fetched`, and
+`next_page_token`. Do not claim a video is absent when `complete` is false.
+
 Paginate by passing `--data-urlencode "pageToken=$PAGE_TOKEN"` with the
 `.nextPageToken` from the previous response.
 
@@ -175,7 +169,20 @@ RESULT=$(curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
   -X PUT --upload-file "$FILE" "$UPLOAD_URL")
 echo "$RESULT" | jq -e .id >/dev/null 2>&1 \
   || { echo "upload failed: $(echo "$RESULT" | jq -r '.error.message' 2>/dev/null || echo "$RESULT")"; exit 1; }
-echo "$RESULT" | jq '{id: .id, url: ("https://www.youtube.com/watch?v=" + .id), privacy: .status.privacyStatus}'
+VIDEO_ID=$(echo "$RESULT" | jq -r '.id')
+VERIFY=$(curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
+  -G "https://www.googleapis.com/youtube/v3/videos" \
+  --data-urlencode "part=snippet,status,processingDetails" \
+  --data-urlencode "id=$VIDEO_ID")
+echo "$VERIFY" | jq -e '.items[0].id == "'"$VIDEO_ID"'"' >/dev/null \
+  || { echo "upload readback failed for $VIDEO_ID"; exit 1; }
+echo "$VERIFY" | jq '.items[0] | {
+  video_id: .id,
+  canonical_url: ("https://www.youtube.com/watch?v=" + .id),
+  privacy: .status.privacyStatus,
+  upload_status: .status.uploadStatus,
+  processing_status: .processingDetails.processingStatus
+}'
 ```
 
 Delete a downloaded temp file only **after** you've confirmed an id came back

package/skills/youtube/scripts/list_uploads.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""List uploaded YouTube videos while preserving pagination evidence."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from typing import Any
+from urllib import error, parse, request
+
+API_ROOT = "https://www.googleapis.com/youtube/v3"
+
+
+def api_get(path: str, token: str, params: dict[str, str]) -> dict[str, Any]:
+    url = f"{API_ROOT}/{path}?{parse.urlencode(params)}"
+    req = request.Request(url, headers={"Authorization": f"Bearer {token}"})
+    try:
+        with request.urlopen(req, timeout=30) as response:
+            return json.load(response)
+    except error.HTTPError as exc:
+        body = exc.read().decode("utf-8", errors="replace")
+        raise RuntimeError(f"YouTube API HTTP {exc.code}: {body}") from exc
+
+
+def list_uploads(token: str, *, max_pages: int = 20) -> dict[str, Any]:
+    channel = api_get("channels", token, {"part": "contentDetails", "mine": "true"})
+    items = channel.get("items") or []
+    if not items:
+        raise RuntimeError("YouTube channel not found for the connected account")
+    uploads = items[0]["contentDetails"]["relatedPlaylists"]["uploads"]
+
+    videos: list[dict[str, Any]] = []
+    page_token = ""
+    pages = 0
+    while pages < max_pages:
+        params = {
+            "part": "snippet,contentDetails",
+            "playlistId": uploads,
+            "maxResults": "50",
+        }
+        if page_token:
+            params["pageToken"] = page_token
+        payload = api_get("playlistItems", token, params)
+        pages += 1
+        for item in payload.get("items") or []:
+            videos.append(
+                {
+                    "videoId": item.get("contentDetails", {}).get("videoId"),
+                    "title": item.get("snippet", {}).get("title"),
+                    "published": item.get("snippet", {}).get("publishedAt"),
+                }
+            )
+        page_token = str(payload.get("nextPageToken") or "")
+        if not page_token:
+            break
+
+    return {
+        "uploads_playlist": uploads,
+        "pages_fetched": pages,
+        "complete": not page_token,
+        "next_page_token": page_token or None,
+        "items": videos,
+    }
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--max-pages", type=int, default=20)
+    args = parser.parse_args()
+    token = os.environ.get("GOOGLE_YOUTUBE_TOKEN", "")
+    if not token:
+        print(json.dumps({"error": "GOOGLE_YOUTUBE_TOKEN is not set"}))
+        return 2
+    try:
+        print(json.dumps(list_uploads(token, max_pages=max(1, min(args.max_pages, 100))), ensure_ascii=False))
+    except Exception as exc:
+        print(json.dumps({"error": str(exc)}, ensure_ascii=False))
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())