配置 Claude Code Skills
Skills 是 Claude Code 的能力扩展包，用于保存可复用的说明、流程、脚本和资源。它不会替代 LAYSO AI 的 Base URL 或 API Key 配置。
Skills 放在哪里
| 范围 | 路径 | 适用场景 |
|---|---|---|
| 项目级 | .claude/skills/<skill-name>/SKILL.md | 与团队共享、跟随仓库版本控制 |
| 个人级 | ~/.claude/skills/<skill-name>/SKILL.md | 只在当前用户环境使用 |
| 插件级 | <plugin>/skills/<skill-name>/SKILL.md | 随 Claude Code 插件分发 |
创建项目级 Skill
bash
mkdir -p .claude/skills/review-changes新建 .claude/skills/review-changes/SKILL.md：
markdown
---
name: review-changes
description: Review the current changes before delivery
---
# Review changes
1. Inspect the current diff.
2. Run the smallest relevant tests.
3. Report correctness, security, and regression risks.
4. Never print or commit API keys.使用 Skill
重启 Claude Code，或等待当前客户端重新加载 Skills。然后在对话中直接描述任务，或显式输入：
text
/review-changes项目级 Skill 可以提交到仓库，与团队成员共同维护。个人偏好和含有本机路径的说明更适合放在 ~/.claude/skills。
通过插件安装
在 Claude Code 中输入：
text
/plugin进入插件管理界面后，先核对来源、说明和权限，再安装需要的插件。插件内的 Skills 可能使用命名空间，调用名称以安装界面显示为准。
编写建议
description要明确说明 Skill 在什么情况下使用。- 步骤应可验证，避免模糊的“做好一点”。
- 脚本和引用文件使用相对 Skill 目录的路径。
- 不要把 LAYSO AI API Key、聊天记录或生产数据写入 Skill。
- 项目规则保持简短，把大型示例放入 Skill 的独立资源文件。
排查 Skills
Skill 没有出现
确认目录名称和 SKILL.md 大小写完全正确，YAML frontmatter 使用三个短横线包围，并重新启动 Claude Code。
指令名称冲突
项目级与个人级 Skill 可能重名。改用唯一名称；插件 Skill 则按客户端显示的命名空间调用。
Skill 执行了意外命令
立即停止执行，检查 SKILL.md 以及引用的脚本。第三方 Skill 应像代码依赖一样先审查后使用。
下一步
回到 Claude Code 配置概览，或检查 LAYSO AI 模型地址配置。