@remixmate/cli 0.1.0 → 0.1.2

package/skills/gen-script/scripts/gen_script.py

@@ -12,7 +12,7 @@ Usage:
 
 Environment variables:
   VIDEO_DSL_SCHEMA_PATH - DSL schema file path
-    (default: skills/template-bind/video_dsl/schema/video-dsl-v1alpha1.json)
+    (default: skills/template-registry/video_dsl/schema/video-dsl-v1alpha1.json)
 """
 
 import argparse
@@ -24,20 +24,19 @@ import uuid
 
 SCHEMA_PATH = os.environ.get(
     "VIDEO_DSL_SCHEMA_PATH",
-    "skills/template-bind/video_dsl/schema/video-dsl-v1alpha1.json",
+    "skills/template-registry/video_dsl/schema/video-dsl-v1alpha1.json",
 )
 
 # prompt_enhancer 路径动态添加
-_TEMPLATE_DSL_DIR = os.path.join(os.path.dirname(__file__), "..", "..", "template-bind", "video_dsl")
+_TEMPLATE_DSL_DIR = os.path.join(os.path.dirname(__file__), "..", "..", "template-registry", "video_dsl")
 if os.path.isdir(_TEMPLATE_DSL_DIR):
     sys.path.insert(0, os.path.abspath(os.path.join(_TEMPLATE_DSL_DIR, "..")))
 
-# Shared Python lib lives under skills/template-bind/scripts/ — the de-facto
-# cross-skill module location (registry_loader, template_paths, etc.). Named
-# generically here so its host skill could be renamed without touching every
-# caller. See AGENTS.md for the convention.
+# Shared Python lib lives under skills/template-registry/scripts/ — the de-facto
+# cross-skill module location (registry_loader, template_paths, etc.). See
+# AGENTS.md for the convention.
 _SHARED_SCRIPTS_DIR = os.path.join(
-    os.path.dirname(__file__), "..", "..", "template-bind", "scripts"
+    os.path.dirname(__file__), "..", "..", "template-registry", "scripts"
 )
 if os.path.isdir(_SHARED_SCRIPTS_DIR):
     sys.path.insert(0, os.path.abspath(_SHARED_SCRIPTS_DIR))
@@ -58,7 +57,7 @@ except ImportError:
     _HAS_REGISTRY_LOADER = False
 
 try:
-    # Centralized monorepo-path resolver living in template-bind/scripts/;
+    # Centralized monorepo-path resolver living in template-registry/scripts/;
     # the import works because the same sys.path.insert above pointed at it.
     from template_paths import monorepo_template_src_dir as _monorepo_template_src_dir
 except ImportError:
@@ -326,7 +325,7 @@ def _load_template_config(template_id: str) -> dict | None:
     解析顺序（与 match_template / template_binder 保持一致）：
       1. 通过 registry_loader 从 monorepo template-library/packages/metadata/registry.json
          （或 VIDEO_TEMPLATE_REGISTRY[_URL] 环境变量）加载，并按 templateId 匹配。
-      2. 兜底：旧路径 apps/ab-skill/skills/template-bind/video_dsl/templates/<id>/template.json
+      2. 兜底：旧路径 template-registry/video_dsl/templates/<id>/template.json
          （仅在仓库还残留旧目录时使用）。
     返回完整 template dict（含 supportedAspectRatios / assetRequirements / slotMapping 等），
     找不到时返回 None。
@@ -343,7 +342,7 @@ def _load_template_config(template_id: str) -> dict | None:
 
     # 兜底：旧的本地目录布局
     legacy_dir = os.path.join(
-        os.path.dirname(__file__), "..", "..", "template-bind", "video_dsl", "templates"
+        os.path.dirname(__file__), "..", "..", "template-registry", "video_dsl", "templates"
     )
     legacy_file = os.path.join(legacy_dir, template_id, "template.json")
     if os.path.isfile(legacy_file):
@@ -408,7 +407,7 @@ def _locate_template_dir(template_id: str) -> str | None:
     """定位模板源码目录（template-library/packages/templates/src/<id>/）。
 
     路径解析已集中到 ``template_paths.monorepo_template_src_dir``；
-    当 helper 不可用（template-bind/scripts/ 不在 sys.path）时回退到 None,
+    当 helper 不可用（template-registry/scripts/ 不在 sys.path）时回退到 None,
     与原始函数"找不到就返回 None"的语义一致。
     """
     if _monorepo_template_src_dir is None:
@@ -1055,6 +1054,11 @@ Examples:
         default=None,
         help="On-screen subheadline / project name (e.g. 'Pixelle-Video'). Stored at meta.subheadline and pushed into textLayers[role=subheadline]. Independent from CC subtitles (global.subtitle).",
     )
+    parser.add_argument(
+        "--skip-asset-generation",
+        action="store_true",
+        help="Skill-creator / template-creator helper: when set, every produced AssetRef is marked as already generated with a stub URL — no gen-image / gen-voice / gen-video calls are needed. Implies --stub-image-url + --stub-video-url with default sentinels (https://placeholder.local/stub.png|.mp4) when those flags are absent, and additionally rewrites every gen-voice asset to source=existing + status=generated + a placeholder audio URL. Useful when a downstream agent only wants the DSL shape (e.g. to feed into try_render with all assets pre-stubbed).",
+    )
     parser.add_argument(
         "--stub-image-url",
         default=None,
@@ -1158,6 +1162,22 @@ Examples:
             print(f"⚠️  STUB_VIDEO_URL env var detected ({env_v}); using it as the video stub. Prefer passing --stub-video-url explicitly, or unset the env var.", file=sys.stderr)
         stub_video_url = env_v
 
+    # --skip-asset-generation 是为下游"只想要 DSL shape"的 agent 设计的
+    # 一键开关：等价于 --stub-image-url + --stub-video-url + 把 gen-voice 资产
+    # 也写成 source=existing + status=generated。当用户没显式提供 stub URL 时
+    # 用一组 sentinel 占位（https://placeholder.local/...），模板创作 / 调试场景
+    # 不会真的去 fetch 这些 URL。
+    if args.skip_asset_generation:
+        if not stub_image_url:
+            stub_image_url = "https://placeholder.local/stub.png"
+        if not stub_video_url:
+            stub_video_url = "https://placeholder.local/stub.mp4"
+        print(
+            "ℹ️  --skip-asset-generation: forcing all assets to source=existing/status=generated "
+            f"(image={stub_image_url}, video={stub_video_url}, audio=https://placeholder.local/stub.mp3)",
+            file=sys.stderr,
+        )
+
     dsl = build_dsl(
         topic=args.topic,
         platform=args.platform,
@@ -1178,6 +1198,24 @@ Examples:
         caption_lines=args.caption_lines,
     )
 
+    # Post-process for --skip-asset-generation: rewrite all gen-voice / gen-digital-human
+    # assets to be already-generated stubs. Image / video are already covered by the
+    # stub_image_url / stub_video_url params threaded through build_dsl above.
+    if args.skip_asset_generation:
+        _AUDIO_STUB = "https://placeholder.local/stub.mp3"
+        _VIDEO_STUB = stub_video_url  # same sentinel for digital-human placeholder
+        for asset in dsl.get("assets", []):
+            src = asset.get("source")
+            if src in ("gen-voice",):
+                asset["source"] = "existing"
+                asset["status"] = "generated"
+                asset["url"] = _AUDIO_STUB
+                # payload 留作 reference（renderer 不会再读它，因为 status=generated）
+            elif src in ("gen-digital-human",):
+                asset["source"] = "existing"
+                asset["status"] = "generated"
+                asset["url"] = _VIDEO_STUB
+
     errors = validate_dsl(dsl)
     if errors:
         print("❌ generated DSL failed validation:", file=sys.stderr)

package/skills/gen-script/skill.json

@@ -2,6 +2,7 @@
   "name": "gen-script",
   "toolName": "gen_script",
   "tier": "orchestration",
+  "category": "authoring",
   "title": "Video Script Generation",
   "description": "Video script generation: turn a topic into a structured Video DSL (JSON) that describes the full video — scene structure, asset requirements, and narrative flow.",
   "envVars": ["DEFAULT_IMAGE_MODEL", "DEFAULT_VIDEO_MODEL", "STUB_IMAGE_URL", "STUB_VIDEO_URL"],
@@ -34,7 +35,8 @@
         "description": "Bottom typewriter text lines for templates that support a caption/typewriter area (e.g. spotlight-card). Each element is one line of text. Supports **emphasis** syntax (rendered with accent color). **Must** pass when the user explicitly provides bullet-point text / bottom copy for the video."
       },
       "stub_image_url": { "type": "string", "description": "Test-mode image stub URL. Only pass when the user explicitly says things like 'just testing / don't actually generate / use a placeholder image / stub URL / save credits' AND provides a concrete URL. With this set, every image AssetRef in the produced DSL is written as source=existing, status=generated, url=<this URL> — no gen-image call. Do not pass otherwise; if the user expressed the intent without a URL, ask for one — do not invent one." },
-      "stub_video_url": { "type": "string", "description": "Test-mode video stub URL. Only pass when the user explicitly says things like 'just testing / don't actually generate the video / placeholder clip / save credits' AND provides a concrete URL. With this set, every video AssetRef in the produced DSL is written as source=existing, status=generated, url=<this URL> — no gen-video call. Do not pass otherwise; if the user expressed the intent without a URL, ask for one — do not invent one." }
+      "stub_video_url": { "type": "string", "description": "Test-mode video stub URL. Only pass when the user explicitly says things like 'just testing / don't actually generate the video / placeholder clip / save credits' AND provides a concrete URL. With this set, every video AssetRef in the produced DSL is written as source=existing, status=generated, url=<this URL> — no gen-video call. Do not pass otherwise; if the user expressed the intent without a URL, ask for one — do not invent one." },
+      "skip_asset_generation": { "type": "boolean", "description": "All-in-one switch for downstream agents (e.g. template-creator) that only want the DSL shape: every produced AssetRef is marked as already generated with placeholder URLs (image: https://placeholder.local/stub.png, video: stub.mp4, audio: stub.mp3). Implies the equivalent of --stub-image-url + --stub-video-url with sentinel defaults plus the same rewrite for gen-voice / gen-digital-human assets. Useful when the agent only needs to inspect DSL structure or feed it into try_render_local with all assets pre-stubbed." }
     },
     "required": ["topic"]
   }

package/skills/gen-video/SKILL.md

@@ -17,11 +17,13 @@ triggers:
 
 # AI Video Generation Skill
 
-Wraps ab-api's `POST /model/genVideo` (the same endpoint the web "Lingchuang AI Video" tool uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to **Seedance** or **Veo**.
+Wraps ab-api's `POST /model/genVideo` (the same endpoint the web "Lingchuang AI Video" tool uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to **Seedance** or **Veo**. Generation is async — the handler submits the task and polls `/model/getVideoStatus` until completion.
+
+> This skill was migrated from a Python script to an ab-skill CLI HTTP handler (`entry.type: http`). The agent invocation is unchanged (same tool name `gen_video`, same params as in `skill.json`); local repro goes through `ab-skill gen-video ...`.
 
 ## Models
 
-Aligned with `gen_video.py`'s `GEN_VIDEO_MODEL_PRESETS` and the frontend `AI_VIDEO_MODELS`:
+Aligned with the handler's `MODEL_ALIASES` and the frontend `AI_VIDEO_MODELS`:
 
 | LiteLLM `model` | Display name | Provider | Duration | Notes |
 |-----------------|--------------|----------|----------|-------|
@@ -49,29 +51,28 @@ Aligned with `gen_video.py`'s `GEN_VIDEO_MODEL_PRESETS` and the frontend `AI_VID
 
 ## Auth & environment
 
-No skill-local env file — the executing process inherits the system environment. Examples below say `python`; on macOS you may need `python3`.
+No skill-local env file — the executing process inherits the system environment.
 
 - **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.
+- **Other environments**: configure the token. Without a token, non-interactive runs fail.
 
 | Env var | Description | Default |
 |---------|-------------|---------|
 | `PRIV_TOKEN` | Tianyan token; `--priv-token` overrides | none |
 | `MM_VIDEO_MODEL` | Default model id | `doubao-seedance-1-5-pro-251215` |
-| `MM_API_BASE_URL` | API root | see `gen_video.py` default |
+| `MM_API_BASE_URL` | API root; `--api-base-url` overrides | `http://localhost:2999/api` |
 | `AGENT_NAME` | Optional `x-invoke-agent` header | none |
 
 ## Operations
 
-1. **Script path**: read the system-injected `Base directory for this skill: <path>` as `<SkillDir>` and always use `<SkillDir>/scripts/gen_video.py`. Do not hardcode paths.
-2. **Prompt**: include camera language ("aerial shot", "slow motion", "push-in") and dynamic descriptions for better results. Chinese or English both work.
-3. By default only the URL is printed; pass `--download` (and optional `--output`) to save locally.
-4. **Async job**: video generation is async; the script polls until completion (typically 1–3 minutes).
+1. **Prompt**: include camera language ("aerial shot", "slow motion", "push-in") and dynamic descriptions for better results. Chinese or English both work. For pure image-to-video, an empty prompt with first/last frame is allowed.
+2. **Async job**: video generation is async; the handler polls until completion (typically 1–3 minutes) and emits `__progress__` lines.
+3. **Surface results**: stdout prints the video URL on its own line; show it directly to the user (no download needed — the URL is cloud-persisted).
 
 ### Seedance text-to-video (default model)
 
 ```bash
-python3 <SkillDir>/scripts/gen_video.py \
+ab-skill gen-video \
   --prompt "<video description>" \
   --duration 5 \
   --ratio "16:9"
@@ -79,8 +80,10 @@ python3 <SkillDir>/scripts/gen_video.py \
 
 ### Seedance first/last frame + audio
 
+Frame images accept local file paths, HTTPS URLs, or data URIs (local files are base64-encoded into a data URI).
+
 ```bash
-python3 <SkillDir>/scripts/gen_video.py \
+ab-skill gen-video \
   --prompt "<transition description>" \
   --first-frame ./start.png \
   --last-frame ./end.png \
@@ -91,7 +94,7 @@ python3 <SkillDir>/scripts/gen_video.py \
 ### Veo 3.1 high-resolution
 
 ```bash
-python3 <SkillDir>/scripts/gen_video.py \
+ab-skill gen-video \
   --model veo \
   --prompt "<video description>" \
   --duration 8 \
@@ -102,7 +105,7 @@ python3 <SkillDir>/scripts/gen_video.py \
 ### Veo 3.1 Fast for rapid iteration
 
 ```bash
-python3 <SkillDir>/scripts/gen_video.py \
+ab-skill gen-video \
   --model veo-fast \
   --prompt "<video description>" \
   --duration 6
@@ -110,8 +113,10 @@ python3 <SkillDir>/scripts/gen_video.py \
 
 ### Veo with reference images
 
+Pass `--reference` multiple times (Veo only, up to 3).
+
 ```bash
-python3 <SkillDir>/scripts/gen_video.py \
+ab-skill gen-video \
   --model veo \
   --prompt "<video description>" \
   --reference ./ref1.png \
@@ -119,19 +124,6 @@ python3 <SkillDir>/scripts/gen_video.py \
   --duration 8
 ```
 
-### Download to disk
-
-```bash
-python3 <SkillDir>/scripts/gen_video.py \
-  --prompt "<video description>" \
-  --download \
-  --output "output_video.mp4"
-```
-
-5. **Surface results**: without `--download`, print the video URL; with `--download`, mention the local path.
-
-For the full flag list: `python3 <SkillDir>/scripts/gen_video.py --help`.
-
 ## Common CLI flags
 
 | Flag | Description | Default |
@@ -149,11 +141,8 @@ For the full flag list: `python3 <SkillDir>/scripts/gen_video.py --help`.
 | `--negative-prompt` | Negative prompt (mainly Veo) | none |
 | `--seed` | Random seed | none |
 | `--person-generation` | Person policy: `allow_all` / `dont_allow` (Veo) | none |
-| `--download` | Download the video to disk | off |
-| `-o` / `--output` | Download path (only effective with `--download`) | `generated_video.mp4` |
-| `--poll-interval` | Polling interval (seconds) | `10` |
-| `--max-wait` | Max wait time (seconds) | `300` |
-| `--private-token` | Override token | see above |
+| `--api-base-url` | Override API root | see above |
+| `--priv-token` | Override token | see above |
 
 ## Prompt tips
 
@@ -166,5 +155,5 @@ For the full flag list: `python3 <SkillDir>/scripts/gen_video.py --help`.
 - **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 retry later.
+- **Generation timeout**: the handler caps polling at ~5 minutes; retry later if it times out.
 - **Network**: verify connectivity and `MM_API_BASE_URL`.

package/skills/gen-video/skill.json

@@ -2,10 +2,11 @@
   "name": "gen-video",
   "toolName": "gen_video",
   "tier": "atomic",
+  "category": "asset",
   "title": "AI Video Generation",
   "description": "AI video generation: produce a short video clip from a text prompt. Supports Seedance and Veo models, plus first/last frame and reference images.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "AGENT_NAME", "MM_VIDEO_MODEL"],
-  "scriptPath": "scripts/gen_video.py",
+  "entry": { "type": "http", "handler": "gen-video" },
   "parameters": {
     "type": "object",
     "properties": {
@@ -17,7 +18,8 @@
       "first_frame": { "type": "string", "description": "First-frame image path or URL" },
       "last_frame": { "type": "string", "description": "Last-frame image path or URL" },
       "reference": { "type": "string", "description": "Reference image (Veo only)" },
-      "generate_audio": { "type": "boolean", "description": "Generate native audio" }
+      "generate_audio": { "type": "boolean", "description": "Generate native audio" },
+      "json_output": { "type": "boolean", "description": "Emit a JSON result ({ url }) instead of human-readable output" }
     },
     "required": ["prompt"]
   }

package/skills/gen-video/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-video",
   "repoName": "agent-skill-media-maker",
   "skillId": "339",
-  "version": "V5",
+  "version": "V7",
   "skillDescription": "AI 生视频技能，根据文字描述生成素材视频（调用 ab-api /model/genVideo，支持 Seedance 与 Veo）。\n\n当用户提到以下任何需求时，立即使用本 skill：\n- AI 生视频、文生视频、文字生成视频、生成一段视频、AI 制作视频\n- 使用 doubao / 豆包 / seedance、Veo、Google 等生成视频\n- 用户提供视频提示词并希望生成视频\n- 图生视频、首帧生成视频、参考图生成视频\n\n即使用户没有明确说「使用 AI」，只要他们想要根据描述生成视频，也要使用本 skill。"
 }

package/skills/gen-voice/SKILL.md

@@ -29,7 +29,7 @@ There is no skill-local env file — the executing process inherits the system e
 | Env var | Description | Default |
 |---------|-------------|---------|
 | `PRIV_TOKEN` | Tianyan token; `--priv-token` overrides | none |
-| `MM_API_BASE_URL` | API root | see `gen_voice.py` default |
+| `MM_API_BASE_URL` | API root; `--api-base-url` overrides | `http://localhost:2999/api` |
 | `AGENT_NAME` | Optional `x-invoke-agent` header | none |
 
 ## Operations

package/skills/gen-voice/skill.json

@@ -2,6 +2,7 @@
   "name": "gen-voice",
   "toolName": "gen_voice",
   "tier": "atomic",
+  "category": "asset",
   "title": "Text-to-Speech (Minimax)",
   "description": "Text-to-speech (TTS): synthesize narration audio from text via the Minimax TTS model. Returns the persisted audio URL — no download needed.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "AGENT_NAME"],

package/skills/gen-voice/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-voice",
   "repoName": "agent-skill-media-maker",
   "skillId": "338",
-  "version": "V5",
+  "version": "V6",
   "skillDescription": "语音合成（TTS）技能，将文字转为语音音频（调用 ab-api /tool/minimaxT2aV2，基于 Minimax TTS）。\n\n当用户提到以下任何需求时，立即使用本 skill：\n- AI 配音、语音合成、文字转语音、TTS、文本转音频、生成语音\n- 使用 minimax 语音合成\n- 用户想要将一段文字朗读出来、生成音频\n\n即使用户没有明确说「使用 AI」，只要他们想要将文字转为语音，也要使用本 skill。"
 }

package/skills/prepare-video-assets/SKILL.md

@@ -79,7 +79,7 @@ python3 <SkillDir>/scripts/prepare_video_assets.py \
   --template-id html-slide
 ```
 
-`--template-id` automatically calls template-bind internally; or pass `--binding my-video.binding.json` if you have a pre-generated binding.
+`--template-id` automatically calls template-registry internally; or pass `--binding my-video.binding.json` if you have a pre-generated binding.
 
 ## Image-URL handling (agent rules)
 
@@ -189,4 +189,4 @@ The Asset Resolver handles each `AssetRef` in this order:
 ## See also
 
 - **`render_video`** — the Phase 3 skill that consumes this skill's `job_id` and produces the final video.
-- **`template-bind`** — Lists available templates. Called internally by this skill when `--template-id` is provided.
+- **`template-registry`** — Lists available templates. Called internally by this skill when `--template-id` is provided.

package/skills/prepare-video-assets/skill.json

@@ -2,6 +2,7 @@
   "name": "prepare-video-assets",
   "toolName": "prepare_video_assets",
   "tier": "orchestration",
+  "category": "authoring",
   "title": "Video Asset Preparation",
   "description": "Resolves and generates every asset (image / audio / video) referenced by a Video DSL, persists a RenderPlan to the database, and returns a job_id for the subsequent render_video call. This is Phase 1 of the two-phase video pipeline; Phase 3 (Remotion render) lives in render_video.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "MM_BACKEND_API_URL", "AGENT_NAME", "REMOTION_RENDER_API_URL", "REMOTION_RENDER_MODE", "REMOTION_OUTPUT_DIR", "ASSET_CACHE_DIR"],
@@ -11,7 +12,7 @@
     "properties": {
       "dsl_json": { "type": "string", "description": "DSL JSON as an inline string (preferred — no disk write needed; required for multi-user concurrent flows). Pass the full DSL JSON, or — when a gen_script skeleton is cached in the session — a minimal JSON with only scenes[].audio.narration.text overrides (the agent layer merges narration onto the cached skeleton)." },
       "dsl": { "type": "string", "description": "DSL file path (legacy fallback; prefer dsl_json inline)." },
-      "template_id": { "type": "string", "description": "Template id. When provided, the script invokes template-bind internally; no separate binding step is needed." },
+      "template_id": { "type": "string", "description": "Template id. When provided, the script invokes template-registry internally; no separate binding step is needed." },
       "binding_json": { "type": "string", "description": "TemplateBinding JSON as an inline string (alternative to template_id; no file needed)." },
       "binding": { "type": "string", "description": "TemplateBinding file path (optional; auto-generated when template_id is provided)." },
       "save_job": { "type": "boolean", "description": "Persist the RenderPlan to the database (default true). On success the stdout contains '📦 render job jobId: N'. Auto-degrades to false when PRIV_TOKEN is missing, falling back to file mode. Pass false to opt out explicitly." },

package/skills/render-video/scripts/render_video.py

@@ -38,17 +38,17 @@ from datetime import datetime, timezone
 from typing import Optional
 
 # ── Cross-skill dependency ────────────────────────────────────────────────
-# Reach into `skills/template-bind/` — that directory is the de-facto home
+# Reach into `skills/template-registry/` — that directory is the de-facto home
 # for shared Python code in ab-skill (timeline-compilation, registry loader,
-# render-job HTTP client, etc.). Naming it `_SHARED_LIB_DIR` rather than
-# `_TEMPLATE_BIND_DIR` reflects its actual role: it hosts much more than
-# template-binding now (see AGENTS.md "skills/template-bind/scripts/" note).
+# render-job HTTP client, etc.). Naming it `_SHARED_LIB_DIR` reflects its
+# actual role: it hosts much more than template lookup (see AGENTS.md
+# "skills/template-registry/scripts/" note).
 #
 # If signatures of the functions below change, also update:
-#   - skills/template-bind/video_dsl/runtime/timeline_compiler.py (the source)
+#   - skills/template-registry/video_dsl/runtime/timeline_compiler.py (the source)
 #   - any other caller discoverable via `grep -r "split_subtitle\|segment_narration"`
 # ───────────────────────────────────────────────────────────────────────────
-_SHARED_LIB_DIR = os.path.join(os.path.dirname(__file__), "..", "..", "template-bind")
+_SHARED_LIB_DIR = os.path.join(os.path.dirname(__file__), "..", "..", "template-registry")
 # Single sys.path setup for both cross-skill import surfaces of the shared lib:
 #   - <shared>            for `video_dsl.runtime.*`
 #   - <shared>/scripts    for `registry_loader`, `match_template`,
@@ -1779,7 +1779,7 @@ def auto_bind_template(dsl: dict, template_id: str) -> dict:
     """Auto-generate TemplateBinding from DSL + template-id by importing
     match_template.py's binding logic. Eliminates the need for a separate
     match_template.py invocation step."""
-    # template-bind/scripts is on sys.path via the module-top setup.
+    # template-registry/scripts is on sys.path via the module-top setup.
     try:
         import match_template
     except ImportError as e:
@@ -1885,7 +1885,7 @@ Examples:
         if not private_token:
             LogPrint("❌ --job-id mode requires PRIV_TOKEN or --priv-token", file=sys.stderr)
             sys.exit(1)
-        # render_job_client lives in skills/template-bind/scripts/ (the shared
+        # render_job_client lives in skills/template-registry/scripts/ (the shared
         # location for cross-skill helpers); it is already on sys.path via the
         # module-top setup.
         from render_job_client import get_plan as rjc_get_plan

package/skills/render-video/skill.json

@@ -2,6 +2,7 @@
   "name": "render-video",
   "toolName": "render_video",
   "tier": "orchestration",
+  "category": "authoring",
   "title": "Remotion Video Renderer",
   "description": "Loads a persisted RenderPlan by job_id and drives the Remotion engine to produce the final video. Assets must already be generated via prepare_video_assets — this skill never resolves or regenerates assets.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "MM_BACKEND_API_URL", "AGENT_NAME", "REMOTION_RENDER_API_URL", "REMOTION_RENDER_MODE", "REMOTION_OUTPUT_DIR", "ASSET_CACHE_DIR"],

package/skills/{template-bind → template-registry}/README.md

@@ -1,4 +1,4 @@
-# template-bind
+# template-registry
 
 CLI 暴露面是「列出可用模板」(`--list-templates`)。把 Video DSL 场景绑到具体模板 / 生成 TemplateBinding 的 Python 逻辑由本 skill 提供为**库**(`scripts/match_template.py`),被 `render-video` / `prepare-video-assets` 通过 `sys.path` 内联 import,**没有独立 CLI**。
 
@@ -20,7 +20,7 @@ ab-api 响应包装格式 `{code, msg, data}` 由 `registry_loader._fetch_http`
 
 ## 新增模板工作流
 
-新增模板**不需要改 ab-skill / template-bind 代码**:
+新增模板**不需要改 ab-skill / template-registry 代码**:
 
 1. 在 template-library 仓库定义新模板(`template.json` + 组件代码)。
 2. template-library CI 校验 schema + 契约。
@@ -50,13 +50,13 @@ python3 <SkillDir>/scripts/check_contracts.py
 | 模块 | 谁在用 | 作用 |
 |---|---|---|
 | `template_paths.py` | registry_loader / template_binder / gen-script / check_contracts | 统一计算 monorepo / template-library 路径,代替 4 个 caller 各自数 `..` |
-| `registry_loader.py` | template-bind handler / match_template / render-video / gen-script / dsl_validator | 加载 registry(HTTP + cache + file) |
+| `registry_loader.py` | template-registry / match_template / render-video / gen-script / dsl_validator | 加载 registry(HTTP + cache + file) |
 | `match_template.py` | render-video(`auto_bind_template`) | DSL → TemplateBinding 算法 |
 | `render_job_client.py` | render-video / export-jianying | ab-api renderJob HTTP 客户端 |
 | `check_contracts.py` | 维护脚本 | template-library ↔ remotion-renderer 契约校验 |
 | `sync_registry.py` | 维护脚本 | 把 registry 摘要落盘供 LLM prompt 使用 |
 
-sibling skill 通过 `sys.path.insert(0, "<…>/template-bind/scripts")` 然后直接 `import` 模块名,模式见 `render_video.py` 顶部的"Single sys.path setup"段。
+sibling skill 通过 `sys.path.insert(0, "<…>/template-registry/scripts")` 然后直接 `import` 模块名,模式见 `render_video.py` 顶部的"Single sys.path setup"段。
 
 ## 详细使用说明
 

package/skills/{template-bind → template-registry}/SKILL.md

@@ -1,17 +1,14 @@
 ---
-name: template-bind
+name: template-registry
 description: |
-  Video-template registry and binding skill. Stores every video-template definition and produces a TemplateBinding for a given template id.
+  Video-template registry skill. Stores every video-template definition and lists the available templates (templateId / name / aspect ratio / style tags).
 
   Use this skill as soon as the user mentions any of these intents:
   - View available templates / list every template
-  - Bind a template to a DSL (a template-id must be supplied)
 
-  Also use this skill whenever the agent has a Video DSL and needs to produce a TemplateBinding.
+  Note: DSL→TemplateBinding is no longer a separate exposed step — once prepare_video_assets receives a template_id it builds the binding internally.
 triggers:
   - View available templates / list every template
-  - Bind a template to a DSL (a template-id must be supplied)
-  - Agent has a Video DSL and needs a TemplateBinding
 ---
 
 # Video Template Registry & Binding Skill
@@ -28,7 +25,7 @@ Stores every video-template definition, loads a template by **template-id**, and
 
 Template metadata lives in the standalone **template-library** monorepo and ships via the `@ab-templates/metadata` package.
 
-template-bind reads `template-library/packages/metadata/registry.json` to load every template definition (with the full slotMapping, compositions, etc.).
+template-registry reads `template-library/packages/metadata/registry.json` to load every template definition (with the full slotMapping, compositions, etc.).
 
 ```
 template-library/packages/
@@ -76,11 +73,11 @@ Resolution order (see `scripts/registry_loader.py` for the canonical implementat
 
 ## Steps
 
-> This skill is now a built-in handler of the ab-skill CLI (`entry.type: builtin`). The agent tool name `template_bind` is still the only entry; locally reproduce via `ab-skill template-bind --list-templates`.
+> This skill is a Python skill of the ab-skill CLI (`entry.type: python` → `scripts/list_templates.py`). The agent tool name `template_registry` is the only entry; locally reproduce via `ab-skill template-registry --list-templates`. The list command delegates to `scripts/registry_loader.py` — the same loader (with caching + stable/beta gating) that `render-video` and `gen-script` import in-process, so there is a single registry-reading implementation.
 >
-> The Python binding logic that maps DSL → TemplateBinding lives in `scripts/match_template.py` but is **no longer exposed as a CLI** — it is only consumed as a Python library by `render-video`'s `render_video.py` via `import match_template`. The `template-bind` skill itself no longer has a Python entry script.
+> The Python binding logic that maps DSL → TemplateBinding lives in `scripts/match_template.py` but is **not exposed as a CLI** — it is only consumed as a Python library by `render-video`'s `render_video.py` via `import match_template`.
 
-1. **List available templates**: run `ab-skill template-bind --list-templates` to view the templates in the registry along with their supported aspect ratios / style tags, and decide which `templateId` to pick.
+1. **List available templates**: run `ab-skill template-registry --list-templates` to view the templates in the registry along with their supported aspect ratios / style tags, and decide which `templateId` to pick.
 2. **Write the DSL**: when generating the Video DSL, put the chosen `templateId` into `meta.templateId` (the canonical location). Use `meta.templateVariant` / `renderHints.templateVariant` to explicitly select a variant. The legacy `renderHints.templatePreference[0]` is still tolerated by `match_template.py` and `dsl_validator._pick_template_id` during transition, but new authors should write `meta.templateId`.
 3. **Produce the TemplateBinding**: there is no standalone CLI for DSL → TemplateBinding; `prepare_video_assets` calls `match_template.build_binding(template, dsl)` inline during the asset-resolution pipeline and embeds the binding into the RenderPlan it hands to the renderer — no separate `*.binding.json` file is written.
 
@@ -89,7 +86,7 @@ Resolution order (see `scripts/registry_loader.py` for the canonical implementat
 ### List available templates
 
 ```bash
-ab-skill template-bind --list-templates
+ab-skill template-registry --list-templates
 ```
 
 ### Sync the registry cache (optional, used for offline / LLM prompt)
@@ -123,7 +120,12 @@ print(json.dumps(binding, ensure_ascii=False, indent=2))
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--list-templates` | List every available template and exit (currently the only CLI verb). | — |
+| `--list-templates` | List every available template (currently the only CLI verb). | — |
+| `--filter-tag` | Keep only templates whose `styleTags` match this substring (case-insensitive). | none |
+| `--filter-aspect` | Keep only templates declaring this aspect ratio (e.g. `9:16`). | none |
+| `--filter-language` | Keep only templates whose `contentLanguage` includes this code (`zh`/`en`); language-agnostic templates always show. | none |
+| `--include-beta` | Also show `status: beta` templates (same effect as `ENABLE_BETA_TEMPLATES=1`). | off |
+| `--json-output` | Emit `{ "templates": [...] }` instead of the table. | off |
 
 ## Props extraction rules