要让 Claude 确认能读取到你创建的 skills，核心是做好技能配置、路径放置与权限开启，再通过目录扫描、手动触发、日志验证等方法校验，以下是详细步骤与实操方案：

一、先确保 Skill 符合加载要求（基础前提）

1. 核心文件与格式正确
   • 每个 skill 必须放在独立文件夹（如.claude/skills/my-skill/），且文件夹内有SKILL.md（区分大小写），这是唯一必需文件。
   • SKILL.md开头必须有 YAML 前置元数据，包含name（小写、连字符分隔，≤64 字符）和description（≤1024 字符，明确触发场景），示例如下：

   ---
   name: my-skill
   description: 处理PDF文件时提取数据并分析，适用于PDF数据分析场景
   ---
   

2. 放置路径正确
   • 项目级：放在项目根目录的.claude/skills/下（仅当前项目可用）。
   • 全局级：放在~/.config/claude/skills/下（所有项目可用）。
3. 权限与功能开启
   • 桌面 / Web 端：进入设置→功能（Capability），开启代码执行、文件创建，确保 Skills 功能已启用。
   • Claude Code：在设置中确认 Skills 相关权限已开放，必要时重启 Claude Code 加载新技能。

二、多种方法验证 Claude 是否读取到 Skills

1. 目录扫描与技能枚举（基础校验）
   • 对话中发送指令，让 Claude 枚举可用技能，如“\plugin”“加载skills” “列出所有可用的 skills”“你能看到哪些自定义 skills？”“你现在有哪些 Skills”。
   • Claude Code 中执行/list-skills命令，查看输出列表是否包含你的 skill 名称。
2. 手动触发校验（精准验证）
   • 用触发词激活：在SKILL.md元数据中添加activation_words: ["@my-skill"]，对话中输入@my-skill，看 Claude 是否加载该技能并按指令响应。
   • 直接调用斜杠命令：若 skill 绑定了斜杠命令（如/my-skill），输入命令测试是否执行对应逻辑。
3. 工具调用与上下文验证（深度确认）
   • 让 Claude 用read_file工具读取 skill 文件，指令如 “用 read_file 工具读取.claude/skills/my-skill/SKILL.md 的内容”，若能返回正确内容则说明读取正常。
   • 观察对话上下文：当 skill 被激活时，Claude 会在响应中体现技能相关指令，或在工具调用日志中看到加载SKILL.md的记录。

总结

先确保能正常用claude，不能用可以用国产支持claude的API放进去，比如智谱。然后再确定skills放的位置对不对，skill里的SKILL.md文件内容对不对。之后就直接问claude：列出所有可用的 skills，然后就会列出每个名称和描述，名称和描述就是SKILL.md里的内容。

之后AI会给你说怎么调用，比如：

你可以通过输入 /<skill-name> 来调用这些 skills，例如 /canvas-design、/hello-world 或 /test-skill。其实不带/好像也可以