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 指令文件，遵循渐进式披露原则。通过识别矛盾、提取核心内容、分类归档和创建链接结构，将单体文件拆分为组织良好的文档体系，提升可读性与维护性。
用户要求重构 AGENTS.md 或 CLAUDE.md 等指令文件
指令文件过于冗长需要拆分或整理
希望实现指令的渐进式披露
npx skills add softaworks/agent-toolkit --skill agent-md-refactor -g -y
为前端生成API交接文档，提供接口、DTO及业务上下文，助力前端快速集成。
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 执行代码分析、重构或自动化编辑任务。支持选择模型、沙箱模式及推理强度，默认使用 gpt-5.2，并处理会话恢复与输出过滤。
用户请求运行 Codex CLI 命令
引用 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规范的提交信息。
用户请求提交代码
生成或优化提交信息
暂存特定变更
将工作拆分为多个提交
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数据库架构，提供规范化指南、索引策略、迁移模式及性能优化建议，确保数据完整性与查询效率。
用户需要设计新的数据库表结构
询问数据库范式或索引优化策略
请求生成特定业务场景的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设计系统。提供设计令牌、组件架构、主题支持和WCAG合规指南，确保跨产品的视觉统一性与可访问性。
创建设计系统
设置设计令牌
设计组件架构
确保无障碍合规
实现暗色模式
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 消耗而耗尽上下文。适用于图表创建、修改及架构可视化任务。
文件路径包含 .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
用于前端开发人员向后端明确数据需求与交互规范的文档化工具，聚焦UI展示所需的数据、操作及状态，避免涉及具体实现细节。
用户描述界面数据需求
沟通API需求
提及'backend requirements'
询问需要哪些数据
npx skills add softaworks/agent-toolkit --skill frontend-to-backend-requirements -g -y
作为产品战略家，协助用户发掘具有10倍影响力的产品机会和高杠杆改进方案。通过评估当前价值、寻找不同规模的机会并严格筛选，专注于制定能显著提升产品价值的非增量式策略，而非具体代码实现。
用户希望进行战略性产品思考
提到 '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 进行代码审查、计划审查及大上下文处理。支持多模型选择与审批模式配置，特别强调在后台或非交互环境中使用 yolo 模式避免挂起，确保自动化任务稳定执行。
用户请求进行代码审查
需要分析大型代码库或长上下文
npx skills add softaworks/agent-toolkit --skill gemini -g -y
Gepetto是一个多步骤AI辅助实施规划技能，通过研究、访谈、规格合成、计划制定及外部审查，生成详细的分段化实现计划。
需要为功能特性创建详细的预实施分析
启动或恢复基于Markdown规格文件的复杂规划流程
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
提供Jira问题的自然语言交互能力，支持通过CLI或MCP后端创建、查看、更新问题及管理Sprint。自动检测可用后端并引导用户完成操作，涵盖工单生命周期管理及状态流转。
提及Jira issue或ticket
包含PROJ-123等issue key模式
询问sprint状态或backlog
要求创建、查看或更新问题
npx skills add softaworks/agent-toolkit --skill jira -g -y
通过 Git 历史分析代码变更，提取软件工程原则与经验教训。适用于反思代码、总结最佳实践或从近期工作中学习工程启示的场景。
用户询问 'what is the lesson here?'
用户希望从代码变更中提取原则
用户请求反思代码 ('reflect on this code')
用户想知道 'what can I learn from this?'
npx skills add softaworks/agent-toolkit --skill lesson-learned -g -y
用于创建专业Marp演示文稿的Skill，支持7种主题及自定义设计。当用户请求制作幻灯片、改善排版或生成讲座材料时触发，自动优化视觉效果并保存为Markdown文件。
创建演示文稿
改善幻灯片设计
生成讲座或研讨会材料
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 属性样式、主题集成、响应式设计及 Hooks。适用于 Material-UI 组件开发、样式定制及布局构建场景。
使用 MUI 组件进行 UI 开发
通过 sx prop 或主题配置样式
处理 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 JSON/YAML 规范转换为 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 的通用网络搜索与研究工具，支持搜索结果获取、对话式问答及深度研究。用于查找最新资讯、教程或解释概念，明确排除库文档和内部工作区查询场景。
用户说 search, find, look up, ask, research 或 what's the latest
需要查找通用资源、最佳实践或最新趋势
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设计验证，提供从需求分析到交付物生成的全流程自动化辅助。
需要创建或优化测试计划时
生成手动测试用例或回归测试套件时
进行UI设计与实现的一致性校验时
编写结构化的Bug报告时
npx skills add softaworks/agent-toolkit --skill qa-test-planner -g -y
提供React组件与TypeScript的类型安全开发指南，涵盖React 18-19特性、事件处理及路由集成。
构建React组件
使用React TypeScript
处理React事件类型
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供 React useEffect 最佳实践，指导何时使用及避免使用 Effect，涵盖派生状态、数据获取等场景的替代方案。
编写或审查 useEffect 逻辑
处理 derived values 的数据获取与状态同步
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文件。提供知识增量、评分及改进建议，旨在优化技能包的专业性和效率。
审查Agent Skill设计质量
审计SKILL.md文件内容
优化Skill包以提升专家知识密度
npx skills add softaworks/agent-toolkit --skill skill-judge -g -y
通过本地 web2md CLI 将网页 URL 转换为干净的 Markdown，支持 JS 渲染页面。需显式触发，收集 URL 及输出偏好后执行转换并验证结果。
用户明确输入 'use the skill web-to-markdown'
用户明确输入 'use a skill web-to-markdown'
npx skills add softaworks/agent-toolkit --skill web-to-markdown -g -y
提供清晰简洁的写作指导，基于Strunk风格规则，适用于文档、提交信息、错误消息及UI文案等人类阅读内容的撰写与编辑。
撰写技术文档或README
编写Git提交信息
优化错误提示或用户界面文案
提升文本清晰度与专业性
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代理会话交接文档，解决上下文耗尽问题。支持保存状态、暂停工作或恢复进度，确保新代理能无缝继续工作。
用户请求保存状态或创建交接
上下文窗口接近容量
重大任务里程碑完成
工作会话结束
用户说'save state'或'create handoff'
用户说'load handoff'或'resume from'
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
