huaweicloud-devkit 1.0.2-next.3 → 1.0.3-dev.0

package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/SKILL.md

@@ -1,190 +1,190 @@
----
-name: huawei-cloud-find-skills
-description: |
-  Invoke this skill to search, discover, browse, find and install any Huawei Cloud (华为云) agent skill.Triggers include: "华为云","华为云有什么skill","华为云相关skill","华为云agent skill 市场","华为云skill类目","explore Huawei Cloud skills","show Huawei Cloud skill categories","does a Huawei Cloud skill exist for...","which Huawei Cloud skills exist","搜索华为云技能","有没有管理ECS/OBS/RDS的skill","帮我找 XX 华为云skill","介绍 XX Skill 内容","华为云 XX Skill 具体做什么","安装华为云Skill".
----
-
-> [!IMPORTANT]
-> **For any Huawei Cloud query or management task:**
-> 1. **Search** — use this skill (`huawei-cloud-find-skills`) to find the relevant Skill.
-> 2. **Install** — install the matched Skill (see [Step 3](#step-3-install-skill)).
-> 3. **Execute** — follow the installed Skill's instructions to fulfill the request.
-
-# Huawei Cloud Agent Skills Search and Discovery
-
-This skill enables users to efficiently search, discover, and install Huawei Cloud skills.
-
-## Scenario Description
-
-This skill enables users to:
-
-- **Search Skills**: Find skills by keyword, category, or both (matched against name, description, and triggers)
-- **Browse Categories**: Explore available skill categories
-- **View Skill Details**: Fetch full SKILL.md content from GitHub for specific skills
-- **Install Skills**: Guide users through skill installation via `npx skills add` (GitCode default), `npx clawhub install`, or fallback GitHub method
-
-**Architecture**: GitCode API v5 (`index.json` + `cn-en-map.json`) → HTTP GET (base64 decode) → In-memory search → GitHub raw fetch for details → Install
-
-### Use Cases
-
-- "Find a skill for managing ECS instances"
-- "What Huawei Cloud skills are available for OBS?"
-- "华为云有哪些 VPC 相关的 skill?"
-- "Browse all available Huawei Cloud skills"
-- "Install a skill for RDS management"
-- "帮我找一个华为云网络相关的skill"
-
-## Prerequisites
-
-- **Node.js >= 20** must be installed
-- **Network access** to `gitcode.com` (API v5 for index) and `github.com` / `raw.githubusercontent.com` (for skill details)
-
-### Step 0: Check Python Environment
-
-> **MANDATORY**: Before running any script command, verify Python is available.
-
-```bash
-# Check Python availability
-python --version   # or: python3 --version
-```
-
-If the command fails or returns Python 2.x:
-
-1. **Install Python 3**: Download from [python.org](https://www.python.org/downloads/) or use a package manager:
-   ```bash
-   # macOS
-   brew install python3
-   # Ubuntu/Debian
-   sudo apt-get install python3
-   # Windows — download installer from python.org, check "Add Python to PATH"
-   ```
-2. **Verify after install**: Run `python --version` again to confirm Python 3.6+ is available
-3. **If `python` points to Python 2**: Use `python3` instead of `python` in all commands below
-
-## Repository Info
-
-```
-INDEX_REPO=2501_91318609/skills-for-index
-INDEX_BRANCH=main
-SKILLS_REPO=huaweicloud/huaweicloud-skills
-SKILLS_BRANCH=master
-RAW_BASE=https://raw.githubusercontent.com/$SKILLS_REPO/$SKILLS_BRANCH
-```
-
-## Index Source
-
-The search script fetches the skill index from GitCode API v5 via HTTP GET (base64 auto-decoded):
-
-```
-SKILLS_INDEX_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main
-SKILLS_CN_EN_MAP_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main
-```
-
-
-## Core Workflow
-
-### Step 1: Search Skills
-
-> **MANDATORY**: The agent MUST execute the search script to search the skill index. Do NOT read the JSON file directly — always use the script.
-
-Given `keyword` (from AI-understood user intent) and optional `category`, run the search script:
-
-```bash
-node scripts/search-skills.mjs <keyword>
-node scripts/search-skills.mjs <keyword> -c <category>
-node scripts/search-skills.mjs -c <category>
-```
-
-→ [scripts/search-skills.mjs](scripts/search-skills.mjs) (Node.js — cross-platform)
-
-**What the script does**:
-1. Fetches `index.json` and `cn-en-map.json` via HTTP GET from GitCode API v5 (auto-decodes base64 content)
-2. Expands keywords via `cn-en-map.json` (bidirectional CN↔EN, e.g., "ECS" → "ECS, 弹性云服务器, 云服务器")
-3. Scores each skill: name match **+10**, trigger match **+8**, description match **+5**, service match **+3**
-4. Sorts by score descending, outputs formatted results with matched keywords
-
-**Fallback iteration** (if no results): 1) Switch CN↔EN keywords 2) Expand keywords 3) Remove category filter 4) Try synonyms 5) List all skills
-
-The process should persist until the skill is found or its absence is confirmed. In the event of total failure, notify the user of the specific steps that were attempted.
-
-### Step 2: View Skill Details (optional)
-
-Fetch the full SKILL.md content from GitHub for intent validation. Skip this step if the search results from Step 1 are sufficiently informative.
-
-```bash
-# URL pattern — use the skill's category, service, and name from index
-DETAIL_URL="https://raw.githubusercontent.com/huaweicloud/huaweicloud-skills/master/skills/${category}/${service}/${name}/SKILL.md"
-```
-
-The agent can fetch this URL using `curl` or its web-fetch tool, then present the skill's full documentation to the user.
-
-### Step 3: Install Skill
-
-> **MANDATORY**: Use one of the commands below. Option A is the default; Option C is a fallback when Option A is unavailable.
-
-```bash
-# Option A: npx skills add from GitCode (default)
-npx skills add https://gitcode.com/huaweicloud/huaweicloud-skills.git#master --skill <skill-name> -y
-
-# Option B: npx clawhub install (OpenClaw ecosystem)
-npx clawhub install <skill-name> -y
-
-# Option C (fallback): npx skills add from GitHub
-npx skills add huaweicloud/huaweicloud-skills --skill <skill-name> -y
-```
-
-If all installation attempts fail, report the error message to the user. Do NOT attempt any method outside the commands above.
-
-## Parameters
-
-| Parameter | Required/Optional | Description | Default |
-|-----------|-------------------|-------------|---------|
-| `Keyword` | Optional | Search keyword (matched against name, description, triggers, service) | None |
-| `Category` | Optional | Category code for filtering (e.g., "computing", "storage", "network") | None |
-| `skill-name` | Required (Step 3) | Exact skill name for installing | None |
-
-
-## Reference Documentation
-
-| Document | Description |
-|----------|-------------|
-| GitCode API v5 `index.json` | Skill index fetched via HTTP GET (base64 decoded) |
-| GitCode API v5 `cn-en-map.json` | Chinese-English keyword mapping fetched via HTTP GET (base64 decoded) |
-| [scripts/search-skills.py](scripts/search-skills.py) | Search script (Python) — fetches from GitCode API v5, expands keywords, scores, sorts |
-
-## Search Heuristics
-
-> Optional reference for keyword-to-category hints. The agent can infer categories from `index.json` without these.
-
-- Cloud infrastructure keywords (ecs, bms, vpc, obs, rds, ...) → likely `computing`, `network`, `storage`, etc.
-- Tool keywords (cli, terraform, koo) → likely `devtools`
-- Management keywords (monitoring, alarm, log) → likely `monitoring`
-
-## Troubleshooting
-
-### Issue: Script fails with "Failed to fetch index.json"
-
-**Cause**: GitCode API v5 URL unreachable
-**Solution**: Verify network connectivity to `gitcode.com`
-
-### Issue: GitCode API v5 returns 404
-
-**Cause**: File path incorrect or default branch is not `main`
-**Solution**: Verify the skill's `category`, `service`, and `name` from search results
-
-### Issue: Search returns no results
-
-**Cause**: Keywords don't match any skill
-**Solution**:
-1. Try broader keywords
-2. Switch between Chinese and English keywords (e.g., "对象存储" → "obs")
-3. List all skills: `python scripts/search-skills.py -c "computing"`
-
-## Notes
-
-- This skill is **read-only** and does not create any cloud resources
-- **No cache management needed** — index is fetched fresh from GitCode API v5 each run
-- **Network required** — index data is hosted on GitCode, fetched via HTTP GET (base64 decoded)
-- **MUST use script to search** — do not read index.json directly
-- Index repo: `https://gitcode.com/2501_91318609/skills-for-index` (branch: `main`)
-- Skills repo: `https://github.com/huaweicloud/huaweicloud-skills` (branch: `master`)
+---
+name: huawei-cloud-find-skills
+description: |
+  Invoke this skill to search, discover, browse, find and install any Huawei Cloud (华为云) agent skill.Triggers include: "华为云","华为云有什么skill","华为云相关skill","华为云agent skill 市场","华为云skill类目","explore Huawei Cloud skills","show Huawei Cloud skill categories","does a Huawei Cloud skill exist for...","which Huawei Cloud skills exist","搜索华为云技能","有没有管理ECS/OBS/RDS的skill","帮我找 XX 华为云skill","介绍 XX Skill 内容","华为云 XX Skill 具体做什么","安装华为云Skill".
+---
+
+> [!IMPORTANT]
+> **For any Huawei Cloud query or management task:**
+> 1. **Search** — use this skill (`huawei-cloud-find-skills`) to find the relevant Skill.
+> 2. **Install** — install the matched Skill (see [Step 3](#step-3-install-skill)).
+> 3. **Execute** — follow the installed Skill's instructions to fulfill the request.
+
+# Huawei Cloud Agent Skills Search and Discovery
+
+This skill enables users to efficiently search, discover, and install Huawei Cloud skills.
+
+## Scenario Description
+
+This skill enables users to:
+
+- **Search Skills**: Find skills by keyword, category, or both (matched against name, description, and triggers)
+- **Browse Categories**: Explore available skill categories
+- **View Skill Details**: Fetch full SKILL.md content from GitHub for specific skills
+- **Install Skills**: Guide users through skill installation via `npx skills add` (GitCode default), `npx clawhub install`, or fallback GitHub method
+
+**Architecture**: GitCode API v5 (`index.json` + `cn-en-map.json`) → HTTP GET (base64 decode) → In-memory search → GitHub raw fetch for details → Install
+
+### Use Cases
+
+- "Find a skill for managing ECS instances"
+- "What Huawei Cloud skills are available for OBS?"
+- "华为云有哪些 VPC 相关的 skill?"
+- "Browse all available Huawei Cloud skills"
+- "Install a skill for RDS management"
+- "帮我找一个华为云网络相关的skill"
+
+## Prerequisites
+
+- **Node.js >= 20** must be installed
+- **Network access** to `gitcode.com` (API v5 for index) and `github.com` / `raw.githubusercontent.com` (for skill details)
+
+### Step 0: Check Python Environment
+
+> **MANDATORY**: Before running any script command, verify Python is available.
+
+```bash
+# Check Python availability
+python --version   # or: python3 --version
+```
+
+If the command fails or returns Python 2.x:
+
+1. **Install Python 3**: Download from [python.org](https://www.python.org/downloads/) or use a package manager:
+   ```bash
+   # macOS
+   brew install python3
+   # Ubuntu/Debian
+   sudo apt-get install python3
+   # Windows — download installer from python.org, check "Add Python to PATH"
+   ```
+2. **Verify after install**: Run `python --version` again to confirm Python 3.6+ is available
+3. **If `python` points to Python 2**: Use `python3` instead of `python` in all commands below
+
+## Repository Info
+
+```
+INDEX_REPO=2501_91318609/skills-for-index
+INDEX_BRANCH=main
+SKILLS_REPO=huaweicloud/huaweicloud-skills
+SKILLS_BRANCH=master
+RAW_BASE=https://raw.githubusercontent.com/$SKILLS_REPO/$SKILLS_BRANCH
+```
+
+## Index Source
+
+The search script fetches the skill index from GitCode API v5 via HTTP GET (base64 auto-decoded):
+
+```
+SKILLS_INDEX_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main
+SKILLS_CN_EN_MAP_URL=https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main
+```
+
+
+## Core Workflow
+
+### Step 1: Search Skills
+
+> **MANDATORY**: The agent MUST execute the search script to search the skill index. Do NOT read the JSON file directly — always use the script.
+
+Given `keyword` (from AI-understood user intent) and optional `category`, run the search script:
+
+```bash
+node scripts/search-skills.mjs <keyword>
+node scripts/search-skills.mjs <keyword> -c <category>
+node scripts/search-skills.mjs -c <category>
+```
+
+→ [scripts/search-skills.mjs](scripts/search-skills.mjs) (Node.js — cross-platform)
+
+**What the script does**:
+1. Fetches `index.json` and `cn-en-map.json` via HTTP GET from GitCode API v5 (auto-decodes base64 content)
+2. Expands keywords via `cn-en-map.json` (bidirectional CN↔EN, e.g., "ECS" → "ECS, 弹性云服务器, 云服务器")
+3. Scores each skill: name match **+10**, trigger match **+8**, description match **+5**, service match **+3**
+4. Sorts by score descending, outputs formatted results with matched keywords
+
+**Fallback iteration** (if no results): 1) Switch CN↔EN keywords 2) Expand keywords 3) Remove category filter 4) Try synonyms 5) List all skills
+
+The process should persist until the skill is found or its absence is confirmed. In the event of total failure, notify the user of the specific steps that were attempted.
+
+### Step 2: View Skill Details (optional)
+
+Fetch the full SKILL.md content from GitHub for intent validation. Skip this step if the search results from Step 1 are sufficiently informative.
+
+```bash
+# URL pattern — use the skill's category, service, and name from index
+DETAIL_URL="https://raw.githubusercontent.com/huaweicloud/huaweicloud-skills/master/skills/${category}/${service}/${name}/SKILL.md"
+```
+
+The agent can fetch this URL using `curl` or its web-fetch tool, then present the skill's full documentation to the user.
+
+### Step 3: Install Skill
+
+> **MANDATORY**: Use one of the commands below. Option A is the default; Option C is a fallback when Option A is unavailable.
+
+```bash
+# Option A: npx skills add from GitCode (default)
+npx skills add https://gitcode.com/huaweicloud/huaweicloud-skills.git#master --skill <skill-name> -y
+
+# Option B: npx clawhub install (OpenClaw ecosystem)
+npx clawhub install <skill-name> -y
+
+# Option C (fallback): npx skills add from GitHub
+npx skills add huaweicloud/huaweicloud-skills --skill <skill-name> -y
+```
+
+If all installation attempts fail, report the error message to the user. Do NOT attempt any method outside the commands above.
+
+## Parameters
+
+| Parameter | Required/Optional | Description | Default |
+|-----------|-------------------|-------------|---------|
+| `Keyword` | Optional | Search keyword (matched against name, description, triggers, service) | None |
+| `Category` | Optional | Category code for filtering (e.g., "computing", "storage", "network") | None |
+| `skill-name` | Required (Step 3) | Exact skill name for installing | None |
+
+
+## Reference Documentation
+
+| Document | Description |
+|----------|-------------|
+| GitCode API v5 `index.json` | Skill index fetched via HTTP GET (base64 decoded) |
+| GitCode API v5 `cn-en-map.json` | Chinese-English keyword mapping fetched via HTTP GET (base64 decoded) |
+| [scripts/search-skills.py](scripts/search-skills.py) | Search script (Python) — fetches from GitCode API v5, expands keywords, scores, sorts |
+
+## Search Heuristics
+
+> Optional reference for keyword-to-category hints. The agent can infer categories from `index.json` without these.
+
+- Cloud infrastructure keywords (ecs, bms, vpc, obs, rds, ...) → likely `computing`, `network`, `storage`, etc.
+- Tool keywords (cli, terraform, koo) → likely `devtools`
+- Management keywords (monitoring, alarm, log) → likely `monitoring`
+
+## Troubleshooting
+
+### Issue: Script fails with "Failed to fetch index.json"
+
+**Cause**: GitCode API v5 URL unreachable
+**Solution**: Verify network connectivity to `gitcode.com`
+
+### Issue: GitCode API v5 returns 404
+
+**Cause**: File path incorrect or default branch is not `main`
+**Solution**: Verify the skill's `category`, `service`, and `name` from search results
+
+### Issue: Search returns no results
+
+**Cause**: Keywords don't match any skill
+**Solution**:
+1. Try broader keywords
+2. Switch between Chinese and English keywords (e.g., "对象存储" → "obs")
+3. List all skills: `python scripts/search-skills.py -c "computing"`
+
+## Notes
+
+- This skill is **read-only** and does not create any cloud resources
+- **No cache management needed** — index is fetched fresh from GitCode API v5 each run
+- **Network required** — index data is hosted on GitCode, fetched via HTTP GET (base64 decoded)
+- **MUST use script to search** — do not read index.json directly
+- Index repo: `https://gitcode.com/2501_91318609/skills-for-index` (branch: `main`)
+- Skills repo: `https://github.com/huaweicloud/huaweicloud-skills` (branch: `master`)

package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/scripts/search-skills.mjs

@@ -1,124 +1,124 @@
-#!/usr/bin/env node
-import { Buffer } from 'node:buffer';
-
-const INDEX_URL = 'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main';
-const CN_EN_MAP_URL = 'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main';
-
-const GENERIC_KEYWORDS = new Set([
-  '华为云', 'huawei', 'huawei cloud', '云', 'cloud', '技能', 'skill', 'skills',
-  '所有', 'all', '全部', '有什么', '有哪些', '相关', '列表', 'list',
-  '查找', '搜索', '发现', '浏览', 'find', 'search', 'discover', 'browse',
-  'show', 'explore', 'agent', '市场', 'market', '类目', 'category', '安装', 'install',
-]);
-
-async function fetchJson(url, label) {
-  const resp = await fetch(url, { headers: { 'User-Agent': 'huaweicloud-devkit/1.0' } });
-  const data = await resp.json();
-  if (data?.encoding === 'base64' && data.content) {
-    return JSON.parse(Buffer.from(data.content, 'base64').toString('utf8'));
-  }
-  return data;
-}
-
-function isGeneric(kw) {
-  const k = kw.toLowerCase().trim();
-  return GENERIC_KEYWORDS.has(k) || /华为云|huawei/i.test(k);
-}
-
-function expandKeywords(raw, cnEnMap) {
-  if (!raw) return [[], []];
-  const parts = raw.replace(/[,;]/g, ' ').split(/\s+/).filter(Boolean);
-  const expanded = [...parts];
-  for (const p of parts) {
-    const lower = p.toLowerCase();
-    if (cnEnMap[p]) expanded.push(cnEnMap[p]);
-    for (const [cn, en] of Object.entries(cnEnMap)) {
-      if (en === lower) expanded.push(cn);
-    }
-  }
-  const unique = [...new Set(expanded)].sort();
-  return [unique.filter((kw) => !isGeneric(kw)), unique.filter((kw) => isGeneric(kw))];
-}
-
-function scoreSkill(skill, specificKws, genericKws) {
-  if (!specificKws.length && !genericKws.length) return [1, []];
-  let total = 0;
-  const matched = [];
-  const nl = (skill.name || '').toLowerCase();
-  const dl = (skill.description || '').toLowerCase();
-  const sl = (skill.service || '').toLowerCase();
-  const tl = (skill.triggers || []).map((t) => (t || '').toLowerCase());
-
-  for (const kw of specificKws) {
-    const k = kw.toLowerCase();
-    let s = 0;
-    if (nl.includes(k)) s += 10;
-    else if (tl.some((t) => t.includes(k))) s += 8;
-    else if (dl.includes(k)) s += 5;
-    else if (sl.includes(k)) s += 3;
-    if (s > 0) { total += s; matched.push(kw); }
-  }
-  for (const kw of genericKws) {
-    const k = kw.toLowerCase();
-    let s = 0;
-    if (nl.includes(k)) s += 10;
-    else if (tl.some((t) => t.includes(k))) s += 4;
-    else if (dl.includes(k)) s += 2;
-    else if (sl.includes(k)) s += 1;
-    if (s > 0) { total += s; matched.push(kw); }
-  }
-  if (!specificKws.length && total === 0) {
-    total = 1;
-    if (dl.length > 20) total += 1;
-    if (tl.length) total += 1;
-  }
-  return [total, matched];
-}
-
-async function main() {
-  const keyword = process.argv.slice(2).filter((a) => !a.startsWith('-')).join(' ') || '';
-  const catIdx = process.argv.indexOf('-c');
-  const category = catIdx >= 0 ? process.argv[catIdx + 1] || '' : '';
-
-  try {
-    const [idx, cnEnMap] = await Promise.all([
-      fetchJson(INDEX_URL, 'index'),
-      fetchJson(CN_EN_MAP_URL, 'cn-en-map'),
-    ]);
-
-    if (!keyword && !category) {
-      console.log(`Categories: ${(idx.categories || []).join(', ')}`);
-      console.log('Usage: node search-skills.mjs <keyword> [-c <category>]');
-      return;
-    }
-
-    const [specificKws, genericKws] = expandKeywords(keyword, cnEnMap);
-    const hasSpecific = specificKws.length > 0;
-
-    const results = [];
-    for (const skill of idx.skills || []) {
-      if (category && skill.category !== category) continue;
-      const [score, matched] = scoreSkill(skill, specificKws, genericKws);
-      if (hasSpecific && score === 0) continue;
-      const desc = (skill.description || '').slice(0, 150);
-      results.push({ score, name: skill.name, category: skill.category, service: skill.service, description: desc + (skill.description?.length > 150 ? '...' : ''), triggers: (skill.triggers || []).slice(0, 5), matched });
-    }
-    results.sort((a, b) => b.score - a.score);
-
-    if (!results.length) {
-      console.log(`No results. Try broader keywords, remove category filter, or switch CN↔EN.`);
-      return;
-    }
-
-    console.log(`Found ${results.length} skill(s):`);
-    for (const r of results) {
-      console.log(`  [${r.score}pts] ${r.name} (${r.category}/${r.service})${r.matched.length ? ' matched: ' + r.matched.join(',') : ''}`);
-      console.log(`    ${r.description}`);
-    }
-  } catch (e) {
-    console.error(`Error: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-main();
+#!/usr/bin/env node
+import { Buffer } from 'node:buffer';
+
+const INDEX_URL = 'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/index.json?ref=main';
+const CN_EN_MAP_URL = 'https://gitcode.com/api/v5/repos/2501_91318609/skills-for-index/contents/skills-index/cn-en-map.json?ref=main';
+
+const GENERIC_KEYWORDS = new Set([
+  '华为云', 'huawei', 'huawei cloud', '云', 'cloud', '技能', 'skill', 'skills',
+  '所有', 'all', '全部', '有什么', '有哪些', '相关', '列表', 'list',
+  '查找', '搜索', '发现', '浏览', 'find', 'search', 'discover', 'browse',
+  'show', 'explore', 'agent', '市场', 'market', '类目', 'category', '安装', 'install',
+]);
+
+async function fetchJson(url, label) {
+  const resp = await fetch(url, { headers: { 'User-Agent': 'huaweicloud-devkit/1.0' } });
+  const data = await resp.json();
+  if (data?.encoding === 'base64' && data.content) {
+    return JSON.parse(Buffer.from(data.content, 'base64').toString('utf8'));
+  }
+  return data;
+}
+
+function isGeneric(kw) {
+  const k = kw.toLowerCase().trim();
+  return GENERIC_KEYWORDS.has(k) || /华为云|huawei/i.test(k);
+}
+
+function expandKeywords(raw, cnEnMap) {
+  if (!raw) return [[], []];
+  const parts = raw.replace(/[,;]/g, ' ').split(/\s+/).filter(Boolean);
+  const expanded = [...parts];
+  for (const p of parts) {
+    const lower = p.toLowerCase();
+    if (cnEnMap[p]) expanded.push(cnEnMap[p]);
+    for (const [cn, en] of Object.entries(cnEnMap)) {
+      if (en === lower) expanded.push(cn);
+    }
+  }
+  const unique = [...new Set(expanded)].sort();
+  return [unique.filter((kw) => !isGeneric(kw)), unique.filter((kw) => isGeneric(kw))];
+}
+
+function scoreSkill(skill, specificKws, genericKws) {
+  if (!specificKws.length && !genericKws.length) return [1, []];
+  let total = 0;
+  const matched = [];
+  const nl = (skill.name || '').toLowerCase();
+  const dl = (skill.description || '').toLowerCase();
+  const sl = (skill.service || '').toLowerCase();
+  const tl = (skill.triggers || []).map((t) => (t || '').toLowerCase());
+
+  for (const kw of specificKws) {
+    const k = kw.toLowerCase();
+    let s = 0;
+    if (nl.includes(k)) s += 10;
+    else if (tl.some((t) => t.includes(k))) s += 8;
+    else if (dl.includes(k)) s += 5;
+    else if (sl.includes(k)) s += 3;
+    if (s > 0) { total += s; matched.push(kw); }
+  }
+  for (const kw of genericKws) {
+    const k = kw.toLowerCase();
+    let s = 0;
+    if (nl.includes(k)) s += 10;
+    else if (tl.some((t) => t.includes(k))) s += 4;
+    else if (dl.includes(k)) s += 2;
+    else if (sl.includes(k)) s += 1;
+    if (s > 0) { total += s; matched.push(kw); }
+  }
+  if (!specificKws.length && total === 0) {
+    total = 1;
+    if (dl.length > 20) total += 1;
+    if (tl.length) total += 1;
+  }
+  return [total, matched];
+}
+
+async function main() {
+  const keyword = process.argv.slice(2).filter((a) => !a.startsWith('-')).join(' ') || '';
+  const catIdx = process.argv.indexOf('-c');
+  const category = catIdx >= 0 ? process.argv[catIdx + 1] || '' : '';
+
+  try {
+    const [idx, cnEnMap] = await Promise.all([
+      fetchJson(INDEX_URL, 'index'),
+      fetchJson(CN_EN_MAP_URL, 'cn-en-map'),
+    ]);
+
+    if (!keyword && !category) {
+      console.log(`Categories: ${(idx.categories || []).join(', ')}`);
+      console.log('Usage: node search-skills.mjs <keyword> [-c <category>]');
+      return;
+    }
+
+    const [specificKws, genericKws] = expandKeywords(keyword, cnEnMap);
+    const hasSpecific = specificKws.length > 0;
+
+    const results = [];
+    for (const skill of idx.skills || []) {
+      if (category && skill.category !== category) continue;
+      const [score, matched] = scoreSkill(skill, specificKws, genericKws);
+      if (hasSpecific && score === 0) continue;
+      const desc = (skill.description || '').slice(0, 150);
+      results.push({ score, name: skill.name, category: skill.category, service: skill.service, description: desc + (skill.description?.length > 150 ? '...' : ''), triggers: (skill.triggers || []).slice(0, 5), matched });
+    }
+    results.sort((a, b) => b.score - a.score);
+
+    if (!results.length) {
+      console.log(`No results. Try broader keywords, remove category filter, or switch CN↔EN.`);
+      return;
+    }
+
+    console.log(`Found ${results.length} skill(s):`);
+    for (const r of results) {
+      console.log(`  [${r.score}pts] ${r.name} (${r.category}/${r.service})${r.matched.length ? ' matched: ' + r.matched.join(',') : ''}`);
+      console.log(`    ${r.description}`);
+    }
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main();