Agent Skills
› softaworks/agent-toolkit
softaworks/agent-toolkit
GitHub重构臃肿的 Agent 指令文件（如 AGENTS.md），遵循渐进式披露原则，将内容拆分为根目录核心指令与分类链接文件，提升可读性与维护性。
安装全部 Skills
npx skills add softaworks/agent-toolkit --all -g -y
集合内 Skills (43)
重构臃肿的 Agent 指令文件（如 AGENTS.md），遵循渐进式披露原则，将内容拆分为根目录核心指令与分类链接文件，提升可读性与维护性。
用户要求重构或拆分 AGENTS.md/CLAUDE.md
指令文件过长需要整理
清理 Agent 配置
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语法软件架构文档，涵盖上下文、容器、组件及部署图。适用于系统结构可视化、架构记录及复杂工作流展示，辅助不同受众理解系统设计。
创建架构图
记录系统架构
可视化软件结构
生成C4图
绘制上下文/容器/组件/部署图
npx skills add softaworks/agent-toolkit --skill c4-architecture -g -y
指导如何运行 OpenAI Codex CLI，涵盖模型选择、沙箱模式配置及会话恢复。适用于代码分析、重构和自动化编辑任务。
用户请求使用 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提交，包括审查和暂存更改、拆分逻辑提交及撰写符合规范的提交信息。
用户请求提交代码
需要拆分多个提交
生成或优化提交信息
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会话历史作为上下文，辅助用户快速整理昨日工作、今日计划及阻塞项。
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工具，用于搜索日志、查询指标、追踪请求及管理仪表盘。适用于调试生产问题、排查错误及进行可观测性数据分析。
调试生产环境问题
查询系统日志和指标
追踪分布式请求链路
管理监控仪表盘
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
该技能协助用户为项目生成创意域名名称，并检查其在多种顶级域（如.com, .io, .ai）上的注册可用性。通过分析项目特点提供品牌建议、替代方案及命名理由，节省头脑风暴和手动查询的时间。
为新项目或公司寻找域名
产品发布或重新品牌化时选择域名
查询特定关键词的域名可用性
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 消耗的 JSON，防止上下文溢出。适用于图表创建、修改及架构可视化任务。
操作 *.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
作为产品策略师，通过10x思维模式挖掘高杠杆、变革性的产品机会。分析当前价值，从大规模、中等规模和小规模三个维度寻找能显著提升用户依赖度和产品价值的功能，并进行严格评估。
用户希望进行战略性产品思考
提及 '10x' 或 'high-leverage'
询问 '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 使用指南，涵盖代码审查、计划分析及大上下文处理场景。指导模型选择、审批模式配置及后台任务防挂起策略，确保自动化执行稳定性。
用户请求进行代码审查
需要分析大型项目架构或技术规划
处理超过20万token的大上下文数据
npx skills add softaworks/agent-toolkit --skill gemini -g -y
Gepetto 是一个多步骤实施规划技能，通过研究、访谈、规格综合、计划制定及外部评审，生成结构化的实现方案。适用于需要深入前期分析的功能规划场景。
用户请求创建详细的实施计划
需要进行功能特性的前期分析与调研
提供 .md 规格文件以启动或恢复规划流程
npx skills add softaworks/agent-toolkit --skill gepetto -g -y
通过自然语言交互管理Jira事务，支持CLI和MCP后端。可创建、查看、更新工单，检查Sprint状态及工作流操作，自动检测可用工具并引导用户完成设置。
提及Jira问题或工单号
询问或管理Sprint/Backlog状态
需要创建、查看或更新Issue
npx skills add softaworks/agent-toolkit --skill jira -g -y
通过Git历史分析代码变更，提取软件工程原则与教训。适用于反思代码、总结经验或从近期工作中获取工程启示的场景。
询问代码中的教训或学习点
要求对代码变更进行反思
希望从近期开发中提取工程原则
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
提供 Material-UI v7 组件使用、sx 属性样式编写、主题集成及响应式设计模式。适用于 MUI 组件开发、样式定制及工具函数调用场景。
需要创建或修改 MUI 组件
使用 sx prop 进行内联样式定义
配置或自定义 MUI 主题
处理 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 接口和类型守卫，支持从 JSON/YAML 文件生成 API 类型定义。
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 深度研究，并明确排除代码文档和内部工作区查询场景。
用户说 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
提供软件开发者专业沟通指南，涵盖邮件、团队消息、会议议程及受众适配。包含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新特性（如useActionState、Server Components），支持TanStack Router等路由集成。
构建React组件
使用React 19新特性
React TypeScript类型定义
自定义Hooks类型化
npx skills add softaworks/agent-toolkit --skill react-dev -g -y
提供React useEffect最佳实践，指导何时使用或避免Effect，涵盖派生状态、数据获取及外部系统同步等场景，推荐useMemo等替代方案。
编写或审查React useEffect逻辑
处理派生状态与副作用同步
优化React组件性能
npx skills add softaworks/agent-toolkit --skill react-useeffect -g -y
专注于最小化代码库规模的技能，通过删除冗余代码、避免过度设计和遵循YAGNI原则来减少熵。仅在用户明确要求时激活，以最终代码量而非开发工作量作为成功衡量标准。
用户明确请求减少代码量
需要重构以消除冗余功能
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 渲染页面、交互式验证及多种输出方式，需用户显式调用。
用户明确请求使用 web-to-markdown skill
需要将网页内容提取为 Markdown 格式
npx skills add softaworks/agent-toolkit --skill web-to-markdown -g -y
基于《风格要素》规则，用于优化面向人类的文本写作与编辑，涵盖文档、提交信息、错误提示等。提供精简上下文策略以避免AI生成冗余内容，强调主动语态和简洁表达。
编写或优化技术文档和README
撰写代码提交信息和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 语法创建各类软件图表的综合指南，支持类图、时序图、流程图、ERD、C4架构等。适用于系统架构可视化、数据库设计、代码结构文档化及业务流程映射等场景。
用户请求创建或可视化软件图表
需要解释系统架构、数据库设计或代码结构
请求展示数据流、用户旅程或算法逻辑
npx skills add softaworks/agent-toolkit --skill mermaid-diagrams -g -y
用于生成AI代理会话交接文档，支持创建、验证和恢复工作上下文。解决长会话上下文耗尽问题，确保新代理能无缝续接任务，包含状态总结、关键决策及下一步行动指引。
用户请求保存上下文或暂停工作
上下文窗口接近容量
完成重大任务里程碑
提及加载或继续之前的工作
npx skills add softaworks/agent-toolkit --skill session-handoff -g -y
