重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
box-automation by sickn33/antigravity-awesome-skills
npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill box-automation通过 Composio 的 Box 工具包,自动化 Box 操作,包括文件上传/下载、内容搜索、文件夹管理、协作、元数据查询和签名请求。
RUBE_SEARCH_TOOLS 可用)RUBE_MANAGE_CONNECTIONS 建立活跃的 Box 连接,并指定工具包 boxRUBE_SEARCH_TOOLS 以获取当前工具模式获取 Rube MCP:在您的客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加端点即可工作。
RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 是否可用box 调用 广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
RUBE_MANAGE_CONNECTIONS使用场景:用户想要上传文件到 Box 或从 Box 下载文件
工具调用顺序:
BOX_SEARCH_FOR_CONTENT - 如果路径未知,查找目标文件夹 [前提]BOX_GET_FOLDER_INFORMATION - 验证文件夹是否存在并获取 folder_id [前提]BOX_LIST_ITEMS_IN_FOLDER - 浏览文件夹内容并发现文件 ID [可选]BOX_UPLOAD_FILE - 将文件上传到特定文件夹 [上传所需]BOX_DOWNLOAD_FILE - 通过 file_id 下载文件 [下载所需]BOX_CREATE_ZIP_DOWNLOAD - 将多个文件/文件夹打包成 zip [可选]关键参数:
parent_id:上传目标文件夹的 ID(根文件夹使用 "0")file:用于上传的 FileUploadable 对象,包含 s3key、mimetype 和 namefile_id:用于下载的唯一文件标识符version:用于下载特定版本的可选文件版本 IDfields:要返回的属性列表,以逗号分隔注意事项:
attributes 部分必须在 file 部分之前,否则会收到 HTTP 400 错误,提示 metadata_after_file_contentshttps://*.app.box.com/files/123 给出 file_id "123")使用场景:用户希望通过名称、内容或元数据查找文件、文件夹或网页链接
工具调用顺序:
BOX_SEARCH_FOR_CONTENT - 跨文件、文件夹和网页链接进行全文搜索 [必需]BOX_LIST_ITEMS_IN_FOLDER - 浏览特定文件夹的内容 [可选]BOX_GET_FILE_INFORMATION - 获取特定文件的详细元数据 [可选]BOX_GET_FOLDER_INFORMATION - 获取特定文件夹的详细元数据 [可选]BOX_QUERY_FILES_FOLDERS_BY_METADATA - 通过元数据模板值搜索 [可选]BOX_LIST_RECENTLY_ACCESSED_ITEMS - 列出最近访问的项目 [可选]关键参数:
query:支持操作符的搜索字符串("" 精确匹配,AND、OR、NOT - 仅大写)type:按 "file"、"folder" 或 "web_link" 过滤ancestor_folder_ids:将搜索限制在特定文件夹(逗号分隔的 ID)file_extensions:按文件类型过滤(逗号分隔,不带点号)content_types:在 "name"、"description"、"file_content"、"comments"、"tags" 中搜索created_at_range / updated_at_range:日期过滤器,使用逗号分隔的 RFC3339 时间戳limit:每页结果数(默认 30)offset:分页偏移量(最大 10000)folder_id:用于 LIST_ITEMS_IN_FOLDER(根目录使用 "0")注意事项:
BOX_SEARCH_FOR_CONTENT 需要 query 或 mdfilters 参数AND、OR、NOT)必须大写BOX_LIST_ITEMS_IN_FOLDER 需要通过 marker 或 offset/usemarker 进行分页;部分列表很常见使用场景:用户想要创建、更新、移动、复制或删除文件夹
工具调用顺序:
BOX_GET_FOLDER_INFORMATION - 验证文件夹是否存在并检查权限 [前提]BOX_CREATE_FOLDER - 创建新文件夹 [创建所需]BOX_UPDATE_FOLDER - 重命名、移动或更新文件夹设置 [更新所需]BOX_COPY_FOLDER - 将文件夹复制到新位置 [可选]BOX_DELETE_FOLDER - 将文件夹移至回收站 [删除所需]BOX_PERMANENTLY_REMOVE_FOLDER - 永久删除回收站中的文件夹 [可选]关键参数:
name:文件夹名称(不能包含 /、\、尾随空格或 ./..)parent__id:父文件夹 ID(根目录使用 "0")folder_id:操作的目标文件夹 IDparent.id:通过 BOX_UPDATE_FOLDER 移动时的目标文件夹 IDrecursive:设置为 true 以删除非空文件夹shared_link:用于在文件夹上创建共享链接的对象,包含 access、password、permissionsdescription、tags:可选的元数据字段注意事项:
BOX_DELETE_FOLDER 默认移至回收站;使用 BOX_PERMANENTLY_REMOVE_FOLDER 进行永久删除recursive: true"0")无法复制或删除/、\、不可打印的 ASCII 字符或尾随空格BOX_UPDATE_FOLDER 设置 parent.id使用场景:用户想要共享文件、管理访问权限或处理协作
工具调用顺序:
BOX_GET_FILE_INFORMATION - 获取文件详情和当前共享状态 [前提]BOX_LIST_FILE_COLLABORATIONS - 列出谁有权访问文件 [必需]BOX_UPDATE_COLLABORATION - 更改访问级别或接受/拒绝邀请 [必需]BOX_GET_COLLABORATION - 获取特定协作的详细信息 [可选]BOX_UPDATE_FILE - 创建共享链接、锁定文件或更新权限 [可选]BOX_UPDATE_FOLDER - 在文件夹上创建共享链接 [可选]关键参数:
collaboration_id:唯一的协作标识符role:访问级别("editor"、"viewer"、"co-owner"、"owner"、"previewer"、"uploader"、"viewer uploader"、"previewer uploader")status:协作邀请的状态,"accepted"、"pending" 或 "rejected"file_id:要共享或管理的文件lock__access:设置为 "lock" 以锁定文件permissions__can__download:下载权限,"company" 或 "open"注意事项:
can_view_path 会增加受邀者"所有文件"页面的加载时间;每个用户限制在 1000 个以内lock__access、parent__id)使用场景:用户想要管理文档签名请求
工具调用顺序:
BOX_LIST_BOX_SIGN_REQUESTS - 列出所有签名请求 [必需]BOX_GET_BOX_SIGN_REQUEST_BY_ID - 获取特定签名请求的详细信息 [可选]BOX_CANCEL_BOX_SIGN_REQUEST - 取消待处理的签名请求 [可选]关键参数:
sign_request_id:签名请求的 UUIDshared_requests:设置为 true 以包含用户是协作者(非所有者)的请求senders:按发件人邮箱过滤(需要 shared_requests: true)limit / marker:分页参数注意事项:
converting、created、sent、viewed、signed、declined、cancelled、expired、error_converting、error_sendingBox 对所有实体使用数字字符串 ID:
"0"https://*.app.box.com/files/123 给出 file_id "123"https://*.app.box.com/folder/123 给出 folder_id "123"BOX_SEARCH_FOR_CONTENT 查找项目,然后从结果中提取 IDif_match 和文件的 ETag 进行安全的并发删除操作Box 支持两种分页方法:
offset + limit(最大偏移量 10000)usemarker: true 并遵循响应中的 marker(大数据集首选)Box 工具使用双下划线表示法表示嵌套对象:
parent__id 用于父文件夹引用lock__access、lock__expires__at、lock__is__download__prevented 用于文件锁定permissions__can__download 用于下载权限"123456",不是整数)"0"fields 参数会改变响应结构:指定时,只返回精简表示和请求的字段query 或 mdfilters;两者各自可选,但必须存在一个BOX_UPDATE_FILE 将 lock 设置为 null 会移除锁定(仅限原始 API)from 字段格式:enterprise_{enterprise_id}.templateKey 或 global.templateKey| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 搜索内容 | BOX_SEARCH_FOR_CONTENT | query, type, ancestor_folder_ids |
| 列出文件夹项目 | BOX_LIST_ITEMS_IN_FOLDER | folder_id, limit, marker |
| 获取文件信息 | BOX_GET_FILE_INFORMATION | file_id, fields |
| 获取文件夹信息 | BOX_GET_FOLDER_INFORMATION | folder_id, fields |
| 上传文件 | BOX_UPLOAD_FILE | file, parent_id |
| 下载文件 | BOX_DOWNLOAD_FILE | file_id |
| 创建文件夹 | BOX_CREATE_FOLDER | name, parent__id |
| 更新文件夹 | BOX_UPDATE_FOLDER | folder_id, name, parent |
| 复制文件夹 | BOX_COPY_FOLDER | folder_id, parent__id |
| 删除文件夹 | BOX_DELETE_FOLDER | folder_id, recursive |
| 永久删除文件夹 | BOX_PERMANENTLY_REMOVE_FOLDER | folder_id |
| 更新文件 | BOX_UPDATE_FILE | file_id, name, parent__id |
| 删除文件 | BOX_DELETE_FILE | file_id, if_match |
| 列出协作 | BOX_LIST_FILE_COLLABORATIONS | file_id |
| 更新协作 | BOX_UPDATE_COLLABORATION | collaboration_id, role |
| 获取协作 | BOX_GET_COLLABORATION | collaboration_id |
| 按元数据查询 | BOX_QUERY_FILES_FOLDERS_BY_METADATA | from, ancestor_folder_id, query |
| 列出收藏集 | BOX_LIST_ALL_COLLECTIONS | (none) |
| 列出收藏集项目 | BOX_LIST_COLLECTION_ITEMS | collection_id |
| 列出签名请求 | BOX_LIST_BOX_SIGN_REQUESTS | limit, marker |
| 获取签名请求 | BOX_GET_BOX_SIGN_REQUEST_BY_ID | sign_request_id |
| 取消签名请求 | BOX_CANCEL_BOX_SIGN_REQUEST | sign_request_id |
| 最近项目 | BOX_LIST_RECENTLY_ACCESSED_ITEMS | (none) |
| 创建 zip 下载 | BOX_CREATE_ZIP_DOWNLOAD | 项目 ID |
此技能适用于执行概述中描述的工作流或操作。
每周安装量
51
代码仓库
GitHub 星标数
29.5K
首次出现
2026年2月15日
安全审计
安装于
codex50
opencode50
github-copilot49
kimi-cli49
gemini-cli49
amp49
Automate Box operations including file upload/download, content search, folder management, collaboration, metadata queries, and sign requests through Composio's Box toolkit.
RUBE_MANAGE_CONNECTIONS with toolkit boxRUBE_SEARCH_TOOLS first to get current tool schemasGet Rube MCP : Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
RUBE_SEARCH_TOOLS respondsRUBE_MANAGE_CONNECTIONS with toolkit boxWhen to use : User wants to upload files to Box or download files from it
Tool sequence :
BOX_SEARCH_FOR_CONTENT - Find the target folder if path is unknown [Prerequisite]BOX_GET_FOLDER_INFORMATION - Verify folder exists and get folder_id [Prerequisite]BOX_LIST_ITEMS_IN_FOLDER - Browse folder contents and discover file IDs [Optional]BOX_UPLOAD_FILE - Upload a file to a specific folder [Required for upload]BOX_DOWNLOAD_FILE - Download a file by file_id [Required for download]BOX_CREATE_ZIP_DOWNLOAD - Bundle multiple files/folders into a zip [Optional]Key parameters :
parent_id: Folder ID for upload destination (use "0" for root folder)file: FileUploadable object with s3key, mimetype, and name for uploadsfile_id: Unique file identifier for downloadsversion: Optional file version ID for downloading specific versionsfields: Comma-separated list of attributes to returnPitfalls :
attributes part of upload must come before the file part or you get HTTP 400 with metadata_after_file_contentshttps://*.app.box.com/files/123 gives file_id "123")When to use : User wants to find files, folders, or web links by name, content, or metadata
Tool sequence :
BOX_SEARCH_FOR_CONTENT - Full-text search across files, folders, and web links [Required]BOX_LIST_ITEMS_IN_FOLDER - Browse contents of a specific folder [Optional]BOX_GET_FILE_INFORMATION - Get detailed metadata for a specific file [Optional]BOX_GET_FOLDER_INFORMATION - Get detailed metadata for a specific folder [Optional]BOX_QUERY_FILES_FOLDERS_BY_METADATA - Search by metadata template values [Optional]BOX_LIST_RECENTLY_ACCESSED_ITEMS - List recently accessed items [Optional]Key parameters :
query: Search string supporting operators ("" exact match, AND, OR, NOT - uppercase only)type: Filter by "file", "folder", or "web_link"ancestor_folder_ids: Limit search to specific folders (comma-separated IDs)file_extensions: Filter by file type (comma-separated, no dots)Pitfalls :
BOX_SEARCH_FOR_CONTENT requires either query or mdfilters parameterAND, OR, NOT) must be uppercaseBOX_LIST_ITEMS_IN_FOLDER requires pagination via marker or offset/usemarker; partial listings are commonWhen to use : User wants to create, update, move, copy, or delete folders
Tool sequence :
BOX_GET_FOLDER_INFORMATION - Verify folder exists and check permissions [Prerequisite]BOX_CREATE_FOLDER - Create a new folder [Required for create]BOX_UPDATE_FOLDER - Rename, move, or update folder settings [Required for update]BOX_COPY_FOLDER - Copy a folder to a new location [Optional]BOX_DELETE_FOLDER - Move folder to trash [Required for delete]BOX_PERMANENTLY_REMOVE_FOLDER - Permanently delete a trashed folder [Optional]Key parameters :
name: Folder name (no /, \, trailing spaces, or ./..)parent__id: Parent folder ID (use "0" for root)folder_id: Target folder ID for operationsparent.id: Destination folder ID for moves via BOX_UPDATE_FOLDERrecursive: Set to delete non-empty foldersPitfalls :
BOX_DELETE_FOLDER moves to trash by default; use BOX_PERMANENTLY_REMOVE_FOLDER for permanent deletionrecursive: true for deletion"0") cannot be copied or deleted/, \, non-printable ASCII, or trailing spacesparent.id via BOX_UPDATE_FOLDERWhen to use : User wants to share files, manage access, or handle collaborations
Tool sequence :
BOX_GET_FILE_INFORMATION - Get file details and current sharing status [Prerequisite]BOX_LIST_FILE_COLLABORATIONS - List who has access to a file [Required]BOX_UPDATE_COLLABORATION - Change access level or accept/reject invitations [Required]BOX_GET_COLLABORATION - Get details of a specific collaboration [Optional]BOX_UPDATE_FILE - Create shared links, lock files, or update permissions [Optional]BOX_UPDATE_FOLDER - Create shared links on folders [Optional]Key parameters :
collaboration_id: Unique collaboration identifierrole: Access level ("editor", "viewer", "co-owner", "owner", "previewer", "uploader", "viewer uploader", "previewer uploader")status: , , or for collaboration invitesPitfalls :
can_view_path increases load time for the invitee's "All Files" page; limit to 1000 per userlock__access, parent__id)When to use : User wants to manage document signature requests
Tool sequence :
BOX_LIST_BOX_SIGN_REQUESTS - List all signature requests [Required]BOX_GET_BOX_SIGN_REQUEST_BY_ID - Get details of a specific sign request [Optional]BOX_CANCEL_BOX_SIGN_REQUEST - Cancel a pending sign request [Optional]Key parameters :
sign_request_id: UUID of the sign requestshared_requests: Set true to include requests where user is a collaborator (not owner)senders: Filter by sender emails (requires shared_requests: true)limit / marker: Pagination parametersPitfalls :
converting, created, sent, viewed, signed, declined, cancelled, expired, error_converting, error_sendingBox uses numeric string IDs for all entities:
"0"https://*.app.box.com/files/123 gives file_id "123"https://*.app.box.com/folder/123 gives folder_id "123"BOX_SEARCH_FOR_CONTENT to find items, then extract IDs from resultsif_match with file's ETag for safe concurrent delete operationsBox supports two pagination methods:
offset + limit (max offset 10000)usemarker: true and follow marker from responses (preferred for large datasets)Box tools use double underscore notation for nested objects:
parent__id for parent folder referencelock__access, lock__expires__at, lock__is__download__prevented for file lockspermissions__can__download for download permissions"123456", not integers)"0"fields parameter changes response shape: when specified, only mini representation + requested fields are returnedquery or mdfilters; both are optional individually but one must be presentBOX_UPDATE_FILE with lock set to null removes the lock (raw API only)from field format: enterprise_{enterprise_id}.templateKey or global.templateKey| Task | Tool Slug | Key Params |
|---|---|---|
| Search content | BOX_SEARCH_FOR_CONTENT | query, type, ancestor_folder_ids |
| List folder items | BOX_LIST_ITEMS_IN_FOLDER | folder_id, limit, marker |
This skill is applicable to execute the workflow or actions described in the overview.
Weekly Installs
51
Repository
GitHub Stars
29.5K
First Seen
Feb 15, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex50
opencode50
github-copilot49
kimi-cli49
gemini-cli49
amp49
Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU
127,000 周安装
content_types: Search in "name", "description", "file_content", "comments", "tags"created_at_range / updated_at_range: Date filters as comma-separated RFC3339 timestampslimit: Results per page (default 30)offset: Pagination offset (max 10000)folder_id: For LIST_ITEMS_IN_FOLDER (use "0" for root)trueshared_link: Object with access, password, permissions for creating shared links on foldersdescription, tags: Optional metadata fields"accepted""pending""rejected"file_id: File to share or managelock__access: Set to "lock" to lock a filepermissions__can__download: "company" or "open" for download permissions| Get file info | BOX_GET_FILE_INFORMATION | file_id, fields |
| Get folder info | BOX_GET_FOLDER_INFORMATION | folder_id, fields |
| Upload file | BOX_UPLOAD_FILE | file, parent_id |
| Download file | BOX_DOWNLOAD_FILE | file_id |
| Create folder | BOX_CREATE_FOLDER | name, parent__id |
| Update folder | BOX_UPDATE_FOLDER | folder_id, name, parent |
| Copy folder | BOX_COPY_FOLDER | folder_id, parent__id |
| Delete folder | BOX_DELETE_FOLDER | folder_id, recursive |
| Permanently delete folder | BOX_PERMANENTLY_REMOVE_FOLDER | folder_id |
| Update file | BOX_UPDATE_FILE | file_id, name, parent__id |
| Delete file | BOX_DELETE_FILE | file_id, if_match |
| List collaborations | BOX_LIST_FILE_COLLABORATIONS | file_id |
| Update collaboration | BOX_UPDATE_COLLABORATION | collaboration_id, role |
| Get collaboration | BOX_GET_COLLABORATION | collaboration_id |
| Query by metadata | BOX_QUERY_FILES_FOLDERS_BY_METADATA | from, ancestor_folder_id, query |
| List collections | BOX_LIST_ALL_COLLECTIONS | (none) |
| List collection items | BOX_LIST_COLLECTION_ITEMS | collection_id |
| List sign requests | BOX_LIST_BOX_SIGN_REQUESTS | limit, marker |
| Get sign request | BOX_GET_BOX_SIGN_REQUEST_BY_ID | sign_request_id |
| Cancel sign request | BOX_CANCEL_BOX_SIGN_REQUEST | sign_request_id |
| Recent items | BOX_LIST_RECENTLY_ACCESSED_ITEMS | (none) |
| Create zip download | BOX_CREATE_ZIP_DOWNLOAD | item IDs |