skill-recommender

name	skill-recommender
description	Find, filter, cluster, and recommend similar OpenClaw skills by intent, function, or use case. Use when the user wants to find同类 skill、比较多个相近 skill、判断哪个 skill 更适合当前任务、给出技能推荐清单、避免重复开发、或梳理已有 skill 版图。

Skill Recommender

Use this skill to recommend the best matching skills from an existing skill collection.

Default workflow

1. Identify the user's target intent:
   • exact function
   • adjacent use case
   • duplicate/overlap check
   • best skill recommendation
2. Scan available skills from a given directory.
3. Match by:
   • name
   • description
   • keywords
   • domain words
4. Group similar skills into clusters when needed.
5. Return a ranked recommendation with reasons.

Use the bundled scripts

1. Recommend similar skills

Use scripts/recommend_skills.js when the user gives a query such as:

• “找同类 skill”
• “有没有类似的 skill”
• “这些 skill 哪个更适合”
• “帮我筛选同功能的 skills”

Example:

node scripts/recommend_skills.js '{
  "query": "家庭采购 库存 提醒",
  "skills_dir": "/Users/jianghaidong/.openclaw/workspace/skills",
  "limit": 8
}'

2. Cluster related skills

Use scripts/cluster_skills.js when the user wants a grouped view of similar skills, duplicates, or overlapping categories.

3. Avoid duplicate skill development

Use scripts/check_skill_dedup.js when the user is about to build a new skill and wants to know:

• whether similar skills already exist
• whether the request should reuse an existing skill
• whether it is better to extend or merge current skills instead of building a new one

Typical triggers:

• “这个 skill 会不会重复开发”
• “帮我查重一下 skill”
• “我想做一个新 skill，先看看有没有类似的”
• “这是不是应该复用现有 skill”

Output contract

Default output sections:

• 目标功能理解
• 推荐 skill
• 推荐理由
• 相近但次优 skill
• 可合并/避免重复开发的 skill
• 下一步建议

Recommendation rules

• Prefer concrete task fit over keyword overlap.
• Distinguish “direct match” from “adjacent match”.
• If several skills overlap heavily, say so explicitly.
• If a new skill request is already covered by existing skills, recommend reuse before new development.
• If confidence is low, surface the ambiguity.

Read references as needed

• Read references/recommendation-rules.md for ranking heuristics.
• Read references/output-schema.md for the output schema.
• Read references/dedup-mode.md when the user wants to avoid duplicate skill development.