AI PICKS / FIELD NOTES
Claude Code Skills 无法加载或触发？
检查目录、SKILL.md frontmatter、调用设置与运行环境，逐步定位 Claude Code Skills 无法使用的问题。
先看答案
先区分三个阶段：列表没有 Skill，检查安装与命名；已经出现却未调用，检查触发与调用设置；已启动却报错，检查工具或配套文件。先定位阶段，再修复。
列表中没有 Skill
确认 SKILL.md 位于目标 Skill 文件夹内，当前打开的是正确项目；核对安装范围、文件名大小写、frontmatter 语法，以及是否存在同名安装。以客户端实际发现规则为准。
能够看到，但没有触发
先在 Claude Code 中显式调用 /skill-name。若能运行，再检查 description 是否清楚描述适用条件，并提供具体任务。核对 disable-model-invocation 等调用控制；不要为了自动触发删除有意设置的限制。
/frontend-design Propose a layout and typography direction for this page. Explain your choices before implementation.示例命令或提示词；不是本页的实际运行记录。
已经启动，但工具或脚本报错
记录具体错误与失败命令，对照作者要求检查运行环境、配套文件、工作目录与相对路径。缺少依赖和权限被拒应分别处理，只授予任务所需权限。
输出没有遵循 Skill
在新会话中用明确的小任务验证，检查已加载说明。指令冲突、需求模糊或客户端不支持的特性都可能影响结果。先让 Agent 给出做法，再对照 Skill 原始说明。
如何整理有效的排障记录
记录客户端与版本、安装范围、来源链接、调用方式、预期行为和具体错误。分享前移除 token、环境文件中的值与私有项目内容。这些检查帮助定位问题，不保证所有第三方 Skill 都兼容。
来源与更新
2026-10-02：首版发布，核对来源与安装说明。执行前请查看来源的最新版本。