Agent Skills
› softaworks/agent-toolkit
softaworks/agent-toolkit
GitHub用于重构臃肿的 Agent 指令文件（如 AGENTS.md），遵循渐进式披露原则，将其拆分为结构清晰、相互链接的文档集合。
Install All Skills
npx skills add softaworks/agent-toolkit --all -g -y
Skills in Collection (43)
用于重构臃肿的 Agent 指令文件（如 AGENTS.md），遵循渐进式披露原则，将其拆分为结构清晰、相互链接的文档集合。
用户要求重构或拆分 AGENTS.md/CLAUDE.md
指令文件过长需要清理和整理
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
指导 Agent 调用 Codex CLI 进行代码分析、重构和自动化编辑。涵盖模型选择、沙箱模式配置及会话恢复，默认使用 GPT-5.2，支持只读审查或工作区写入等场景。
用户要求运行 Codex CLI
请求代码分析或重构
引用 OpenAI Codex 进行自动化编辑
npx skills add softaworks/agent-toolkit --skill codex -g -y
用于创建 Claude Code 斜杠命令的技能，指导用户定义命令名称、选择模式并生成结构化的 Markdown 文件，实现工作流自动化与复用。
用户要求创建命令
将重复工作流文档化为可复用命令
npx skills add softaworks/agent-toolkit --skill command-creator -g -y
辅助创建高质量 Git 提交，包括审查变更、拆分逻辑提交及编写符合 Conventional Commits 规范的提交信息。
用户请求提交代码
需要拆分混合变更为多个提交
要求生成或优化提交信息
npx skills add softaworks/agent-toolkit --skill commit-work -g -y
提供编写和改进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
morning update
team sync
npx skills add softaworks/agent-toolkit --skill daily-meeting-update -g -y
用于设计健壮、可扩展的SQL和NoSQL数据库模式，提供规范化指南、索引策略、迁移模式和约束设计，确保数据完整性与查询性能。
需要设计新的数据库表结构
询问数据库规范化或索引优化建议
npx skills add softaworks/agent-toolkit --skill database-schema-designer -g -y
Datadog CLI 工具，用于搜索日志、查询指标、追踪请求及管理仪表盘。支持实时日志流、错误摘要和分布式追踪，辅助排查生产环境问题及进行可观测性数据操作。
排查线上故障
查询系统监控指标
分析日志模式
管理 Datadog 仪表盘
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
辅助用户为项目生成创意域名并检查多后缀可用性，提供品牌建议与替代方案，节省头脑风暴时间。
启动新项目或公司时寻找域名
产品发布或品牌重塑
注册个人品牌或副业域名
npx skills add softaworks/agent-toolkit --skill domain-name-brainstormer -g -y
提供draw.io图表的创建、编辑与审查指南，涵盖XML结构修改、字体设置、PNG转换命令及坐标调整方法。强调设计规范、无障碍访问及渐进式披露原则，确保图表清晰准确。
需要绘制或编辑系统架构图、流程图等
需要将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
提供职场困难对话与建设性反馈的结构化框架，涵盖准备-交付-跟进模型及SBI技巧，用于解决绩效问题、团队冲突及敏感沟通场景。
准备给予同事或下属反馈
处理绩效问题或期望偏差
调解团队成员间的冲突
进行关于敏感话题的一对一谈话
npx skills add softaworks/agent-toolkit --skill feedback-mastery -g -y
辅助前端开发人员梳理并文档化向后端提出的数据需求，明确展示内容、用户操作及状态处理，促进前后端协作。
需要沟通 API 需求给后端
描述 UI 所需的数据或功能
npx skills add softaworks/agent-toolkit --skill frontend-to-backend-requirements -g -y
专注于寻找10倍产品机会和高杠杆改进的策略性技能。通过深入理解当前价值，从大规模、中等规模和小规模三个维度发掘变革性功能，并 ruthlessly 评估其影响力、覆盖面和差异化优势，旨在发现能让用户无法离开的游戏改变者特性。
用户提到 '10x' 或 'what would make this 10x better'
用户寻求 'product strategy' 或 'what should we build next'
npx skills add softaworks/agent-toolkit --skill game-changing-features -g -y
指导使用 Gemini CLI 进行代码审查、架构计划分析及超大上下文处理。强调根据交互场景选择模型与审批模式，特别警告非交互式环境下禁用 default 模式以防挂起，并提供故障排查方法。
用户要求进行代码审查
需要分析大型上下文或跨文件关系
用户指定使用 Gemini 工具
npx skills add softaworks/agent-toolkit --skill gemini -g -y
用于复杂功能实施前的多阶段规划，涵盖研究、访谈、规格合成及外部评审，生成结构化实施方案。
需要制定详细的实施计划
进行功能预实施分析
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
提供 Jira 问题的自然语言交互能力，支持通过 CLI 或 MCP 后端创建、查看、更新工单及管理工作流。自动检测环境并引导用户操作。
提及 Jira 问题编号（如 PROJ-123）
询问工单状态
创建或查看问题
检查冲刺状态
管理 Jira 工作流
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种主题及自定义设计。当用户需要制作幻灯片、改善视觉效果或生成讲座材料时触发，自动优化排版与样式。
请求创建演示幻灯片
要求美化幻灯片设计
生成讲座或会议材料
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 属性样式编写、主题定制及响应式设计的最佳实践与代码模式，涵盖从基础组件到复杂样式管理的开发指南。
使用 Material-UI 组件构建界面
通过 sx prop 进行内联样式定义
配置或自定义 MUI 主题
处理 MUI v7 的 API 变更
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 接口和类型守卫。支持提取组件 Schema 及路径端点，处理基础、复杂类型映射，并生成带 JSDoc 注释的代码文件。
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 的通用网络搜索、信息查询及深度研究能力，明确区分于文档查询和内部工作区问题，指导 Agent 正确选择 Search、Ask 或 Researcher 工具。
用户要求搜索通用信息
查找最新趋势或最佳实践
询问概念解释
进行多源深度研究
npx skills add softaworks/agent-toolkit --skill perplexity -g -y
用于创建、管理和发布 Claude Code 插件的工具，支持生成插件结构、更新清单文件及本地测试。
创建新的插件项目
修改或添加插件组件如命令和技能
更新插件版本号
配置插件市场清单
npx skills add softaworks/agent-toolkit --skill plugin-forge -g -y
提供软件开发场景下的专业沟通指南，涵盖邮件、即时消息及会议议程的结构化写作框架。帮助开发者清晰传达信息，适配不同受众，提升书面沟通效率与专业性。
撰写工作邮件或状态更新
准备会议议程或总结
向非技术人员解释技术概念
npx skills add softaworks/agent-toolkit --skill professional-communication -g -y
面向QA工程师的测试规划技能，支持生成测试计划、手工用例、回归套件及Bug报告，并集成Figma MCP进行设计验收对比。
用户要求创建测试计划或手动测试用例
需要构建回归测试套件
请求验证UI设计与Figma原型的一致性
需要生成结构化的Bug报告
npx skills add softaworks/agent-toolkit --skill qa-test-planner -g -y
提供 React 与 TypeScript 的类型安全开发指南，涵盖组件、Hook、事件及 React 19 新特性（如 Server Components）的最佳实践。
构建带类型的 React 组件
使用 React 19 新功能
处理类型化事件或表单
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供React useEffect最佳实践，指导何时使用或避免Effect。涵盖派生状态、数据获取及外部系统同步场景，推荐useMemo等替代方案，帮助编写更优的组件逻辑。
编写React组件逻辑
审查useEffect代码规范
处理派生状态计算
实现数据获取与清理
npx skills add softaworks/agent-toolkit --skill react-useeffect -g -y
用于最小化代码库规模的手动技能，仅在用户明确要求时激活。核心原则是偏向删除、减少总代码行数而非增加灵活性或组织性，衡量标准是最终代码量的净减少。
用户明确请求减少代码量
需要优化代码库熵值
npx skills add softaworks/agent-toolkit --skill reducing-entropy -g -y
用于在开发前澄清模糊需求，通过系统性提问和百分制评分机制，将不完整的描述转化为包含验收标准和技术细节的可执行PRD，确保实现前的清晰度。
需求描述模糊或缺失技术上下文
功能复杂度高（预计超过2天）
涉及跨团队协调的需求
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设计质量
审计现有SKILL.md文件
优化Skill包内容
npx skills add softaworks/agent-toolkit --skill skill-judge -g -y
将网页URL转换为干净的Markdown格式，支持JS渲染页面。通过本地web2md CLI调用Puppeteer和Readability提取内容，提供多种输出选项及渲染控制参数。
用户明确请求使用 web-to-markdown skill
需要将网页内容转换为 Markdown 格式
npx skills add softaworks/agent-toolkit --skill web-to-markdown -g -y
提供清晰简洁的写作指导，适用于文档、提交信息、错误提示及UI文案等人类阅读文本。基于Strunk风格规则，强调主动语态和精简表达，并列出需避免的AI套话模式，提升专业度与可读性。
撰写技术文档或README
编写代码提交信息
优化用户界面文案
生成错误提示信息
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语法指南，支持创建类图、时序图、流程图等软件图表。用于可视化系统架构、数据库设计及代码结构，提升文档可维护性。
请求生成软件架构图或流程图
需要可视化数据模型或API交互流程
npx skills add softaworks/agent-toolkit --skill mermaid-diagrams -g -y
用于创建和管理AI代理会话交接文档，支持保存上下文、暂停工作及无缝恢复。通过脚本生成脚手架、填充关键状态与决策，并执行安全校验，解决长任务上下文耗尽问题，确保新代理能零歧义继续工作。
用户请求保存状态或创建交接
上下文窗口接近容量
重大任务里程碑完成
工作会话结束
用户表示需要暂停或上下文已满
用户尝试从历史交接中恢复工作
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
