Claude Code Skills 装之前，先看别人踩的坑
中文实测站。每个 skill 只回答三件事：解决什么、不适合谁、坑在哪。 不做目录，不按 star 排名。
从安装开始一个 skill 在 agent 眼里有多长
你在读完整篇测评之前，agent 每回合只看得到下面第一段。剩下的正文， 要等它决定用它时才读进来——这是「装了没效果」最常见的误判来源。
frontmatter 里的两行，就是它的全部名片：
name: superpowers
description: >
A complete software development methodology and skill
composition system, ported from obra/superpowers.
Provides structured, repeatable workflow: brainstorming,
design, planning, TDD, subagent-driven dev, code review,
finishing branch. Use for coding, building projects,
refactoring, bug fixing, or any programming tasks.
读自本机已安装副本
.dsh/skills/superpowers-skill/SKILL.md，2026-10-19。
正文是一套七阶段的强制流程：brainstorming → design → plan → TDD → 并行实现 → code review → 收尾。每阶段都有产出物和检查点，不能跳步。 这就是它的价值，也是它的代价。
正文只在被调用时进上下文，之后若干轮内保留。完整对照见 Superpowers 实测。
把「agent 看到的」和「你看到的」拆开，是判断一个 skill 会不会被触发、 值不值占位的唯一办法。
三个问题，按搜索的人分
最近装过的
五分钟，把一个装上
跨 agent 的安装器是 skills（vercel-labs 维护，支持 Claude
Code / Codex / Cursor / Windsurf 等 40+ 个 agent）。一条命令：
npx skills add obra/superpowers装完一定要重开会话——skill 清单在会话启动时读入。这是新手第一个坑。 下面三块都是本机 2026-10-19 的真实输出。
o Source: https://github.com/obra/superpowers.git
• Cloning repository…
o Repository cloned
o Found 15 skills
• Installing all 15 skills
— Done! Review skills before use;
they run with full agent permissions.真实输出的摘录（每个 skill 的逐条回执略去）。这一天跑了 5 次，8.6–12.4 秒落 15 个目录。 最后那句别跳过：skill 以完整 agent 权限运行。
brainstorming/SKILL.md
test-driven-development/SKILL.md
systematic-debugging/SKILL.md
writing-plans/SKILL.md
subagent-driven-development/SKILL.md
requesting-code-review/SKILL.md
using-git-worktrees/SKILL.md
…共 15 个目录装完是真的一份一份 SKILL.md，不是软链接。数一下目录，就知道有没有装全。
o Found 15 skills
• Installing all 15 skills
overwrites: Claude Code
— Done! Review skills before use重复安装不报冲突，直接覆盖——本地改过 SKILL.md 就别再装一遍。
装之前先确认两件事：装到哪一层（项目级还是用户级）、
装给哪个 agent。安装器会问，也可以用
--agent 直接指定。
完整的 12 条真实报错与路径对照表在 安装指南。
装不上时，先看这一条
第一次装失败的原因不是墙，是 git 的代理指着一个已经关掉的端口。 把配置指到活着的端口之后，同一条命令直接过。
failed to clone repository
fatal: unable to access
'https://github.com/obra/superpowers.git/':
Failed to connect to github.com port 443
via 127.0.0.1 after 2055 ms:
Could not connect to server
— Installation failed
报错里出现 via 127.0.0.1 就基本能定位：请求根本没出本机。
两条修法，二选一：
# 看一眼代理配的是哪个端口
git config --global --get http.proxy
# 指到活着的端口，或干脆取消
git config --global http.proxy 127.0.0.1:7897
git config --global --unset http.proxy
如果报的是 Recv failure: Connection was reset，
那是直连被重置，属于网络环境问题，跟安装器本身无关——换网络、换个能出海的代理再装一次就行，不要反复重装。
会被问到的
装了 skill 但完全没反应，先查哪里？
按命中率查三处：装的位置对不对（项目级是 .claude/skills/，用户级是 ~/.claude/skills/，装错目录等于没装）；会话有没有重开（清单在会话启动时读入，不重开不会出现）；frontmatter 有没有写坏（YAML 解析失败时正文照常加载、字段全空，自动触发就失效了，只剩手敲 /skill-name 能用）。
skill 和 MCP 该先装哪个？
看你要的是做法还是数据。skill 给的是流程和判断，不联网也能用；MCP 给的是访问权，要 agent 拿到外部数据就绕不过去。两者不互斥，先装哪个取决于你现在缺的是干法还是数据。
一个 skill 占多少上下文？
默认只占一行描述。每回合进上下文的只有 frontmatter 里的 name 和 description，正文要等调用时才读进来。但装满几十个之后，光是描述也会挤占预算——官方文档提到描述列表会按上下文窗口的比例缩放，超预算时先丢最少用的。
国内网络为什么装不上？
常见不是墙，是 git 的代理指着一个已经关掉的端口。本机就复现过：git config 里写着 127.0.0.1:7890，实际监听的是 7897，报错是 Failed to connect to github.com port 443 via 127.0.0.1。把 http.proxy 指到活着的端口之后，同一条命令 12.4 秒装完 15 个 skill。