装完看不到技能 / document-skills 安装问答

症状

按教程装完（/plugin install 流程或方式 B），在 agent 里看不到技能；或 document-skills 子集安装后无效果。

原因

技能包本质是目录复制（无二进制）：装错目录、未完全退出重启 agent、或复制时权限/路径不对都会「装完看不见」；document-skills 属同一技能集子集，问题同源（网络/权限/版本不兼容是常见失败面，CSDN 安装问答）。

解法

1. 核对技能目录：`ls ~/.claude/skills/agent-skills`（应 24 目录，每个含 SKILL.md）。

2. 完全退出并重启 agent 会话再试（技能在启动时扫描）。

3. 权限问题：确认目标目录可写；版本问题：确认 tag 与收录版本（0.6.7）一致。

验证证据

- 本市场实测（2026-08-28）：方式 B 复制后目标目录 24 目录 + 24 个 SKILL.md；重启扫描行为为通用机制，未在真实 agent 环境复测——如实标注。