Agent Skills
› softaworks/agent-toolkit
softaworks/agent-toolkit
GitHub将臃肿的Agent指令文件重构为符合渐进式披露原则的结构化文档，提取核心内容至根目录，其余按类别拆分并链接。
Install All Skills
npx skills add softaworks/agent-toolkit --all -g -y
Skills in Collection (43)
将臃肿的Agent指令文件重构为符合渐进式披露原则的结构化文档，提取核心内容至根目录，其余按类别拆分并链接。
refactor my AGENTS.md
split my agent instructions
organize my CLAUDE.md file
my AGENTS.md is too long
npx skills add softaworks/agent-toolkit --skill agent-md-refactor -g -y
用于后端完成API开发后，为前端生成结构化交接文档。涵盖业务背景、接口定义、数据模型及枚举常量，确保前端无需询问即可准确集成。
create handoff
document API
frontend handoff
API documentation
npx skills add softaworks/agent-toolkit --skill backend-to-frontend-handoff-docs -g -y
生成基于C4模型的软件架构文档，通过Mermaid语法绘制系统上下文、容器、组件及部署图，用于可视化系统结构和记录架构设计。
architecture diagram
C4 diagram
system context
container diagram
component diagram
deployment diagram
document architecture
visualize architecture
npx skills add softaworks/agent-toolkit --skill c4-architecture -g -y
用于运行 OpenAI Codex CLI，支持代码分析、重构及自动化编辑。指导模型选择、沙箱模式配置及会话管理，默认使用 gpt-5.2 处理软件工程任务。
用户请求运行 codex exec 或 codex resume
需要调用 OpenAI Codex 进行代码分析或重构
npx skills add softaworks/agent-toolkit --skill codex -g -y
用于在 Claude Code 中创建可复用的斜杠命令，支持自动化工作流、多步骤流程及代理委托模式，提供结构模板与最佳实践指导。
用户要求创建或制作斜杠命令
用户希望将重复性工作流程文档化为可复用命令
npx skills add softaworks/agent-toolkit --skill command-creator -g -y
指导创建高质量 Git 提交，包括审查变更、按逻辑拆分提交及编写符合 Conventional Commits 规范的提交信息。
用户请求提交代码
需要拆分混合变更为多个提交
要求生成或优化 Commit Message
npx skills add softaworks/agent-toolkit --skill commit-work -g -y
提供README编写、更新和审查的模板与指南，针对不同项目类型（开源、个人等）优化文档结构，确保内容准确并满足目标读者需求。
编写新项目README
更新现有README内容
检查README准确性
添加新功能文档说明
npx skills add softaworks/agent-toolkit --skill crafting-effective-readmes -g -y
交互式每日站会更新生成技能，通过检测GitHub、Jira及Claude Code历史数据，引导用户回答昨日进展、今日计划、阻碍及讨论话题，最终生成格式化的Markdown会议报告。
daily standup
scrum update
status update
what did I do yesterday
prepare for meeting
team sync
npx skills add softaworks/agent-toolkit --skill daily-meeting-update -g -y
设计健壮、可扩展的 SQL 和 NoSQL 数据库模式，提供规范化指南、索引策略、迁移模式和性能优化建议，确保数据完整性与查询效率。
需要设计新的数据库表结构
询问数据库范式或索引优化
选择 SQL 或 NoSQL 方案
请求数据模型设计
npx skills add softaworks/agent-toolkit --skill database-schema-designer -g -y
Datadog CLI 工具，用于搜索日志、查询指标、追踪请求及管理仪表盘。主要辅助在调试生产问题时快速定位和排查故障。
需要搜索或分析生产环境日志
需要查询系统或应用指标
需要追踪分布式请求链路
需要进行故障排查和事件分诊
npx skills add softaworks/agent-toolkit --skill datadog-cli -g -y
智能依赖管理技能，自动检测项目类型并执行安全更新。支持多语言，按版本策略自动应用补丁和次要更新，对主要更新进行提示确认，并能诊断和修复依赖问题及漏洞。
用户请求更新或检查依赖包
需要诊断或修复依赖冲突/漏洞
npx skills add softaworks/agent-toolkit --skill dependency-updater -g -y
用于创建和演进设计系统，提供设计令牌、组件架构、无障碍指南及文档模板，确保跨产品UI的一致性、可扩展性和可访问性。
创建设计系统
设置设计令牌
设计组件架构
实现无障碍合规
实现暗色模式主题
npx skills add softaworks/agent-toolkit --skill design-system-starter -g -y
提供职场冲突、绩效反馈及敏感对话的结构化应对框架，涵盖准备、执行与跟进三阶段，辅助处理棘手沟通场景。
准备与同事的艰难对话
向团队成员指出绩效问题
给予关键或负面反馈
调解团队内部冲突
讨论薪资或晋升等敏感话题
npx skills add softaworks/agent-toolkit --skill difficult-workplace-conversations -g -y
根据项目描述生成创意域名建议，并跨多个TLD检查可用性，提供品牌洞察和备选方案，节省手动搜索时间。
为新项目或公司寻找域名
产品发布或重新品牌化时注册域名
npx skills add softaworks/agent-toolkit --skill domain-name-brainstormer -g -y
提供 draw.io 图表的 XML 编辑、PNG 转换及布局调整指南。规范字体设置、坐标计算、设计原则与无障碍标准，支持通过脚本批量转换及 pre-commit 钩子集成。
需要创建或修改 .drawio 文件
需要将 drawio 转换为 PNG 图片
需要调整图表元素布局或坐标
npx skills add softaworks/agent-toolkit --skill draw-io -g -y
处理 Excalidraw 文件时，通过委派子代理隔离高 Token 消耗的 JSON 解析，防止主上下文溢出。适用于图表读取、修改和创建场景。
文件路径包含 .excalidraw 或 .excalidraw.json
用户请求解释、更新或创建图表/架构图
提及流程图、架构可视化
npx skills add softaworks/agent-toolkit --skill excalidraw -g -y
提供职场困难对话与建设性反馈的结构化框架，涵盖PD模型及SBI技巧，用于绩效沟通、冲突管理及期望协调。
准备进行困难对话
给予或接收反馈
解决团队冲突
npx skills add softaworks/agent-toolkit --skill feedback-mastery -g -y
用于前端开发向后端传达数据需求，明确UI所需展示的数据、用户操作及状态，促进前后端协作。
描述界面数据需求
提出API需求
沟通后端要求
npx skills add softaworks/agent-toolkit --skill frontend-to-backend-requirements -g -y
作为产品战略家，通过理解当前价值、寻找10倍机会及严格评估，发现能极大提升产品价值的颠覆性功能与策略。
用户提到 '10x' 或高杠杆改进
询问 'what would make this 10x better'
需要产品战略思考或决定下一步构建内容
npx skills add softaworks/agent-toolkit --skill game-changing-features -g -y
提供Gemini CLI的使用指南，支持代码审查、架构计划分析及大上下文处理。强调在后台或非交互模式下必须使用yolo模式或超时包装以避免进程挂起，并指导模型选择与命令组装。
用户请求进行代码审查
需要分析大型上下文或多文件关系
用户指定使用Gemini CLI执行任务
npx skills add softaworks/agent-toolkit --skill gemini -g -y
Gepetto 是一个多步骤实施规划技能，通过研究、利益相关者访谈和多 LLM 审查生成详细的分节实现计划。它管理从需求规格到最终执行文件的完整规划流程，支持断点续传和状态恢复。
需要制定详细的功能实施计划
进行功能前的深入分析和预实施评估
用户请求使用 /gepetto 命令启动规划流程
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
通过自然语言与 Jira 交互，支持 CLI 和 MCP 后端，用于创建、查看、更新问题及管理工作流。
提及 Jira 问题编号
询问工单状态
创建或更新 Issue
检查 Sprint 状态
npx skills add softaworks/agent-toolkit --skill jira -g -y
分析近期代码变更并提取软件工程经验教训。通过git历史对比，识别结构决策、权衡与改进点，结合原则库生成具体可执行的反思总结，帮助用户从实际代码中学习。
询问'what is the lesson here?'
请求'engineering takeaway'
要求'reflect on this code'
询问'what can I learn from this?'
npx skills add softaworks/agent-toolkit --skill lesson-learned -g -y
用于创建专业 Marp 演示文稿的技能，支持 7 种预设主题及自定义设计。根据用户需求自动选择模板、优化排版与图片布局，生成高质量的 Markdown 格式幻灯片文件。
请求创建演示文稿或 PPT
要求美化幻灯片外观
提供模糊的设计指令如'做得好看点'
需要制作讲座或研讨会材料
npx skills add softaworks/agent-toolkit --skill marp-slide -g -y
利用memegen.link API生成自定义梗图，支持多种模板、文本样式及平台尺寸适配，适用于社交媒体内容创作和趣味化表达。
用户请求生成梗图
为内容添加幽默元素
需要社交媒体的视觉辅助材料
npx skills add softaworks/agent-toolkit --skill meme-factory -g -y
提供 MUI v7 组件库的使用模式，涵盖 sx 属性样式、主题集成、响应式设计及 Hooks。用于指导前端开发中 Material-UI 的规范用法与样式定制。
使用 MUI 组件进行 UI 开发
配置 MUI 主题或样式
处理 MUI v6 到 v7 的迁移兼容性问题
npx skills add softaworks/agent-toolkit --skill mui -g -y
根据上下文和语言规范，分析并建议更优的变量、函数及类命名。识别模糊、误导性或不符合惯例的名称问题，提供符合项目规范的替代方案及理由。
代码审查中的命名规范检查
重构时优化标识符名称
npx skills add softaworks/agent-toolkit --skill naming-analyzer -g -y
将 OpenAPI 3.0 规范转换为 TypeScript 接口和类型守卫，支持基础类型、复杂对象及联合类型的映射。
generate types from openapi
convert openapi to typescript
create API interfaces
generate types from spec
npx skills add softaworks/agent-toolkit --skill openapi-to-typescript -g -y
提供基于 Perplexity AI 的通用网络搜索、信息查询及深度研究能力，用于获取最新资讯、资源链接或概念解释。
用户询问最新信息
需要查找通用资料或教程
要求搜索特定主题
npx skills add softaworks/agent-toolkit --skill perplexity -g -y
用于创建、管理和发布 Claude Code 插件，处理目录结构、清单文件生成、版本管理及市场集成。
创建新插件
更新插件版本
管理插件清单
发布插件到市场
npx skills add softaworks/agent-toolkit --skill plugin-forge -g -y
提供软件开发场景下的专业沟通指南，涵盖邮件、即时通讯和会议准备。通过What-Why-How框架及受众校准技巧，帮助开发者清晰表达技术概念，提升书面沟通效率与专业性。
撰写工作邮件或消息
准备会议议程或总结
向非技术人员解释技术问题
npx skills add softaworks/agent-toolkit --skill professional-communication -g -y
专为QA工程师设计的技能，用于生成测试计划、手动用例、回归测试套件及缺陷报告，并支持Figma设计验证。
需要制定功能测试策略或计划
生成具体功能的测试用例
构建回归测试集
对比设计与实现差异
创建缺陷报告
npx skills add softaworks/agent-toolkit --skill qa-test-planner -g -y
提供 React TypeScript 类型安全开发指南，涵盖组件构建、泛型设计、事件处理及 React 19 新特性（如 Server Components、useActionState）的最佳实践。
构建 React 组件
实现泛型组件
React 19 迁移或功能使用
类型化事件处理器
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供 React useEffect 最佳实践，指导何时使用或避免副作用。涵盖派生状态、数据获取及替代方案如 useMemo，旨在优化组件逻辑并减少不必要的 Effect 使用。
编写或审查 useEffect 代码
处理派生值、数据获取或状态同步
npx skills add softaworks/agent-toolkit --skill react-useeffect -g -y
专注于最小化代码库总行数的技能，倡导删除冗余代码而非仅做重构。通过评估最终代码量、识别可删除部分及警惕过度设计，实现熵减目标。
用户明确要求减少代码量
评估代码变更是否导致总体代码增加
npx skills add softaworks/agent-toolkit --skill reducing-entropy -g -y
通过结构化对话澄清模糊需求，利用100分评分系统迭代完善，确保在编码前生成包含验收标准和边界的高清晰度PRD。
需求描述模糊或缺失技术上下文
功能复杂度高或涉及跨团队协作
缺少明确的验收标准或成功指标
npx skills add softaworks/agent-toolkit --skill requirements-clarity -g -y
将学习材料转化为可执行的Ship-Learn-Next实施计划，提取核心教训并设计具体行动步骤。
用户希望将建议或课程转化为具体行动计划
要求从教育内容中提取实施步骤
询问观看/阅读某内容后下一步该做什么
npx skills add softaworks/agent-toolkit --skill ship-learn-next -g -y
用于评估 Agent Skill 设计质量，依据官方规范对 SKILL.md 进行多维度打分并提供改进建议。适用于审查、审计或优化技能包。
审查 SKILL.md 文件
审计 Agent Skill 设计
优化技能包内容
npx skills add softaworks/agent-toolkit --skill skill-judge -g -y
将网页URL转换为干净Markdown的Skill，支持JS渲染页面。需用户显式调用，通过本地web2md CLI提取内容并输出文件。
用户明确要求使用 web-to-markdown skill
需要将网页内容转化为 Markdown 格式
npx skills add softaworks/agent-toolkit --skill web-to-markdown -g -y
基于Strunk写作规则，优化文档、提交信息、错误提示等人类可读文本的清晰度与简洁性，避免AI生成模式。
撰写技术文档或README
编写提交信息或PR描述
优化错误消息或UI文案
编辑以提高文本清晰度
npx skills add softaworks/agent-toolkit --skill writing-clearly-and-concisely -g -y
用于识别并消除文本中的AI生成痕迹，使写作更自然、人性化。基于维基百科指南，检测并修复夸张象征、过度使用破折号、空洞分析等模式，同时注入个性与语气，保留原意。
编辑或审查文本以去除AI风格
优化内容使其更具人情味和个性
npx skills add softaworks/agent-toolkit --skill humanizer -g -y
提供 Mermaid 语法指南，用于创建类图、时序图、流程图等软件文档和架构可视化图表。适用于系统建模、代码结构说明及数据可视化场景。
需要创建或解释软件架构图
请求绘制类图、时序图或流程图
涉及数据库设计或用户流程展示
npx skills add softaworks/agent-toolkit --skill mermaid-diagrams -g -y
用于生成和恢复AI Agent会话交接文档，解决上下文耗尽问题。支持创建包含当前状态、决策及下一步的完整文档，并验证完整性与安全性，确保新Agent无缝继续工作。
用户请求保存上下文或暂停工作
上下文窗口接近容量
完成重大任务里程碑
会话结束
用户说save state或create handoff
用户说load handoff或resume from
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
