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 交接文档，提供完整的业务上下文、端点详情、数据模型及枚举常量，帮助前端快速集成。
后端 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架构文档，支持系统上下文、容器、组件及部署等层级图表。适用于需可视化软件结构、分析代码库关系或输出标准化架构说明的场景。
创建架构图
记录系统架构
可视化软件结构
生成C4图表
绘制上下文/容器/组件/部署图
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提交，包括审查变更、逻辑拆分、使用Patch暂存及编写符合Conventional Commits规范的提交信息。
需要提交代码更改
请求生成或优化提交信息
需要将混合变更拆分为多个逻辑提交
请求暂存特定部分的更改
npx skills add softaworks/agent-toolkit --skill commit-work -g -y
提供撰写和优化README文件的模板与指导，根据项目类型（开源、个人、内部等）和受众定制内容结构，涵盖创建、更新及审查流程。
编写新项目README
优化现有文档
npx skills add softaworks/agent-toolkit --skill crafting-effective-readmes -g -y
交互式每日站会更新生成器，通过四问访谈收集用户进度。自动检测并集成GitHub、Jira及Claude Code历史数据，辅助生成格式化的Markdown汇报内容，提升会议准备效率。
daily standup/meeting update
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数据库模式，提供规范化、索引策略、迁移模式和约束设计，确保数据完整性与查询性能。
design schema
database design
create tables
schema for
model data
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
用于创建和演进设计系统，提供设计令牌、组件架构、无障碍指南及文档模板，确保跨产品的一致性与可访问性。
创建设计系统
设置设计令牌
设计组件架构
确保无障碍合规
实现暗色模式主题
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转换及布局调整指南。涵盖字体设置、坐标计算、设计原则与最佳实践，支持AWS图标使用，确保图表清晰、一致且符合无障碍标准。
需要创建或编辑.drawio文件
需要将drawio转换为PNG图片
需要调整图表元素的坐标或布局
npx skills add softaworks/agent-toolkit --skill draw-io -g -y
规范主Agent通过子代理处理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
前端开发用于向后端文档化数据需求的技能。通过描述界面展示、用户操作及状态，明确UI所需数据和业务规则，但不涉及具体实现细节，促进前后端协作。
frontend needs to communicate API requirements to backend
user says 'backend requirements'
user says 'what data do I need'
user says 'API requirements'
describing data needs for a UI
npx skills add softaworks/agent-toolkit --skill frontend-to-backend-requirements -g -y
专注于寻找十倍产品机会和高杠杆改进的策略性技能。通过深入理解当前价值，从大规模、中等规模和小规模三个维度发掘能带来根本性变革的功能，并严格评估其影响力、覆盖范围和差异化优势，旨在发现让用户离不开的颠覆性功能。
用户希望进行战略性的产品思考
提及 '10x' 或高杠杆改进
询问如何使产品变得更好
讨论产品策略
询问接下来应该构建什么
npx skills add softaworks/agent-toolkit --skill game-changing-features -g -y
指导使用 Gemini CLI 进行代码审查、计划评审及大上下文处理。涵盖模型选择、审批模式配置及后台任务防挂起策略，支持多文件分析。
用户请求代码审查
需要分析大型代码库或文档集
请求架构或技术规格评审
npx skills add softaworks/agent-toolkit --skill gemini -g -y
Gepetto是一个多步骤实施规划技能，通过研究、利益相关者访谈和多LLM审查生成详细的分段实现计划。适用于需要深入前期分析的功能规划场景。
用户请求创建功能实施计划
用户提供规格文件路径进行项目规划
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
通过自然语言与 Jira 交互，支持 CLI 和 MCP 后端。涵盖查看、创建、更新工单及 Sprint 状态管理，自动检测环境并引导用户操作。
提及 Jira 问题或工单编号
询问票证详情
创建/查看/更新问题
检查 Sprint 状态
管理工作流
npx skills add softaworks/agent-toolkit --skill jira -g -y
通过 Git 历史分析代码变更，提取软件工程原则与教训。适用于反思代码、总结经验或从近期工作中获取工程启示的场景。
用户询问 'what is the lesson here?' 或 'what can I learn from this?'
用户希望 'reflect on this code' 或提取近期工作的工程要点
npx skills add softaworks/agent-toolkit --skill lesson-learned -g -y
用于创建专业Marp演示文稿的Skill，支持7种预设主题及自定义设计。当用户请求制作幻灯片、改善排版或生成讲座材料时触发，提供从主题选择到内容结构化的完整指导。
请求创建演示文稿或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 属性样式编写、主题集成及响应式设计等开发模式与最佳实践。
使用 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 接口和类型守卫。支持解析 schemas、路径端点请求响应类型，处理基础类型、枚举及复杂结构映射，并生成带 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 的网络搜索与研究工作流，支持通用查询、资料查找及概念解释。明确区分于库文档和特定工作区工具的使用场景。
用户发起通用网络搜索
查找最新信息或资源
寻求概念解释或研究
npx skills add softaworks/agent-toolkit --skill perplexity -g -y
用于创建、管理和发布Claude Code插件的工具。提供脚本自动生成插件结构、清单及市场注册信息，支持版本升级、组件添加和本地测试，确保插件符合市场规范。
创建新的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 结合开发的类型安全指南，涵盖组件、Hook、事件处理及 React 19 新特性模式。
构建带类型的 React 组件
实现泛型组件或自定义 Hook
处理表单、事件或 Ref 的类型定义
使用 React 19 特性如 Server Components
集成 TanStack Router 或 React Router
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供 React useEffect 最佳实践，指导在编写或审查代码时判断何时使用或避免 Effects，推荐 useMemo、事件处理等替代方案。
编写 React useEffect
审查 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行动计划的技能，引导用户提取核心教训并设计可执行的迭代步骤。
用户希望将教程或文章转化为具体行动计划
用户询问如何基于学习内容制定下一步
npx skills add softaworks/agent-toolkit --skill ship-learn-next -g -y
用于评估 Agent Skill 设计质量，依据官方规范提供多维度评分与改进建议。通过审查 SKILL.md 文件，衡量知识增量，优化技能包结构。
审核 Agent Skill 设计
审计 SKILL.md 文件质量
改进技能包内容
npx skills add softaworks/agent-toolkit --skill skill-judge -g -y
将网页URL转换为Markdown的工具。需显式触发，支持JS渲染页面，通过Puppeteer和Readability提取内容并清理链接，提供打印或保存选项。
用户明确输入 '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写作规则，用于优化人类可读文本（如文档、提交信息、错误提示等）的清晰度与简洁性，避免AI常见套话。
撰写或审查技术文档和README
编写清晰的Git提交信息和PR描述
优化用户界面文案和错误提示信息
提升报告或解释性文字的简洁度
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 语法指南，用于创建各类软件图表如类图、时序图、流程图等。支持代码结构可视化、架构设计及数据建模，适用于文档编写与系统梳理场景。
需要创建或绘制软件架构图
请求可视化代码逻辑或数据关系
解释系统组件交互流程
使用 diagram, visualize, model 等关键词
npx skills add softaworks/agent-toolkit --skill mermaid-diagrams -g -y
该技能用于管理AI Agent会话交接，支持创建和恢复上下文文档。通过脚本生成、填充及验证交接文件，解决长会话上下文耗尽问题，确保新Agent能无缝继续工作。
用户请求保存状态或创建交接文档
上下文窗口接近容量
主要任务里程碑完成
工作会话结束
用户表示需要暂停或上下文已满
用户请求从之前的交接点恢复工作
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
