先确定是哪种会话找不到命令
本机终端、另一个仓库、云端会话和插件中的Skill，来源和可见范围可能不同。先记录客户端、工作目录、Skill来源及期望输入的命令名，不因为本机有文件就推断云端也能找到。
本篇针对Claude Code自定义命令加载问题，不讨论Claude网页Projects与Skills的整体选择，也不在生产仓库创建或运行部署任务。
从一个最小Skill开始
在独立练习仓库放置.claude/skills/review-note/SKILL.md。文末提供文本样例：命名为review-note，只根据给定材料列缺失信息，不写文件、不调用外部工具。
先核对文件名确为SKILL.md而不是SKILL.md.txt，前置YAML分隔符位于第一行，name字段与预期命令一致。不要把介绍文档放进一个随意文件夹后就认定它已是可调用Skill。
核对作用范围与最终名字
官方文档区分个人、项目、嵌套、插件及账户同步等来源。项目Skill放在对应仓库路径，个人Skill在本机用户目录；插件可能采用命名空间，嵌套目录还与会话位置及加载时机有关。
出现同名Skill时，不能只看到某个文件就断言正在调用它。检查当前实际列表与来源，给练习使用一个独有名称可以减少冲突。云端任务不应依赖只存在于本机的个人文件。
区分手动不可见与禁止自动触发
disable-model-invocation:true的目的，是防止模型自行触发，不代表用户不能主动调用。user-invocable:false则涉及手动命令可用性；两个字段不能因英文相近就互换。
排查时先读当前文件与可见列表，再决定是否按当前客户端支持的刷新方式重新加载。不要为了让菜单出现就删除用户权限、改组织策略，或把敏感材料复制到共享目录。
用一段材料验收加载是否真的生效
给练习命令的虚构材料是“N1：需求已确认；N2：测试日期未知”。确认命令已加载后，可手动输入：/review-note N1：需求已确认；N2：测试日期未知。人工预期只列出“待确认：测试日期，依据N2”，不把它改写成测试已完成或自动写回文件。
能在菜单中看到只是发现阶段，实际调用后遵守对应规则才是行为核对。保存实际命令名、Skill来源、输入与真实输出；与给定判据对照后再加入正式工作流。本篇未安装Skill或实际运行Claude Code，样例是预期说明。
参考资料与核验范围
资料核对日期：2026年10月19日。以下为官方原始资料；产品入口和可用范围仍以当前账户为准。
1. [官方资料1](https://code.claude.com/docs/en/skills)