用途:@tanstack/ai-skills 为 TanStack AI 提供可移植的 Agent Skills(SKILL.md),让工具调用模型按需加载技能库,适用于任意提供商且无需服务器沙箱。它区别于在提供商沙箱中按 ID 运行的托管 Provider Skills(codeExecutionTool / shellTool),二者不可混用于同一次 chat() 调用:若同一调用中携带 skills 的 code_execution/shell 工具,withSkills 会抛错。
主要能力:withSkills 会向系统提示加入技能目录,并添加一个名称受限于技能名的 load_skill 工具;对 Anthropic 模型渲染 <available_skills> XML,其余渲染 markdown;同会话重复加载返回“已加载”标记。技能来源(SkillSource)只处理字节、不假设文件系统,因此中间件可在边缘运行:inlineSkill 用于代码或数据库行;skillDirectory 从 @tanstack/ai-skills/node 遍历目录中的 SKILL.md(默认严格);staticSkills 通过 Vite 的 skillsCatalogPlugin 打包,.names 为类型化联合。可结合 aggregate、dedupe、filter、cache;withSkills([a, b]) 是 dedupe(aggregate([a, b])) 的语法糖;单一来源不会自动包装。
使用方式:在 chat 中传入 middleware: [withSkills(pptx)];若要让模型读取技能内文件,在 tools 中传 createResourceTool(source),withSkills 会检测并声明 read_skill_resource,越出技能根的路径会被拒绝。
限制:withSkills 只盘点技能的 scripts/ 但不执行脚本,需自行传入执行工具并让技能调用它;托管沙箱技能请改用 codeExecutionTool / shellTool。自定义来源需实现 SkillSource 并用 @tanstack/ai-skills/testing 的一致套件校验。安装命令、价格等信息暂未提供。