@remixmate/cli 0.1.1 → 0.1.2

package/dist/manifest.json

@@ -1,11 +1,12 @@
 {
   "schemaVersion": 1,
-  "version": "0.1.1",
-  "generatedAt": "2026-06-08T05:59:50.921Z",
+  "version": "0.1.2",
+  "generatedAt": "2026-06-08T08:37:23.147Z",
   "skills": [
     {
       "id": "export-jianying",
       "tier": "orchestration",
+      "category": "consuming",
       "title": "Jianying (CapCut) Draft Export",
       "summary": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. Supports automatic conversion from a RenderPlan.",
       "triggers": [
@@ -28,6 +29,7 @@
     {
       "id": "gen-digital-human",
       "tier": "atomic",
+      "category": "asset",
       "title": "Digital-Human Talking-Head",
       "summary": "Digital-human video: list available avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL.",
       "triggers": [
@@ -50,6 +52,7 @@
     {
       "id": "gen-image",
       "tier": "atomic",
+      "category": "asset",
       "title": "AI Image Generation",
       "summary": "AI image generation: produce an image from a text prompt. Supports Seedream and Gemini models, plus image-to-image with reference images.",
       "triggers": [
@@ -73,6 +76,7 @@
     {
       "id": "gen-script",
       "tier": "orchestration",
+      "category": "authoring",
       "title": "Video Script Generation",
       "summary": "Video script generation: turn a topic into a structured Video DSL (JSON) that describes the full video — scene structure, asset requirements, and narrative flow.",
       "triggers": [
@@ -95,6 +99,7 @@
     {
       "id": "gen-video",
       "tier": "atomic",
+      "category": "asset",
       "title": "AI Video Generation",
       "summary": "AI video generation: produce a short video clip from a text prompt. Supports Seedance and Veo models, plus first/last frame and reference images.",
       "triggers": [
@@ -117,6 +122,7 @@
     {
       "id": "gen-voice",
       "tier": "atomic",
+      "category": "asset",
       "title": "Text-to-Speech (Minimax)",
       "summary": "Text-to-speech (TTS): synthesize narration audio from text via the Minimax TTS model. Returns the persisted audio URL — no download needed.",
       "triggers": [
@@ -138,6 +144,7 @@
     {
       "id": "prepare-video-assets",
       "tier": "orchestration",
+      "category": "authoring",
       "title": "Video Asset Preparation",
       "summary": "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.",
       "triggers": [
@@ -165,6 +172,7 @@
     {
       "id": "render-video",
       "tier": "orchestration",
+      "category": "authoring",
       "title": "Remotion Video Renderer",
       "summary": "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.",
       "triggers": [
@@ -192,6 +200,7 @@
     {
       "id": "template-registry",
       "tier": "orchestration",
+      "category": "authoring",
       "title": "Video Template Registry",
       "summary": "List all available video templates (templateId / name / aspect ratio / style tags). Template-to-DSL binding is no longer exposed as a separate step — once prepare_video_assets receives a template_id it runs the full DSL→RenderPlan pipeline internally.",
       "triggers": [
@@ -212,6 +221,7 @@
     {
       "id": "video-parser",
       "tier": "tool",
+      "category": "consuming",
       "title": "Video Deconstruction",
       "summary": "Video deconstruction: split a video into reusable assets (audio extraction, ASR transcript, keyframe extraction, scene segmentation).",
       "triggers": [
@@ -233,6 +243,7 @@
     {
       "id": "web-capture",
       "tier": "tool",
+      "category": "consuming",
       "title": "Web Page Capture",
       "summary": "Drive a headless browser (Playwright Python) to capture any URL to local files: full-page / element / region screenshots, fixed-duration / condition-triggered / auto-scroll recordings, and storyboard videos (highlight / focus / zoom / scroll / virtual-cursor click / caption / title-card / arrow / numbered sequence / redact / code-line highlight). Two entry scripts: scripts/screenshot.py (stills) and scripts/record.py (webm video, storyboards, templates).",
       "triggers": [

package/dist/skill-schema.d.ts

@@ -21,12 +21,30 @@ export type SkillEntry = {
     type: 'builtin';
     handler: string;
 };
+/**
+ * Skill 类别 — 区分"创作期 / 消费期 / 元数据型" skill。
+ *
+ * - "authoring": 创建 / 编辑模板期间使用，例如 template-registry / gen-script /
+ *                render-video（用于 try_render） / prepare-video-assets。
+ * - "consuming": 消费已有模板生成媒体，例如 export-jianying / video-parser /
+ *                web-capture（与"创建模板"无关，是消费侧场景）。
+ * - "asset":     生成单一类型素材的原子 skill：gen-image / gen-voice /
+ *                gen-video / gen-digital-human。authoring 也会用，但通过 stub
+ *                方式占位；consuming 场景下是真调用。
+ * - "meta":      元 skill（如未来加入 doc-only 的 template-creator）。
+ *
+ * 下游消费方（如 ab-template-studio）按 category 自动挑选白名单，避免每加一个
+ * skill 就要改两侧 hardcode。
+ */
+export type SkillCategory = 'authoring' | 'consuming' | 'asset' | 'meta';
+export declare const CATEGORY_VALUES: readonly ["authoring", "consuming", "asset", "meta"];
 export interface RawSkillJson {
     name: string;
     toolName: string;
     description: string;
     title?: string;
     tier?: string;
+    category?: SkillCategory;
     parameters?: Record<string, unknown>;
     scriptPath?: string;
     entry?: SkillEntry;

package/dist/skill-schema.js

@@ -11,6 +11,7 @@
  * human-readable problems (empty = OK). The runtime loader skips + warns;
  * the build treats them as fatal.
  */
+export const CATEGORY_VALUES = ['authoring', 'consuming', 'asset', 'meta'];
 export const TIER_VALUES = ['atomic', 'orchestration', 'tool'];
 export const REQUIRED_SKILL_JSON_FIELDS = ['name', 'tier', 'title', 'description'];
 /**
@@ -39,6 +40,9 @@ export function validateSkillJson(raw, skillId) {
     if (raw.tier != null && !TIER_VALUES.includes(raw.tier)) {
         errors.push(`skill.json.tier must be one of ${TIER_VALUES.join(' | ')}, got '${raw.tier}'`);
     }
+    if (raw.category != null && !CATEGORY_VALUES.includes(raw.category)) {
+        errors.push(`skill.json.category must be one of ${CATEGORY_VALUES.join(' | ')}, got '${raw.category}'`);
+    }
     if (raw.name && raw.name !== skillId) {
         errors.push(`skill.json.name='${raw.name}' does not match directory name '${skillId}'`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "AI media generation skills for Claude Code / Codex — 11 skills covering image, video, voice, digital human, web capture, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",

package/skills/export-jianying/skill.json

@@ -2,6 +2,7 @@
   "name": "export-jianying",
   "toolName": "export_jianying",
   "tier": "orchestration",
+  "category": "consuming",
   "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"],

package/skills/gen-digital-human/skill.json

@@ -2,6 +2,7 @@
   "name": "gen-digital-human",
   "toolName": "gen_digital_human",
   "tier": "atomic",
+  "category": "asset",
   "title": "Digital-Human Talking-Head",
   "description": "Digital-human video: list available avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "AGENT_NAME"],

package/skills/gen-image/skill.json

@@ -2,6 +2,7 @@
   "name": "gen-image",
   "toolName": "gen_image",
   "tier": "atomic",
+  "category": "asset",
   "title": "AI Image Generation",
   "description": "AI image generation: produce an image from a text prompt. Supports Seedream and Gemini models, plus image-to-image with reference images.",
   "envVars": ["PRIV_TOKEN", "MM_API_BASE_URL", "AGENT_NAME", "MM_IMAGE_MODEL"],

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

@@ -1054,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,
@@ -1157,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,
@@ -1177,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.json

@@ -2,6 +2,7 @@
   "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"],

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/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"],

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-registry/scripts/list_templates.py

@@ -15,12 +15,18 @@ in-process by ``render-video``; it is intentionally NOT exposed as a CLI verb.
 
 Flags:
   --list-templates                 (accepted; listing is the only verb)
+  --list-examples                  list *.dsl.json / *.binding.json reference
+                                   examples grouped by templateId (consumed
+                                   by downstream agents that want to read a
+                                   template's reference shape before producing
+                                   new DSL)
   --filter-tag <substr>            keep templates whose styleTags match
   --filter-aspect <ratio>          keep templates supporting this aspect ratio
   --filter-language <zh|en|...>    keep templates tagged with this content lang
                                    (templates with no contentLanguage are kept)
   --include-beta                   also show beta templates (else stable-only)
-  --json-output                    emit {"templates": [...]} instead of a table
+  --json-output                    emit {"templates": [...]} or {"examples": [...]}
+                                   instead of a table
 """
 
 from __future__ import annotations
@@ -29,6 +35,7 @@ import argparse
 import json
 import os
 import sys
+from pathlib import Path
 
 # When run as `python3 <skillDir>/scripts/list_templates.py`, this script's own
 # directory is sys.path[0], so the sibling shared modules import directly.
@@ -61,17 +68,69 @@ def _status_of(tpl: dict) -> str:
     return "stable"
 
 
+# ----- Examples discovery (--list-examples) ---------------------------------
+#
+# Examples live under <SkillDir>/video_dsl/schema/examples/ as `*.dsl.json` and
+# `*.binding.json` files. Naming convention (per gen-script SKILL.md) is
+# `<templateId>.dsl.json` / `<templateId>.binding.json`, occasionally with
+# variant suffixes (`<templateId>.<variant>.dsl.json`).
+#
+# We do not parse the JSON content here (downstream agents read the raw files
+# they care about); we just enumerate paths so the agent doesn't have to guess
+# the directory layout. When the directory does not exist (e.g. inside a slim
+# package distribution), we return an empty list — non-fatal.
+
+# Resolve the examples directory relative to this script.
+#   <skill>/scripts/list_templates.py  →  <skill>/video_dsl/schema/examples/
+_EXAMPLES_DIR = Path(__file__).resolve().parent.parent / "video_dsl" / "schema" / "examples"
+
+
+def _collect_examples() -> list[dict]:
+    if not _EXAMPLES_DIR.is_dir():
+        return []
+    by_template: dict[str, dict] = {}
+    for entry in sorted(_EXAMPLES_DIR.iterdir()):
+        if not entry.is_file():
+            continue
+        name = entry.name
+        # Recognise *.dsl.json / *.binding.json
+        if name.endswith(".dsl.json"):
+            kind = "dsl"
+            base = name[: -len(".dsl.json")]
+        elif name.endswith(".binding.json"):
+            kind = "binding"
+            base = name[: -len(".binding.json")]
+        else:
+            continue
+        # Variant: 'foo.bar.dsl.json' → templateId='foo', variant='bar'
+        if "." in base:
+            template_id, variant = base.split(".", 1)
+        else:
+            template_id, variant = base, None
+        bucket = by_template.setdefault(template_id, {"templateId": template_id, "files": []})
+        bucket["files"].append({
+            "kind": kind,
+            "variant": variant,
+            "path": str(entry.relative_to(_EXAMPLES_DIR.parent.parent.parent)),  # relative to skill dir
+            "absolutePath": str(entry),
+            "sizeBytes": entry.stat().st_size,
+        })
+    return list(by_template.values())
+
+
 def main() -> None:
     ap = argparse.ArgumentParser(
         description="List available video templates from the registry.",
     )
     ap.add_argument("--list-templates", action="store_true",
                     help="List every available template (the only CLI verb).")
+    ap.add_argument("--list-examples", action="store_true",
+                    help="List reference examples (*.dsl.json / *.binding.json) grouped by templateId.")
     ap.add_argument("--filter-tag", help="Keep templates whose styleTags match this substring.")
     ap.add_argument("--filter-aspect", help="Keep templates supporting this aspect ratio (e.g. 9:16).")
     ap.add_argument("--filter-language", help="Keep templates tagged with this content language (zh|en|...).")
     ap.add_argument("--include-beta", action="store_true", help="Also show beta templates (default: stable only).")
-    ap.add_argument("--json-output", action="store_true", help='Emit {"templates": [...]} JSON instead of a table.')
+    ap.add_argument("--json-output", action="store_true", help='Emit JSON ({"templates":[...]} or {"examples":[...]}) instead of a table.')
     args = ap.parse_args()
 
     # --include-beta flips registry_loader's documented status gate via env, so
@@ -79,6 +138,32 @@ def main() -> None:
     if args.include_beta:
         os.environ["ENABLE_BETA_TEMPLATES"] = "1"
 
+    # ----- examples mode -----------------------------------------------------
+    if args.list_examples:
+        examples = _collect_examples()
+        if args.json_output:
+            print(json.dumps({"examples": examples}, ensure_ascii=False))
+            return
+        if not examples:
+            print(
+                f"⚠️  No examples found under {_EXAMPLES_DIR}.\n"
+                "   This package may have shipped without reference examples; "
+                "check the cli source repo or upgrade @remixmate/cli.",
+            )
+            return
+        print(f"\n{'Template ID':<28} Files")
+        print(f"{'-' * 28} {'-' * 60}")
+        for bucket in examples:
+            tid = str(bucket["templateId"])[:28].ljust(28)
+            files = bucket["files"]
+            for i, f in enumerate(files):
+                marker = tid if i == 0 else " " * 28
+                kind = f["kind"]
+                variant = f"@{f['variant']}" if f.get("variant") else ""
+                print(f"{marker} [{kind}{variant}] {f['path']} ({f['sizeBytes']}B)")
+        print(f"\n{sum(len(b['files']) for b in examples)} example file(s) across {len(examples)} template(s)")
+        return
+
     try:
         templates = load_visible_templates()
     except RuntimeError as exc:

package/skills/template-registry/skill.json

@@ -2,6 +2,7 @@
   "name": "template-registry",
   "toolName": "template_registry",
   "tier": "orchestration",
+  "category": "authoring",
   "title": "Video Template Registry",
   "description": "List all available video templates (templateId / name / aspect ratio / style tags). Template-to-DSL binding is no longer exposed as a separate step — once prepare_video_assets receives a template_id it runs the full DSL→RenderPlan pipeline internally.",
   "envVars": ["PRIV_TOKEN", "VIDEO_TEMPLATE_REGISTRY", "VIDEO_TEMPLATE_REGISTRY_URL", "VIDEO_TEMPLATE_REGISTRY_HTTP_METHOD"],
@@ -10,11 +11,12 @@
     "type": "object",
     "properties": {
       "list_templates": { "type": "boolean", "description": "List available templates (default behavior; also implied when other flags are passed)." },
+      "list_examples": { "type": "boolean", "description": "List the *.dsl.json / *.binding.json reference examples shipped under template-registry/video_dsl/schema/examples/, grouped by templateId. Useful for downstream agents (e.g. a creation agent) that want to read a template's reference shape before producing new DSL." },
       "filter_tag": { "type": "string", "description": "Show only templates whose styleTags contain (or are contained in) this string. Case-insensitive. E.g. 'tech' / '科普' / 'walkthrough'." },
       "filter_aspect": { "type": "string", "description": "Show only templates that declare this aspect ratio. E.g. '9:16' / '16:9' / '1:1'." },
       "filter_language": { "type": "string", "description": "Show only templates whose contentLanguage includes this code ('zh' or 'en'). Templates with no declared language are always shown (treated as language-agnostic)." },
       "include_beta": { "type": "boolean", "description": "Also list templates with status='beta'. Default off (only 'stable' shows). The ENABLE_BETA_TEMPLATES env var has the same effect process-wide." },
-      "json_output": { "type": "boolean", "description": "Emit a JSON result ({ templates: [...] }) instead of the human-readable table." }
+      "json_output": { "type": "boolean", "description": "Emit a JSON result ({ templates: [...] } or { examples: [...] }) instead of the human-readable table." }
     },
     "required": []
   }

package/skills/video-parser/skill.json

@@ -2,6 +2,7 @@
   "name": "video-parser",
   "toolName": "video_parser",
   "tier": "tool",
+  "category": "consuming",
   "title": "Video Deconstruction",
   "description": "Video deconstruction: split a video into reusable assets (audio extraction, ASR transcript, keyframe extraction, scene segmentation).",
   "envVars": ["RENDER_API_URL", "PRIV_TOKEN", "CONVERSATION_ID"],

package/skills/web-capture/skill.json

@@ -2,6 +2,7 @@
   "name": "web-capture",
   "toolName": "web_capture",
   "tier": "tool",
+  "category": "consuming",
   "title": "Web Page Capture",
   "description": "Drive a headless browser (Playwright Python) to capture any URL to local files: full-page / element / region screenshots, fixed-duration / condition-triggered / auto-scroll recordings, and storyboard videos (highlight / focus / zoom / scroll / virtual-cursor click / caption / title-card / arrow / numbered sequence / redact / code-line highlight). Two entry scripts: scripts/screenshot.py (stills) and scripts/record.py (webm video, storyboards, templates).",
   "envVars": ["WEB_CAPTURE_BROWSER", "WEB_CAPTURE_OUTPUT_BASE", "WEB_CAPTURE_NO_SANDBOX", "WEB_CAPTURE_ALLOW_PRIVATE_HOSTS", "PLAYWRIGHT_BROWSERS_PATH"],