agent-toolkit - AI Coding Agent 技能集合

技能简介

agent-toolkit 是 softaworks 团队维护的 AI Coding Agent 技能精选集合，所有技能遵循 Agent Skills 格式规范，可通过 px skills add softaworks/agent-toolkit 一键安装到 Claude Code、Codex、Cursor、AdaL 等主流 Coding Agent 平台。技能覆盖 AI 工具调用、元技能（Skill/Plugin/Command 创建）、文档生成、设计与前端、数据库、开发等多个维度，以提升日常开发效率为核心目标。

核心能力

• 多平台兼容：同一套 Skill 代码，支持 Claude Code、Codex、Cursor、AdaL 等多个 Coding Agent 平台，安装方式统一
• 插件市场一键安装：通过 /plugin marketplace add softaworks/agent-toolkit 交互式选择需要安装的具体技能，无需手动复制文件
• 原子化安装：每个 skill、agent、command 都是独立插件，可按需选择性安装，不需要全部装入
• 技能质量评估：内置 skill-judge 技能，可对 Skill 的设计质量进行评估打分
• 全流程覆盖：从代码分析（codex/gemini/perplexity）、文档生成（Marp Slide/C4 Architecture/Mermaid）、前端开发（React/useEffect/MUI/OpenAPI TypeScript）到数据库设计（database-schema-designer），覆盖软件开发全生命周期
• 自动更新机制：支持 Agent Skills 市场自动更新，启用后每次启动自动拉取最新版本

安装配置

方式一：px 命令行安装（推荐，一条命令）

px skills add softaworks/agent-toolkit

方式二：Claude Code 内交互式安装

/plugin marketplace add softaworks/agent-toolkit

然后在 Marketplaces 标签页中选择 agent-toolkit，浏览并选择要安装的具体技能。

方式三：直接安装特定技能

/plugin install codex@agent-toolkit
/plugin install humanizer@agent-toolkit
/plugin install agent-codebase-pattern-finder@agent-toolkit
/plugin install command-codex-plan@agent-toolkit

方式四：自然语言安装 直接告诉 Claude Code：Please install Skills from github.com/softaworks/agent-toolkit

方式五：手动安装（Claude Code，Skill 专用）

cp -r skills/ ~/.claude/skills/

使用步骤

第一步：安装 agent-toolkit 主包 选择上述任意一种安装方式完成主包安装。

第二步：启用市场自动更新

/plugin → Marketplaces → agent-toolkit → Enable auto-update

确保技能始终保持最新版本。

第三步：按需安装具体技能 例如需要生成 API 文档时，安装 frontend-to-backend-requirements：

/plugin install frontend-to-backend-requirements@agent-toolkit

第四步：在对话中使用 安装后直接通过自然语言调用，例如： "用 Mermaid 画一个用户认证服务的 C4 架构图" "帮我创建一个符合 Agent Skills 格式的新 Skill" "用 database-schema-designer 设计一个博客系统的数据库 Schema"

第五步：使用 skill-judge 评估现有 Skill 质量

/plugin install skill-judge@agent-toolkit

然后对项目中的自定义 Skill 进行质量评估和改进建议。

适用场景

1. API 前后端交接文档生成
2. 软件架构图（Mermaid/C4/draw.io/Excalidraw）
3. 专业的 PPT 演示文稿（Marp Slide）
4. React + TypeScript 前端开发最佳实践
5. Material-UI v7 组件模式
6. Claude Code 插件和 Manifest 文件构建（plugin-forge）
7. Claude Code slash commands 创建（command-creator）
8. Skill 设计和质量评估（skill-judge）
9. 代码审查和批量分析（codex/gemini）
10. 数据库 Schema 设计和优化

适用人群

• 使用 Claude Code、Codex、Cursor 等 Coding Agent 的开发者
• 需要提升文档生成效率的开发团队
• 希望构建和维护自定义 Skill 库的 advanced user
• 需要标准化前后端交接流程的全栈工程师

工作原理

agent-toolkit 遵循 Agent Skills（agentskills.io）格式规范，每个技能包包含标准化的 SKILL.md 定义文件和对应的资源目录。当 Coding Agent 加载技能时，会读取 SKILL.md 中的指令模板和工作流程描述，将其注入到 Agent 的系统提示词中，从而改变 Agent 的行为模式。每个技能是独立的原子单元，通过 MCP 协议或插件机制与宿主 Agent 交互，实现能力的模块化扩展。

官方链接

GitHub 仓库：https://github.com/softaworks/agent-toolkit