@unityclaw/skills 1.0.8 → 1.0.9

package/README.md

@@ -125,6 +125,13 @@ Only endpoints that **require** field-feishu structures are normalized.
 - Endpoints that already support plain strings are kept as-is (no forced conversion).
 - If you pass full field-feishu structures, SDK keeps them unchanged.
 
+## Skill Version Rule
+
+- Every `unityclaw-*/SKILL.md` frontmatter `version` is auto-synced to `skills/package.json` version during `npm run build`.
+- Every `SKILL.md` also contains an `SDK Version Check Rule` block:
+  - If local `@unityclaw/sdk` version is lower than the skill version, agent should stop and prompt SDK upgrade first.
+  - Suggested command: `npm i @unityclaw/sdk@latest`.
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unityclaw/skills",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "UnityClaw Skills - Claude Code and OpenClaw skill definitions for AI-powered image/video generation, media analysis, and more",
   "type": "module",
   "bin": {
@@ -19,7 +19,8 @@
     "unityclaw-*/SKILL.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
+    "sync:skill-metadata": "node scripts/sync-skill-metadata.mjs",
+    "build": "npm run sync:skill-metadata && tsup src/index.ts src/cli.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts src/cli.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"

package/unityclaw-document-convert/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-document-convert
 description: Convert documents between formats (PDF, Word, PPT, Excel, Image)
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -413,3 +413,12 @@ console.log('Downloaded Files:', result.attachments);
 
 - [unityclaw-document-translation](../unityclaw-document-translation/SKILL.md) - Translate documents
 - [unityclaw-image-compress](../unityclaw-image-compress/SKILL.md) - Compress images before conversion
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-document-translation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-document-translation
 description: Translate documents between multiple languages while preserving formatting
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -307,3 +307,12 @@ console.log('Downloaded Files:', result.attachments);
 
 - [unityclaw-document-convert](../unityclaw-document-convert/SKILL.md) - Convert document formats
 - [unityclaw-media-analysis](../unityclaw-media-analysis/SKILL.md) - Analyze video/audio content
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-idp-business-extraction/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-idp-business-extraction
 description: Extract fields from business documents (business license, business card)
-version: 1.0.0
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -52,3 +52,12 @@ await client.idp.extract('business_license', {
 
 - This skill groups enterprise scenarios to avoid over-generic routing.
 - Output fields vary between license and card extraction.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-idp-contract-extraction/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-idp-contract-extraction
 description: Extract structured fields from contract files
-version: 1.0.0
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -52,3 +52,12 @@ await client.idp.extract('contract', {
 
 - Preferred for long contract OCR + key field extraction scenarios.
 - Read extracted data from `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-idp-invoice-extraction/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-idp-invoice-extraction
 description: Extract fields from invoice and ticket documents (VAT, train, taxi)
-version: 1.0.0
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -54,3 +54,12 @@ await client.idp.extract('vat_invoice', {
 
 - Files can be image/PDF according to each underlying IDP type.
 - Output schema differs by type; parse from `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-idp-personal-documents/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-idp-personal-documents
 description: Extract structured fields from personal identity documents (ID card, vehicle license, bank card)
-version: 1.0.0
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -58,3 +58,12 @@ await client.idp.extract('id_card', {
 
 - This category is split from invoice/business/contract to improve skill routing success.
 - Output fields vary by type; read from `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-image-compress/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-image-compress
 description: Compress images with quality control to reduce file size
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -263,3 +263,12 @@ console.log('Local Attachments:', result.attachments);
 ## Related Skills
 
 - [unityclaw-image-generation](../unityclaw-image-generation/SKILL.md) - Generate images before compression
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-image-generation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-image-generation
 description: Generate high-quality images using Gemini or JiMeng (Doubao) models
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -302,3 +302,12 @@ console.log('Task Folder:', result.taskFolder); // e.g., "~/Documents/tasks/2026
 
 - [unityclaw-image-compress](../unityclaw-image-compress/SKILL.md) - Compress generated images
 - [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Generate videos
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-analysis/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-analysis
 description: Analyze video and audio content to extract subtitles, summaries, and insights
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -347,3 +347,12 @@ console.log('Task Folder:', result.taskFolder);
 
 - [unityclaw-document-translation](../unityclaw-document-translation/SKILL.md) - Translate transcripts
 - [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Generate videos
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-download-xhs/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-download-xhs
 description: Download Xiaohongshu media and return cover/video URLs
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -38,3 +38,12 @@ if (result.success && result.response?.data) {
 
 - API: `/api/xiaohongshu/download`
 - field-feishu: `xiaohongshu/download`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-stats/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-stats
 description: Extract social media post metrics (play, like, comment, share, etc.) from links
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -38,3 +38,12 @@ if (result.success && result.response?.data) {
 
 - API: `/api/media_stats`
 - field-feishu: `media_stats`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-media-user-info/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-user-info
 description: Extract social media user profile metrics from homepage links
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -38,3 +38,12 @@ if (result.success && result.response?.data) {
 
 - API: `/api/media_user_info`
 - field-feishu: `media_user_info`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-frame-extract/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-frame-extract
 description: Extract first/last/specified-time frame from video attachments
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -39,3 +39,12 @@ if (result.success && result.response?.data?.[0]) {
 
 - API: `/api/video/frame`
 - field-feishu: `video/frame`
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-jimeng-doubao/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-jimeng-doubao
 description: Generate videos with JiMeng or Doubao models (text-to-video and image-to-video)
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -68,3 +68,12 @@ SDK will auto-upload local files and fill `tmp_url`.
 - For JiMeng, ensure `action` and `aspect_ratio` are provided.
 - For Doubao, prefer numeric duration values (`5`, `10`) instead of string duration.
 - Always check `result.success` first, then read `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-kling/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-kling
 description: Generate AI videos using Kling model with multi-version support
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -266,3 +266,12 @@ console.log('Downloaded Videos:', result.attachments);
 
 - [unityclaw-video-generation-jimeng-doubao](../unityclaw-video-generation-jimeng-doubao/SKILL.md) - JiMeng and Doubao video models
 - [unityclaw-video-generation-wan-minimax](../unityclaw-video-generation-wan-minimax/SKILL.md) - Wan and MiniMax video models
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-generation-wan-minimax/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-wan-minimax
 description: Generate videos with Wan and MiniMax models for cinematic or controllable workflows
-version: 1.0.1
+version: 1.0.9
 metadata:
   openclaw:
     requires:
@@ -68,3 +68,12 @@ SDK will auto-upload local files and fill `tmp_url`.
 - If model family is not specified, default to Wan for cinematic control.
 - Keep prompt concise and explicit; avoid overlong instructions.
 - Always check `result.success` first, then read `result.response.data`.
+
+<!-- SDK_VERSION_RULE_START -->
+## SDK Version Check Rule
+
+- Before invoking this skill, check local `@unityclaw/sdk` version.
+- Required minimum SDK version: `1.0.9`
+- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
+- Suggested command: `npm i @unityclaw/sdk@latest`
+<!-- SDK_VERSION_RULE_END -->