@remixmate/cli 0.1.0

package/skills/export-jianying/skill.json

@@ -0,0 +1,24 @@
+{
+  "name": "export-jianying",
+  "toolName": "export_jianying",
+  "tier": "orchestration",
+  "title": "Jianying (CapCut) Draft Export",
+  "description": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. Supports automatic conversion from a RenderPlan.",
+  "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "AGENT_NAME"],
+  "scriptPath": "scripts/gen_jianying_draft.py",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "from_render_plan": { "type": "string", "description": "Build the draft from a RenderPlan JSON (replaces --scenes)" },
+      "scenes": { "type": "string", "description": "Scene array as JSON (inline string or file path)" },
+      "title": { "type": "string", "description": "Draft title" },
+      "width": { "type": "number", "description": "Canvas width in pixels (default 1080)" },
+      "height": { "type": "number", "description": "Canvas height in pixels (default 1920)" },
+      "system": { "type": "string", "enum": ["mac", "windows"], "description": "Draft-root preset" },
+      "draft_root_path": { "type": "string", "description": "Explicit Jianying draft root path (overrides --system)" },
+      "no_download": { "type": "boolean", "description": "Do not download the ZIP; print the URL only" },
+      "output": { "type": "string", "description": "Local download path" }
+    },
+    "required": []
+  }
+}

package/skills/export-jianying/version.json

@@ -0,0 +1,7 @@
+{
+  "skillName": "export-jianying",
+  "repoName": "agent-skill-media-maker",
+  "skillId": "554",
+  "version": "V2",
+  "skillDescription": "剪映草稿生成技能，将素材URL打包为剪映可导入的草稿ZIP，支持从 RenderPlan 自动转换（调用 ab-api /file/generateJianYing）。\n\n当用户提到以下任何需求时，立即使用本 skill：\n- 导出剪映、剪映草稿、打包剪映、导入剪映\n- 将素材导出为剪映格式、生成剪映工程\n- 把视频/图片/音频打包成剪映草稿\n- 从 RenderPlan 导出剪映草稿\n\n即使用户没有明确说「剪映」，只要他们想要将素材打包为可在剪映中编辑的草稿格式，也要使用本 skill。"
+}

package/skills/gen-digital-human/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: gen-digital-human
+description: |
+  Digital-human (talking-head) skill: list available avatars, run TTS-based or audio-driven lip-sync, and check the status of pending jobs. Backed by ab-api's digital-human endpoints (Jimeng / HiFly providers).
+
+  Use this skill immediately whenever the user asks for any of:
+  - Digital human, talking-head video, AI presenter, virtual host
+  - "Make a talking-head video out of this script / this audio file"
+  - List or browse digital-human avatars
+  - Use Jimeng or HiFly to drive an avatar
+
+  Even without an explicit "use AI", any request that turns text or audio into a synthesized presenter video should route here.
+triggers:
+  - Digital human, talking-head video, AI presenter, virtual host
+  - "Make a talking-head video out of this script / this audio file"
+  - List or browse digital-human avatars
+  - Use Jimeng or HiFly to drive an avatar
+---
+
+# Digital-Human Skill
+
+Wraps ab-api's digital-human endpoints (the same ones the web studio uses), authenticated with the **Tianyan privateToken**. Two providers: **Jimeng** (image-driven) and **HiFly** (video-driven).
+
+## Capabilities
+
+| Capability | Description | API |
+|------------|-------------|-----|
+| List avatars | Page through available avatars; filter by source / gender / name | `POST /digital-human/avatar/page` |
+| TTS lip-sync | avatar + text + voice → talking-head video | `POST /digital-human/video/generate` |
+| Audio-driven | avatar + existing audio URL → talking-head video | `POST /digital-human/video/generate` |
+| Check status | Poll the progress of a generation job | `POST /digital-human/video/status` |
+
+**Cross-skill dependency**: voice ids are shared with `gen-voice` (same Minimax catalog). Use `gen-voice --list-voices` to see available voices.
+
+## Auth & environment
+
+No skill-local env file — the executing process inherits the system environment. Examples below say `python`; on macOS you may need `python3`.
+
+- **Enterprise OpenClaw**: auth is already injected, **no need** for `PRIV_TOKEN` / `--priv-token`.
+- **Other environments**: configure the token. Without a token, non-interactive runs fail; interactive ones may prompt.
+
+| Env var | Description | Default |
+|---------|-------------|---------|
+| `PRIV_TOKEN` | Tianyan token; `--priv-token` overrides | none |
+| `MM_API_BASE_URL` | API root | see `gen_digital_human_video.py` default |
+| `AGENT_NAME` | Optional `x-invoke-agent` header | none |
+
+## Operations
+
+**Script path**: read the system-injected `Base directory for this skill: <path>` as `<SkillDir>`. Always use `<SkillDir>/scripts/gen_digital_human_video.py`. Do not hardcode paths.
+
+### 1. List avatars
+
+```bash
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars
+```
+
+Optional filters:
+
+```bash
+# Filter by source (jimeng = image-driven, hifly = video-driven)
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars --source jimeng
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars --source hifly
+
+# Filter by gender
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars --gender female
+
+# Show your custom avatars
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars --mine
+
+# Filter by name
+python3 <SkillDir>/scripts/gen_digital_human_video.py --list-avatars --name "alice"
+```
+
+> Custom avatars require `--mine`. When generating a video the script auto-falls back from the public list to `mine: true` if needed.
+
+### 2. Generate a digital-human video
+
+By default only the URL is printed; pass `--download` (and optional `--output`) to save locally. Generation is async; the script polls until done (typically 1–5 minutes).
+
+#### TTS mode
+
+```bash
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --avatar-id 7 \
+  --text "Hi everyone, welcome to the live stream — today I'll introduce a new product." \
+  --voice-id "male-qn-qingse"
+```
+
+#### TTS + custom voice + aspect ratio
+
+```bash
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --avatar-id 7 \
+  --text "Hi class, here's our brand-new course." \
+  --voice-id "female-shaonv" \
+  --aspect-ratio "9:16"
+```
+
+#### Audio-driven mode
+
+```bash
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --avatar-id 39 \
+  --source hifly \
+  --audio-url "https://example.com/voice.mp3" \
+  --aspect-ratio "16:9"
+```
+
+#### Download to disk
+
+```bash
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --avatar-id 7 \
+  --text "Hello world" \
+  --download \
+  --output "digital_human_output.mp4"
+```
+
+### 3. Check job status
+
+```bash
+# Status only
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --check-status --generation-id 123
+
+# Download once it's done
+python3 <SkillDir>/scripts/gen_digital_human_video.py \
+  --check-status --generation-id 123 --download --output result.mp4
+```
+
+For the full flag list: `python3 <SkillDir>/scripts/gen_digital_human_video.py --help`.
+
+## Common CLI flags
+
+### List avatars
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--list-avatars` | List avatars and exit | — |
+| `--source` | Filter by source: `jimeng` / `hifly` | no filter |
+| `--gender` | Filter by gender: `male` / `female` | no filter |
+| `--mine` | Limit to user's custom avatars | off |
+| `--name` | Fuzzy filter by name | no filter |
+
+### Generate video
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--avatar-id` | Avatar id (required) | — |
+| `-t` / `--text` | Speech text (required for TTS mode; optional with `--audio-url`) | — |
+| `--audio-url` | Audio URL (audio-driven mode) | none |
+| `--voice-id` | Voice id (TTS mode) | `male-qn-qingse` |
+| `--voice-name` | Voice display name (recordkeeping) | none |
+| `--source` | `jimeng` / `hifly` (inferable from avatar) | auto |
+| `--aspect-ratio` | `9:16` / `16:9` / `3:4` / `1:1` | avatar's default |
+| `--prompt` | Action prompt (e.g. "more hand gestures") | none |
+| `--download` | Download the video locally | off |
+| `-o` / `--output` | Download path (only with `--download`) | `digital_human_video.mp4` |
+| `--poll-interval` | Polling interval (seconds) | `5` |
+| `--max-wait` | Max wait time (seconds) | `600` |
+| `--private-token` | Override token | see env vars |
+
+### Check status
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--check-status` | Enter status-check mode | — |
+| `--generation-id` | Job id (required) | — |
+| `--download` | Download when finished | off |
+| `-o` / `--output` | Download path | `digital_human_video.mp4` |
+
+## Typical flows
+
+### Flow A — TTS
+
+```
+1. List avatars → --list-avatars [--gender female]
+2. Pick avatar-id
+3. Confirm or polish the speech text
+4. (Optional) pick a voice → use gen-voice --list-voices
+5. Generate → --avatar-id <id> --text "..." --voice-id "female-shaonv"
+6. Show URL or local path
+```
+
+### Flow B — Audio-driven
+
+```
+1. List avatars → --list-avatars [--mine]
+2. Prepare an audio URL (gen-voice can produce one)
+3. Generate → --avatar-id <id> --audio-url "https://..." [--source hifly]
+4. Show URL or local path
+```
+
+## Text guidance (TTS)
+
+- Punctuation drives pacing — commas short, periods long.
+- Keep individual jobs under ~500 characters.
+- Tone and style of the script affect the perceived voice.
+
+## Error handling
+
+- **401** / **token missing** (non-OpenClaw): set `PRIV_TOKEN`.
+- **Business `code != 0`**: read `msg` on stderr.
+- **429**: rate-limited; retry later.
+- **Generation timeout**: increase `--max-wait`, or use `--check-status` later.
+- **Empty TTS text**: provide non-empty `--text` or use `--audio-url`.
+- **Invalid voice id**: re-check via `gen-voice --list-voices`.
+- **Avatar id not found**: re-check via `--list-avatars` (or `--list-avatars --mine`).
+- **Cannot infer source**: when the avatar lacks a `source` and `--source` is not set, pass `--source jimeng` or `--source hifly` explicitly.
+- **Network**: verify connectivity and `MM_API_BASE_URL`.