trae skill创建失败是因为文件未被正确识别。需检查：①路径是否为.trae/skills/且显示隐藏文件；②技能文件夹是否直置于该路径下；③文件夹内是否有且仅有命名正确的skill.md；④该文件需用英文标点、以#开头、无非法语法，并重启trae重扫描。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Trae Skill创建失败时，你无法在对话中调用该技能，AI对“使用XXX技能”的指令毫无反应，甚至根本不在技能列表里显示——这通常不是模型问题，而是文件没被正确识别。
检查文件路径是否合规
第一步：打开你的项目根目录，确认是否存在 【.trae/skills/】 这个完整路径。注意点：.trae 是隐藏文件夹，Windows 资源管理器默认不显示，需在「查看」→「显示」→勾选「隐藏的项目」；macOS/Linux 可直接在终端用 ls -a 查看。
第二步：进入 .trae/skills/ 后，必须是技能文件夹直接放在这一层，不能嵌套在子文件夹里。比如 skill-reviewer/ 是合法的，但 .trae/skills/myproject/skill-reviewer/ 就无效。
第三步：每个技能必须是一个独立文件夹，且文件夹内必须有且仅有 1 个名为 【SKILL.md】 的文件（全大写、无空格、无后缀拼写错误，如 skill.md 或 SKILL.MD 都不行）。
验证 SKILL.md 内容是否可解析
方法一：用纯文本编辑器打开 SKILL.md，删掉所有中文标点（如「」、『』、——、…），只保留英文标点和换行。Trae 解析器对 UTF-8 BOM 和某些全角符号极其敏感，哪怕开头有个看不见的零宽空格也会导致整个文件加载失败。
方法二：确保文件以 # 开头定义角色或标题，例如 # 代码审查员 或 # 角色。空文件、只有描述没有结构标识、或第一行是空行+第二行才写内容，都会让 Trae 认为这不是有效 Skill 定义。
方法三：临时删掉所有 YAML 块（--- 开头的配置段）、HTML 标签、代码块（``` 包裹的内容）。这些非 Markdown 原生语法在当前版本中尚未被 Skill 解析器支持，会直接中断加载流程。
重启 Trae 并触发重扫描
关闭 Trae 全部窗口（包括后台进程），重新启动 IDE。Trae 只在启动时扫描 .trae/skills/ 目录，运行中新增或修改文件不会自动热加载。
启动后，立即打开设置 → 规则和技能 → 技能 页面，观察右上角技能总数是否增加。如果数字没变，说明刚才的文件仍未被识别；如果数字变了但技能名显示为 “未命名”，说明 SKILL.md 的 # 标题行缺失或格式异常。
此时不要点击“刷新”按钮——该按钮仅刷新 UI 缓存，不触发文件系统重读。唯一有效动作就是彻底退出再重进。
