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
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
指导如何运行 Codex CLI，包括模型选择、沙箱模式配置及会话恢复。用于代码分析、重构和自动化编辑任务。
用户请求使用 Codex CLI 执行命令
用户提及 OpenAI Codex 进行代码分析或重构
npx skills add softaworks/agent-toolkit --skill codex -g -y
用于创建和配置 Claude Code 斜杠命令的 Skill，指导用户定义命令结构、选择自动化模式并生成可复用的工作流文件。
用户要求创建命令
用户希望将重复性工作流自动化为可复用命令
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
交互式每日站会更新生成器，通过4问访谈收集信息。自动检测并拉取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。提供规范化指导、索引策略、迁移模式及性能优化建议，确保数据完整性、查询效率及模型可维护性。
用户需要设计新的数据库表结构
询问数据库规范化或索引优化方案
请求生成特定业务场景的SQL/NoSQL Schema
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
辅助用户为项目生成创意域名并检查多后缀可用性，提供品牌建议与替代方案。
需要为新项目或产品寻找域名
注册个人品牌或副业域名
查询特定关键词的域名可用性
npx skills add softaworks/agent-toolkit --skill domain-name-brainstormer -g -y
提供draw.io图表的XML编辑、字体配置、PNG转换及布局调整指南，规范设计原则与无障碍标准，支持通过脚本自动化生成高清透明背景图片。
需要创建或编辑.drawio文件
将.drawio转换为PNG格式
调整图表元素坐标或样式
npx skills add softaworks/agent-toolkit --skill draw-io -g -y
针对Excalidraw文件Token消耗大、信噪比低的问题，规定主Agent绝不直接读取，而是委派给子Agent处理。涵盖读取、修改和创建图表场景，通过隔离上下文防止预算耗尽。
涉及.excalidraw或.excalidraw.json文件操作
用户请求解释、更新或创建架构图/流程图
提及flowchart、architecture diagram等可视化需求
npx skills add softaworks/agent-toolkit --skill excalidraw -g -y
提供职场困难对话和反馈的结构化框架，包括准备-交付-跟进模型及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'或高影响力功能
询问'什么能让它变得好10倍'
讨论产品策略或下一步该构建什么
npx skills add softaworks/agent-toolkit --skill game-changing-features -g -y
指导调用 Gemini CLI 进行代码审查、架构计划分析及大上下文（>200k token）处理。强调在自动化场景中必须使用 yolo 模式避免挂起，并指导模型选择与命令组装。
用户请求代码审查
用户请求分析技术文档或架构规划
需要处理超大上下文窗口
npx skills add softaworks/agent-toolkit --skill gemini -g -y
用于功能实施前的详细规划，通过研究、访谈和规格综合生成结构化实施计划。
需要制定详细的实施计划
进行新功能的多阶段前期分析
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
通过自然语言与 Jira 交互，支持 CLI 和 MCP 后端。涵盖查看、创建、更新工单及 Sprint 状态管理，自动检测可用工具并引导用户完成操作。
提及 Jira issue 或 ticket
请求创建/查看/更新工单
询问 Sprint 状态
包含 PROJ-123 等 Issue Key
npx skills add softaworks/agent-toolkit --skill jira -g -y
通过Git历史分析代码变更，提取软件工程原则与教训。支持按分支、提交或工作区范围分析，结合SE原则库生成结构化反思报告，帮助用户从实际代码中总结经验并指导未来开发。
用户询问'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种主题及自定义样式。适用于制作幻灯片、讲座材料及改善设计外观的场景。
请求创建演示文稿或 Marp 文档
要求美化幻灯片或改进设计
npx skills add softaworks/agent-toolkit --skill marp-slide -g -y
调用 memegen.link API 生成 meme，支持自定义模板、文本及样式，适用于社交媒体配图或内容幽默化。
用户请求生成 meme
需要为内容添加幽默元素
需要社交媒体视觉辅助素材
npx skills add softaworks/agent-toolkit --skill meme-factory -g -y
提供 MUI v7 组件库的使用模式，涵盖 sx 属性样式、主题集成、响应式设计及常用组件用法。
使用 MUI 组件进行开发
通过 sx prop 设置样式
配置或自定义 MUI 主题
实现响应式布局
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 的网络搜索与研究能力，支持通用查询、资源查找及概念解释。明确区分于文档检索和内部工作区问题，规范了 Search、Ask 及 Researcher agent 的使用场景与参数配置。
用户发起通用网络搜索
查找最新技术资讯或最佳实践
寻求概念的解释或综合回答
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工程师设计的技能，用于生成测试计划、手动测试用例、回归测试套件及Bug报告。支持Figma设计验证，提供从需求分析到交付物生成的全流程自动化辅助。
需要制定功能测试策略或计划时
请求生成特定功能的测试用例或回归套件时
需要对比UI实现与Figma设计稿差异时
要求创建结构化的Bug报告时
npx skills add softaworks/agent-toolkit --skill qa-test-planner -g -y
提供React与TypeScript类型安全开发指南，涵盖组件、Hooks、事件及路由的类型定义。重点指导React 19新特性（如useActionState、use）的迁移与使用模式。
构建带类型的React组件
React 19特性迁移
TypeScript事件处理
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供React useEffect最佳实践，指导在派生值、数据获取或状态同步时正确使用Effect，并强调避免滥用及推荐替代方案。
编写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文档，确保实现前需求明确。
需求描述模糊或缺失技术上下文
功能复杂度高或涉及跨团队协作
缺少明确的验收标准和成功指标
npx skills add softaworks/agent-toolkit --skill requirements-clarity -g -y
将学习材料转化为可执行的Ship-Learn-Next行动计划，通过SHIP、LEARN、NEXT循环指导用户从被动学习转向具体实践和迭代。
用户提供教程或文章并要求制定实施计划
询问如何将学到的知识转化为具体行动步骤
npx skills add softaworks/agent-toolkit --skill ship-learn-next -g -y
评估 Agent Skill 设计质量，基于官方规范与最佳实践。提供多维度打分及改进建议，核心关注知识增量、结构与可用性，旨在优化 SKILL.md 文件。
审查或审计 SKILL.md 文件
提升技能包质量
npx skills add softaworks/agent-toolkit --skill skill-judge -g -y
通过本地web2md CLI工具将网页URL转换为干净的Markdown格式，支持JS渲染页面、内容提取及多种输出选项。
用户明确要求使用 web-to-markdown 技能
需要将网页内容转换为 Markdown 文本
npx skills add softaworks/agent-toolkit --skill web-to-markdown -g -y
基于《风格的要素》规则，辅助生成清晰、简洁、专业的技术文档、提交信息、错误提示及UI文案，并规避AI常见冗余表达。
编写技术文档或README
撰写Git提交信息
优化错误消息或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语法的全面指南，用于创建类图、时序图、流程图等软件图表。适用于可视化系统架构、数据库设计、代码结构及用户流程，支持版本控制与文档维护。
需要创建或可视化软件架构图
请求绘制数据库Schema或ERD
解释API交互或代码执行流程
使用diagram, visualize, model等关键词
npx skills add softaworks/agent-toolkit --skill mermaid-diagrams -g -y
用于生成AI会话交接文档，解决上下文耗尽问题。支持创建、验证及恢复工作流，确保新Agent能无缝继续任务。
用户请求保存状态或暂停工作
上下文窗口接近容量
重大任务里程碑完成
工作会话结束
用户说save state, create handoff, I need to pause等
用户说load handoff, resume from, continue where we left off
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
