agent-toolkit安装全教程：npx一行命令、插件市场、手动安装3种方式详解

【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkit

📦 agent-toolkit 是一个为 AI 编码智能体（Claude Code、Codex、Cursor 等）打造的技能包合集：40+ 个开箱即用的 Skills、6 个子智能体和 7 个斜杠命令，覆盖代码分析、文档写作、架构图、React 开发、QA 测试等场景。本文详解npx 一行命令快速安装、插件市场选择性安装、手动安装3 种方式，新手 5 分钟上手。

🔍 先搞懂：agent-toolkit 是什么？

简单说，它就是一个**"给 AI 智能体装技能"的工具箱**：

• Skills（技能）→ 打包好的指令+脚本，让智能体学会特定工作流（如写 README、画 Mermaid 图）
• Agents（子智能体）→ 可被 Claude Code 委派任务的专职角色（如 UI/UX 设计师）
• Commands（斜杠命令）→ 输入/命令名即可调用的固定工作流

每个技能都遵循 Agent Skills。

🚀 方式一：npx 一行命令快速安装（推荐）

这是最快、最省事的方式，兼容 Claude Code、Codex、Cursor、AdaL 等多种智能体：

npx skills add softaworks/agentToolkit

⚠️ 注意仓库全名是softaworks/agent-toolkit，粘贴时请保留连字符：npx skills add softaworks/agent-toolkit

一条命令，回车，完成 ✅ 无需 clone 仓库、无需配置，适合想一次性装全套技能的用户。

🛒 方式二：插件市场安装（按需选择，最灵活）

不想"全家桶"？agent-toolkit 同时是一个插件市场（Marketplace），每个技能都是独立插件，可以只装你需要的。

1️⃣ 注册市场（Claude Code 中执行）

/plugin marketplace add softaworks/agent-toolkit /plugin

2️⃣ 三种安装姿势任选其一

直接安装示例（插件名@agent-toolkit格式）：

# 安装技能 /plugin install codex@agent-toolkit /plugin install humanizer@agent-toolkit # 安装子智能体（agent- 前缀） /plugin install agent-codebase-pattern-finder@agent-toolkit # 安装斜杠命令（command- 前缀） /plugin install command-codex-plan@agent-toolkit

3️⃣ 顺手开启自动更新

/plugin→Marketplaces标签 → 选择 agent-toolkit →Update marketplace，还能勾选Enable auto-update自动追新版本，永不过时。

💡 市场清单定义在 .claude-plugin/marketplace.json，每个插件的元数据（分类、关键词）都在这里；发布时由 scripts/build_plugins.py 构建独立插件包，所以装单个插件不会缓存整个仓库，非常轻量。

📁 方式三：手动安装（离线/精细控制）

需要离线环境，或只想把某个技能文件原封不动放进项目？手动复制走起：

# 1. 先克隆仓库 git clone https://gitcode.com/gh_mirrors/agentt/agent-toolkit cd agent-toolkit # 2. 复制指定技能到 Claude Code 技能目录 cp -r skills/<skill-name> ~/.claude/skills/

把<skill-name>换成你想装的技能名即可（如mermaid-diagrams）。

其他方式：

• claude.ai 网页版→ 把技能加入项目知识库，或直接把SKILL.md内容粘贴进对话
• 本地测试单个技能（贡献者玩法）→npx skills add . --skill <skill-name>，详情见 CONTRIBUTING.md

⚖️ 三种方式怎么选？一张表看懂

🎁 装完能玩什么？高频技能推荐

开发类：

• skills/commit-work/ → 生成高质量 Git 提交信息
• skills/dependency-updater/ → 智能依赖升级
• skills/naming-analyzer/ → 给变量/函数起更好的名字

文档与图表类：

• skills/mermaid-diagrams/ → 用 Mermaid 画流程图、时序图
• skills/crafting-effective-readmes/ → 写出专业 README
• skills/web-to-markdown/ → 网页转 Markdown

AI 工具类：

• skills/codex/ → 调用 GPT-5.2 做深度代码分析
• skills/gemini/ → 200k+ 超大上下文代码评审

完整技能清单见 README.md 的Available Skills表格（共 40+ 个，按 AI 工具/文档/前端/开发/规划/职场等 10 大类组织）。

❓ 常见问题（FAQ）

Q1：安装后命令不生效？确认你用的是支持 Skills 格式的智能体（Claude Code 支持最完整）；插件市场方式需确认已执行/plugin install 插件名@agent-toolkit。

Q2：如何更新到最新版？npx 方式重新跑一遍安装命令即可；插件市场方式用Update marketplace或开启 auto-update。

Q3：想贡献新技能？照着 CONTRIBUTING.md 的模板，新建skills/你的技能名/SKILL.md，附上README.md，提交 PR 即可——AGENTS.md 里有完整的技能写作规范和目录结构约定。

Q4：只想要斜杠命令（如 /sync-branch）怎么办？命令位于 commands/ 目录，通过插件市场安装：/plugin install command-sync-branch@agent-toolkit。

总结：新手无脑选npx 一行命令；Claude Code 重度用户推荐插件市场按需安装 + 自动更新；离线环境用手动复制。三种方式都试试，找到最适合你的那个！🚀

【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkit