用途：把插件各组件部署到智能体环境，采用 .agents/ 中央存储加符号链接的模式，作为全栈安装器，覆盖 npx skills 不处理的命令、规则与 hooks。
主要能力与映射：skills/ 复制到 .agents/skills/<skill>/，Claude Code 直接读取；commands/ 写入 .agents/workflows/<plugin>_<cmd>.md 并在 .claude/commands/ 建符号链接（源目录名始终为 commands/）；rules/ 写入 .agents/rules/ 并追加到 CLAUDE.md；hooks/hooks.json 写入 .agents/hooks/，Claude 侧建符号链接；.mcp.json 合并到项目根。Antigravity、Gemini、GitHub Copilot 原生读取 .agents/，无需额外链接。重装时先清空目标 skills 目录，保证非增量变更被清除。部分命令会扁平化为 snake_case，如 commands/ops/restart.md 变为 <plugin>_ops_restart.md。安装后向 ~/.agents/.skill-lock.json（全局）或 <project>/skills-lock.json（项目）写锁文件，schema 版本 3，仅记录 skills。
使用方式：推荐 uvx 无克隆交互式安装，命令为 uvx --from git+https://github.com/richfrem/agent-plugins-skills plugin-add richfrem/agent-plugins-skills，可加 --all -y 非交互；无 uv 时用 bootstrap.py curl 管道；本地克隆可用 python ./scripts/plugin_add.py 传 owner/repo[/subpath]、完整 GitHub URL 或本地路径，支持 --dry-run 预览。执行引擎为 scripts/plugin_installer.py --plugin <路径>，可加 --dry-run。源格式支持 owner/repo、子路径、tree/main/ URL 与本地路径，发现采用三级回退：plugins/ 子目录、根级插件形状目录、单插件目录。依赖仅 Python 3.8+ 标准库，requirements.txt 为空。
适用场景：本地部署含命令、规则、hooks 的完整插件；修改插件后重新桥接；新增目标环境后重新桥接；与 npx skills 生态对账；排查缺失命令或规则。
限制与注意：执行前需 Recap-Before-Execute 并优先 --dry-run，禁止使用 --target auto，缺失 .agents/、.claude/ 不自动创建。Windows 符号链接可能回退到 mklink 或普通复制；锁文件写入失败不中止安装。远程终端用户消费建议改用 plugin_add.py owner/repo 或官方安装入口，结构审计请用 maintain-plugins。