技能名称必须与目录名严格一致，仅含小写字母、数字和单连字符，且需匹配skill.md中name字段；推荐用动宾短语+领域限定词（如send-feishu-message），禁用泛义词与缩写，长度控制在3～5词内。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
给AionClaw Skills取名时，若名称与目录名不一致、含大写字母或特殊符号，OpenClaw内核将直接跳过加载，导致技能在对话中完全不可见——这不是报错问题，而是静默忽略。
名称必须与目录名严格一致
进入技能根目录后，先确认当前文件夹名：pwd 输出末尾路径即为强制要求的 name 值。例如路径是 ~/.openclaw/workspace/skills/get-stock-price，则 SKILL.md 中的 name: 字段只能写 get-stock-price，多一个空格、换一个大小写都会失效。
这一步不可跳过，因为 OpenClaw 启动时只扫描 skills/ 下的子目录名，再反向匹配对应目录内的 SKILL.md → name 字段。两者不一致，整个技能包被当作无效结构丢弃。
命名要能一眼看出功能和边界
方法一：用动宾短语+领域限定词
比如处理飞书消息的技能，不要叫 feishu-tool，而应叫 send-feishu-message；如果是读取本地 Excel 并生成摘要，则命名为 summarize-excel-file。动词开头明确行为，名词结尾锁定输入类型，中间用连字符分隔，无歧义。
方法二：避免泛义词和缩写
【不要用 report、tool、util、helper 这类词】 它们无法触发意图识别——Agent 在解析用户请求时，靠关键词匹配 description 和 name 字段，而 report 可指报表、汇报、故障报告，模型无法确定上下文。同样，xl-reader 不如 read-excel-by-path 明确。
方法三：长度控制在 3～5 个单词内
太长如 automatically-fetch-and-parse-daily-stock-data-from-sse-and-convert-to-json 超出64字符限制，且难以记忆；太短如 stock 则无法区分是查价格、画K线还是导出CSV。推荐结构：动词 + 核心对象 + （可选）限定条件，例如 fetch-crypto-price-by-symbol。
验证名称是否合规的三步检查
第一步：确认目录名只含小写字母、数字、单连字符，不以 - 开头或结尾，无连续 --
第二步：打开 SKILL.md，检查 YAML frontmatter 中的 name 字段是否与目录名逐字符相同
第三步：运行 openclaw list-skills（或在 AionClaw 客户端「技能市场」刷新），观察该技能是否出现在列表中。未出现即说明前两步至少有一处不匹配。
