Trae Skill无法保存的主因是权限不足、技能包结构不合规或工作区未识别技能目录；需检查.trae/skills/技能名路径、SKILL.md文件命名与YAML格式、刷新工作区、禁用冲突插件，并通过开发者工具定位报错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Trae Skill无法保存，通常是因为文件系统权限不足、技能包结构不合规或Trae工作区未正确识别技能目录，导致SKILL.md文件被忽略或写入失败。
检查并修复Skill文件结构
确保你的Skill文件夹严格符合Trae要求的目录规范——这是保存失败最常被忽视的前提。
第一步：打开项目根目录，确认存在.trae/skills/你的技能名/路径（注意.trae是隐藏文件夹，需开启显示隐藏文件）。
第二步：进入技能文件夹，检查是否存在且仅存在一个名为【SKILL.md】的文件（必须全大写、无空格、无扩展名错误）。
第三步：用文本编辑器打开SKILL.md，确认文件开头有且仅有两个---包裹的YAML元数据块，且name字段为小写字母+连字符（如code-reviewer），description字段明确描述触发场景。
若使用全局技能路径，请核对Windows下是否为%USERPROFILE%\.traecli\skills\，Mac/Linux下是否为~/.traecli/skills/——路径错一位，Trae就完全无法扫描到该技能。
验证并重置Trae工作区状态
Trae不会实时监听.trae/skills目录变动，修改后必须手动刷新工作区才能生效。
方法一：关闭当前项目→点击左上角「文件」→「重新打开文件夹」→重新选择项目根目录。
方法二：在Trae命令面板（Ctrl+Shift+P / Cmd+Shift+P）中输入「Trae: Reload Window」并执行，强制重载整个编辑器环境。
这一步操作起来很简单，但跳过会导致你反复修改SKILL.md却始终看不到技能出现在技能列表里。
【注意：不要直接重启Trae主进程，而要用「Reload Window」——后者保留当前会话和未保存代码，前者会丢失所有临时状态。】
绕过插件冲突快速验证
某些第三方插件（尤其是文件系统监控类、AI增强类）会劫持写入操作，导致Skill保存静默失败。
方法1：启动Trae时添加--disable-extensions参数（Windows可在快捷方式目标末尾追加，Mac/Linux在终端执行trae --disable-extensions）。
方法2：进入设置→「扩展」→禁用所有非官方插件→重启Trae→尝试保存Skill。
若此时能成功，说明问题出在某个插件与Skill加载机制冲突，可逐个启用排查。
用开发者工具定位真实报错
Trae自身不弹窗提示Skill加载失败，但控制台会输出关键错误信息。
第一步：按Ctrl+Shift+I（Windows/Linux）或Cmd+Option+I（Mac）打开开发者工具。
第二步：切换到「Console」标签页，清空日志后，执行一次「重新加载窗口」操作。
第三步：查找包含skill、SKILL.md或parse关键字的红色报错行——常见如Error parsing YAML frontmatter in SKILL.md: invalid character，说明YAML格式有误；Failed to load skill from /path/to/skill: ENOENT则代表路径根本不存在。
看到具体报错后，直接对应修正即可，不必再凭经验猜测。
