AgentSkillsCN

use-for

元技能：扫描所有 SKILL.md 前言描述，为用户提供最适合其当前任务或困境的技能建议。触发条件：“我该如何……？”、“有没有适合 X 的技能？”、“反复尝试却屡次失败”、“充满不确定性”。返回前三位匹配的技能，并附上名称与简要描述。大幅减少技能探索的负担。

SKILL.md
--- frontmatter
name: use-for
description: "Meta skill: Scans all SKILL.md frontmatter descriptions and suggests which skill helps with user's current task/struggle. Triggers: 'how do I...?', 'is there a skill for X?', repeated failed attempts, uncertainty. Returns top 3 matches with name + description. Reduces skill discovery overhead."
type: public
version: 1.0.0
status: stable
dependencies: []
author: nonlinear
license: MIT

use-for - Skill Suggester

Emoji: 🔍
Type: Meta skill (suggests other skills)

What it does

Scans all installed skills' use_for frontmatter and suggests which skill can help based on user's current struggle or question.

When to use

  • •User asks: "How do I...?" or "Is there a skill for...?"
  • •User struggling with task (multiple attempts, uncertainty)
  • •User wants to discover available skills

How it works

  1. •Read all SKILL.md files in ~/.openclaw/skills/ and ~/Documents/skills/
  2. •Extract use_for from frontmatter
  3. •Match user query/context against all use_for descriptions
  4. •Return top 3 matches with skill name + emoji + description

Example

User: "I need to track my workouts"

use-for response:

code
🔍 Skills that might help:

💪 **fitness-tracker** - Track Gymera workouts, log exercises, voice-guided sessions
🍎 **apple-reminders** - Create reminders for workout times, track habits
📊 **airtable-sync** - Store workout data in Airtable for analysis

Frontmatter spec

All skills should have use_for in frontmatter:

yaml
---
name: skill-name
emoji: 🎯
use_for: "Brief description of WHEN to use this skill. Include triggers, use cases, problems it solves."
---

Future

  • •Embedding-based similarity (intelligent matching)
  • •Proactive suggestions (heartbeat detects struggle)
  • •Usage analytics (suggest underutilized skills)