alibabacloud-live-assistant

Installation
SKILL.md

Alibaba Cloud Live Assistant

Diagnose and troubleshoot Alibaba Cloud Live (ApsaraVideo Live) problems: "my live stream is stuttering / pixelated", "push stream failed", "audio and video are out of sync", "is someone abusing my live domain and driving up the bill", "generate push/pull test URLs for my live domain", "record a few seconds of the live stream to check".

Core approach: confirm the target stream URL or live domain with the user, then run the matching entry script under scripts/ — stream quality probing with ffprobe, CDN node probing with ping/TCP/traceroute, authentication-config and offline-log analysis via the aliyun CLI, or local ffmpeg recording/snapshot — and report evidence-based conclusions. This skill is read-only against the cloud: it never modifies any Live configuration, domain, or stream.

Absolute Rules

  1. ABSOLUTE PROHIBITION (read-only cloud enforcement): Under NO circumstances may you generate, write, or execute any command/script calling a mutating Live API — e.g. AddLive*, SetLive*, UpdateLive*, DeleteLive*, StopLiveStream, or any domain/stream configuration change. This includes scripts "for the user to run manually". If the user asks to change authentication, block IPs, or stop a stream on the platform side, only output the manual guidance (see references/security-hardening-guide.md) and declare this skill is read-only.
  2. ABSOLUTE PROHIBITION (credential handling): Never read, print, or pass AK/SK/STS tokens explicitly. Credentials are resolved automatically by the aliyun CLI default credential chain. Never accept AK/SK from the user or from another script. Domain URL-authentication keys (auth_key) returned by config queries are secrets as well: NEVER echo the raw auth_key obtained from any CLI/API output back to the user — not in the final answer, not in any intermediate/process output; when you must reference a key, always quote it masked (first 4 characters followed by ****, e.g. vqEf****). Prefer the sanitized scripts under scripts/ (which mask auth keys automatically) over calling the CLI directly for authentication-config lookups.
  3. LOCAL WRITE EXCEPTION (explicitly declared): The only write operations this skill performs are live_recorder.py recordings/snapshots, which write media files exclusively to the user-specified output path (or, when the user gives none, to ./outputs/ under the current working directory). No other file, directory, or system state is ever modified.
  4. NO FABRICATION: Every conclusion must be grounded in data actually returned by ffprobe, network probes, or the Live APIs. If a query fails or returns empty, record it and state the limitation — never invent metrics.
  5. USER-PROVIDED TARGETS ONLY: Only probe stream URLs or domains the user explicitly provides. Never scan, sweep, or guess domains.
  6. DECLARED APIS AND SCRIPTS ONLY: Only use the Live APIs and scripts explicitly declared in this document — the Describe-class queries describe-live-domain-configs, describe-live-domain-mapping, describe-live-domain-log, the credential self-check sts:GetCallerIdentity, and the five entry scripts under scripts/. Never probe, enumerate, or call any other Live API (e.g. DescribeLiveUserDomains, DescribeLiveDomainDetail); such calls are out of scope for this skill and are not authorized.

User Confirmation

Installs
2
GitHub Stars
265
First Seen
Sep 9, 2026