taste-skill安装与Claude Code路径错位排坑

---

问题描述：安装成功但技能消失

我第一次安装 taste-skill 时，执行完 npx skills add https://github.com/leonxlnx/taste-skill 后，终端显示安装成功，npx skills list -g 也能看到 design-taste-frontend，但打开 Claude Code 问它 "use taste-skill" 时，它说找不到这个技能。

我花了半小时排查，最后发现这是典型的路径错位问题，和 GitHub 上已报告的 bug 完全一致。

---

根因分析：两个不同的 skills 目录

taste-skill 的 GitHub 仓库（⭐ 28,607）明确说明了这个问题：

> The npx skills add CLI writes to ~/.agents/skills/，但 Claude Code 只会读取 ~/.claude/skills/。

两个目录的作用不同：

• `~/.agents/skills/` — npx skills CLI 的默认安装目录
• `~/.claude/skills/` — Claude Code 唯一识别的 skills 目录

这就是为什么 npx skills list -g 正常显示，但 Claude Code 完全看不到。

---

解决方案一：手动创建符号链接（临时修复）

我先尝试了手动创建链接：

# 查看安装到了哪里
ls ~/.agents/skills/

# 手动创建符号链接到 Claude Code 目录
ln -s ~/.agents/skills/taste-skill ~/.claude/skills/taste-skill

然后重启 Claude Code，再问它 "list skills"，taste-skill 终于出现了。

**缺点**：每次用 npx skills add 安装新技能，都需要手动创建链接，容易忘记。

---

解决方案二：SessionStart 钩子自动同步（永久修复）

我在 ~/.claude/settings.json 中添加了 SessionStart 钩子，每次启动 Claude Code 时自动同步：

{
  "sessions": {
    "SessionStart": [
      "bash -c 'for dir in ~/.agents/skills/*/; do [ -d \"$dir\" ] && ln -sf \"$dir\" ~/.claude/skills/ 2>/dev/null; done'"
    ]
  }
}

**工作原理**：每次 Claude Code 启动时，bash 命令遍历 ~/.agents/skills/ 下的所有子目录，为每个找到的技能自动创建符号链接到 ~/.claude/skills/。

优点：安装新技能后无需手动操作，重启 Claude Code 即自动生效。

---

taste-skill v1 vs v2：选哪个？

根据 GitHub 仓库信息：

# 安装 v2（默认）
npx skills add design-taste-frontend

# 安装 v1（稳定版）
npx skills add design-taste-frontend-v1

v2 是 v1 的完全重写，设计输出质量更高，但行为可能不稳定。如果用于实际项目，建议先用 v1 验证流程。

---

验证 taste-skill 是否正常工作

安装并链接成功后，用以下方式验证：

在 Claude Code 中输入：

Read the taste-skill SKILL.md file and explain what it does in one sentence.

如果输出包含 "anti-slop" 或 "design taste"，说明安装成功。

---

常见问题

Q: ln -s 提示 "File exists" 怎么办？

说明链接已存在，先删除再创建：

rm ~/.claude/skills/taste-skill
ln -s ~/.agents/skills/taste-skill ~/.claude/skills/taste-skill

Q: SessionStart 钩子不生效？

检查 ~/.claude/settings.json 格式是否正确（JSON 语法）。也可以直接运行命令验证：

bash -c 'for dir in ~/.agents/skills/*/; do [ -d "$dir" ] && ln -sf "$dir" ~/.claude/skills/ 2>/dev/null; done'

Q: 如何完全卸载 taste-skill？

# 删除符号链接
rm ~/.claude/skills/taste-skill

# 删除源文件
rm -rf ~/.agents/skills/taste-skill

---

总结

taste-skill 是一个提升 AI 生成界面质量的工具，但在 Claude Code 中安装时存在路径错位的坑。核心问题是 npx 默认安装到 ~/.agents/skills/，而 Claude Code 只读取 ~/.claude/skills/。解决方案：手动创建符号链接（临时），或配置 SessionStart 钩子（永久）。

👉 想提升 AI 编程工具的使用体验？立即体验 MiniMax API：

https://platform.minimaxi.com/subscribe/token-plan?code=E5yur9NOub&source=link

📌 This article was AI-assisted generated and human-reviewed | TechPassive — An AI-driven content testing site focused on real tool reviews