[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-f8c4d10b-7318-4fdd-90f6-76a36deaa936":3,"$fPWr4EoltOWZyVRckm9TGIbiRW9vGmOXIA_b5H-VhrWU":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"f8c4d10b-7318-4fdd-90f6-76a36deaa936","one-drive-automation","自动化OneDrive文件管理、搜索、上传、下载、共享、权限和文件夹操作通过Rube MCP（Composio）。始终首先搜索当前架构的工具。","cat_prod_automation","mod_productivity","sickn33,productivity","---\nname: one-drive-automation\ndescription: \"Automate OneDrive file management, search, uploads, downloads, sharing, permissions, and folder operations via Rube MCP (Composio). Always search tools first for current schemas.\"\nrisk: critical\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# OneDrive Automation via Rube MCP\n\nAutomate OneDrive operations including file upload\u002Fdownload, search, folder management, sharing links, permissions management, and drive browsing through Composio's OneDrive toolkit.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active OneDrive connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `one_drive`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https:\u002F\u002Frube.app\u002Fmcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `one_drive`\n3. If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Search and Browse Files\n\n**When to use**: User wants to find files or browse folder contents in OneDrive\n\n**Tool sequence**:\n1. `ONE_DRIVE_GET_DRIVE` - Verify drive access and get drive details [Prerequisite]\n2. `ONE_DRIVE_SEARCH_ITEMS` - Keyword search across filenames, metadata, and content [Required]\n3. `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` - List all items in the root of a drive [Optional]\n4. `ONE_DRIVE_GET_ITEM` - Get detailed metadata for a specific item, expand children [Optional]\n5. `ONE_DRIVE_ONEDRIVE_FIND_FILE` - Find a specific file by exact name in a folder [Optional]\n6. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Find a specific folder by name [Optional]\n7. `ONE_DRIVE_LIST_DRIVES` - List all accessible drives [Optional]\n\n**Key parameters**:\n- `q`: Search query (plain keywords only, NOT KQL syntax)\n- `search_scope`: `\"root\"` (folder hierarchy) or `\"drive\"` (includes shared items)\n- `top`: Max items per page (default 200)\n- `skip_token`: Pagination token from `@odata.nextLink`\n- `select`: Comma-separated fields to return (e.g., `\"id,name,webUrl,size\"`)\n- `orderby`: Sort order (e.g., `\"name asc\"`, `\"name desc\"`)\n- `item_id`: Item ID for `GET_ITEM`\n- `expand_relations`: Array like `[\"children\"]` or `[\"thumbnails\"]` for `GET_ITEM`\n- `user_id`: `\"me\"` (default) or specific user ID\u002Femail\n\n**Pitfalls**:\n- `ONE_DRIVE_SEARCH_ITEMS` does NOT support KQL operators (`folder:`, `file:`, `filetype:`, `path:`); these are treated as literal text\n- Wildcard characters (`*`, `?`) are NOT supported and are auto-removed; use file extension keywords instead (e.g., `\"pdf\"` not `\"*.pdf\"`)\n- `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` returns only root-level contents; use recursive `ONE_DRIVE_GET_ITEM` with `expand_relations: [\"children\"]` for deeper levels\n- Large folders paginate; always follow `skip_token` \u002F `@odata.nextLink` until exhausted\n- Some drive ID formats may return \"ObjectHandle is Invalid\" errors due to Microsoft Graph API limitations\n\n### 2. Upload and Download Files\n\n**When to use**: User wants to upload files to OneDrive or download files from it\n\n**Tool sequence**:\n1. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate the target folder [Prerequisite]\n2. `ONE_DRIVE_ONEDRIVE_UPLOAD_FILE` - Upload a file to a specified folder [Required for upload]\n3. `ONE_DRIVE_DOWNLOAD_FILE` - Download a file by item ID [Required for download]\n4. `ONE_DRIVE_GET_ITEM` - Get file details before download [Optional]\n\n**Key parameters**:\n- `file`: FileUploadable object with `s3key`, `mimetype`, and `name` for uploads\n- `folder`: Destination path (e.g., `\"\u002FDocuments\u002FReports\"`) or folder ID for uploads\n- `item_id`: File's unique identifier for downloads\n- `file_name`: Desired filename with extension for downloads\n- `drive_id`: Specific drive ID (for SharePoint or OneDrive for Business)\n- `user_id`: `\"me\"` (default) or specific user identifier\n\n**Pitfalls**:\n- Upload automatically renames on conflict (no overwrite option by default)\n- Large files are automatically handled via chunking\n- `drive_id` overrides `user_id` when both are provided\n- Item IDs vary by platform: OneDrive for Business uses `01...` prefix, OneDrive Personal uses `HASH!NUMBER` format\n- Item IDs are case-sensitive; use exactly as returned from API\n\n### 3. Share Files and Manage Permissions\n\n**When to use**: User wants to share files\u002Ffolders or manage who has access\n\n**Tool sequence**:\n1. `ONE_DRIVE_ONEDRIVE_FIND_FILE` or `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate the item [Prerequisite]\n2. `ONE_DRIVE_GET_ITEM_PERMISSIONS` - Check current permissions [Prerequisite]\n3. `ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM` - Grant access to specific users [Required]\n4. `ONE_DRIVE_CREATE_LINK` - Create a shareable link [Optional]\n5. `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` - Update item metadata [Optional]\n\n**Key parameters**:\n- `item_id`: The file or folder to share\n- `recipients`: Array of objects with `email` or `object_id`\n- `roles`: Array with `\"read\"` or `\"write\"`\n- `send_invitation`: `true` to send notification email, `false` for silent permission grant\n- `require_sign_in`: `true` to require authentication to access\n- `message`: Custom message for invitation (max 2000 characters)\n- `expiration_date_time`: ISO 8601 date for permission expiry\n- `retain_inherited_permissions`: `true` (default) to keep existing inherited permissions\n\n**Pitfalls**:\n- Using wrong `item_id` with `INVITE_USER_TO_DRIVE_ITEM` changes permissions on unintended items; always verify first\n- Write or higher roles are impactful; get explicit user confirmation before granting\n- `GET_ITEM_PERMISSIONS` returns inherited and owner entries; do not assume response only reflects recent changes\n- `permissions` cannot be expanded via `ONE_DRIVE_GET_ITEM`; use the separate permissions endpoint\n- At least one of `require_sign_in` or `send_invitation` must be `true`\n\n### 4. Manage Folders (Create, Move, Delete, Copy)\n\n**When to use**: User wants to create, move, rename, delete, or copy files and folders\n\n**Tool sequence**:\n1. `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` - Locate source and destination folders [Prerequisite]\n2. `ONE_DRIVE_ONEDRIVE_CREATE_FOLDER` - Create a new folder [Required for create]\n3. `ONE_DRIVE_MOVE_ITEM` - Move a file or folder to a new location [Required for move]\n4. `ONE_DRIVE_COPY_ITEM` - Copy a file or folder (async operation) [Required for copy]\n5. `ONE_DRIVE_DELETE_ITEM` - Move item to recycle bin [Required for delete]\n6. `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` - Rename or update item properties [Optional]\n\n**Key parameters**:\n- `name`: Folder name for creation or new name for rename\u002Fcopy\n- `parent_folder`: Path (e.g., `\"\u002FDocuments\u002FReports\"`) or folder ID for creation\n- `itemId`: Item to move\n- `parentReference`: Object with `id` (destination folder ID) for moves: `{\"id\": \"folder_id\"}`\n- `item_id`: Item to copy or delete\n- `parent_reference`: Object with `id` and optional `driveId` for copy destination\n- `@microsoft.graph.conflictBehavior`: `\"fail\"`, `\"replace\"`, or `\"rename\"` for copies\n- `if_match`: ETag for optimistic concurrency on deletes\n\n**Pitfalls**:\n- `ONE_DRIVE_MOVE_ITEM` does NOT support cross-drive moves; use `ONE_DRIVE_COPY_ITEM` for cross-drive transfers\n- `parentReference` for moves requires folder ID (not folder name); resolve with `ONEDRIVE_FIND_FOLDER` first\n- `ONE_DRIVE_COPY_ITEM` is asynchronous; response provides a URL to monitor progress\n- `ONE_DRIVE_DELETE_ITEM` moves to recycle bin, not permanent deletion\n- Folder creation auto-renames on conflict (e.g., \"New Folder\" becomes \"New Folder 1\")\n- Provide either `name` or `parent_reference` (or both) for `ONE_DRIVE_COPY_ITEM`\n\n### 5. Track Changes and Drive Information\n\n**When to use**: User wants to monitor changes or get drive\u002Fquota information\n\n**Tool sequence**:\n1. `ONE_DRIVE_GET_DRIVE` - Get drive properties and metadata [Required]\n2. `ONE_DRIVE_GET_QUOTA` - Check storage quota (total, used, remaining) [Optional]\n3. `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA` - Track changes in SharePoint site drives [Optional]\n4. `ONE_DRIVE_GET_ITEM_VERSIONS` - Get version history of a file [Optional]\n\n**Key parameters**:\n- `drive_id`: Drive identifier (or `\"me\"` for personal drive)\n- `site_id`: SharePoint site identifier for delta tracking\n- `token`: Delta token (`\"latest\"` for current state, URL for next page, or timestamp)\n- `item_id`: File ID for version history\n\n**Pitfalls**:\n- Delta queries are only available for SharePoint site drives via `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA`\n- Token `\"latest\"` returns current delta token without items (useful as starting point)\n- Deep or large drives can take several minutes to crawl; use batching and resume logic\n\n## Common Patterns\n\n### ID Resolution\n- **User**: Use `\"me\"` for authenticated user or specific user email\u002FGUID\n- **Item ID from find**: Use `ONE_DRIVE_ONEDRIVE_FIND_FILE` or `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` to get item IDs\n- **Item ID from search**: Extract from `ONE_DRIVE_SEARCH_ITEMS` results\n- **Drive ID**: Use `ONE_DRIVE_LIST_DRIVES` or `ONE_DRIVE_GET_DRIVE` to discover drives\n- **Folder path to ID**: Use `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` with path, then extract ID from response\n\nID formats vary by platform:\n- OneDrive for Business\u002FSharePoint: `01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK`\n- OneDrive Personal: `D4648F06C91D9D3D!54927`\n\n### Pagination\nOneDrive uses token-based pagination:\n- Follow `@odata.nextLink` or `skip_token` until no more pages\n- Set `top` for page size (varies by endpoint)\n- `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` auto-handles pagination internally\n- Aggressive parallel requests can trigger HTTP 429; honor `Retry-After` headers\n\n### Path vs ID\nMost OneDrive tools accept either paths or IDs:\n- **Paths**: Start with `\u002F` (e.g., `\"\u002FDocuments\u002FReports\"`)\n- **IDs**: Use unique item identifiers from API responses\n- **Item paths for permissions**: Use `:\u002Fpath\u002Fto\u002Fitem:\u002F` format\n\n## Known Pitfalls\n\n### ID Formats\n- Item IDs are case-sensitive and platform-specific\n- Never use web URLs, sharing links, or manually constructed identifiers as item IDs\n- Always use IDs exactly as returned from Microsoft Graph API\n\n### Rate Limits\n- Aggressive parallel `ONE_DRIVE_GET_ITEM` calls can trigger HTTP 429 Too Many Requests\n- Honor `Retry-After` headers and implement throttling\n- Deep drive crawls should use batching with delays\n\n### Search Limitations\n- No KQL support; use plain keywords only\n- No wildcard characters; use extension keywords (e.g., `\"pdf\"` not `\"*.pdf\"`)\n- No path-based filtering in search; use folder listing instead\n- `q='*'` wildcard-only queries return HTTP 400 invalidRequest\n\n### Parameter Quirks\n- `drive_id` overrides `user_id` when both are provided\n- `permissions` cannot be expanded via `GET_ITEM`; use dedicated permissions endpoint\n- Move operations require folder IDs in `parentReference`, not folder names\n- Copy operations are asynchronous; response provides monitoring URL\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Search files | `ONE_DRIVE_SEARCH_ITEMS` | `q`, `search_scope`, `top` |\n| List root items | `ONE_DRIVE_ONEDRIVE_LIST_ITEMS` | `user_id`, `select`, `top` |\n| Get item details | `ONE_DRIVE_GET_ITEM` | `item_id`, `expand_relations` |\n| Find file by name | `ONE_DRIVE_ONEDRIVE_FIND_FILE` | `name`, `folder` |\n| Find folder by name | `ONE_DRIVE_ONEDRIVE_FIND_FOLDER` | `name`, `folder` |\n| Upload file | `ONE_DRIVE_ONEDRIVE_UPLOAD_FILE` | `file`, `folder` |\n| Download file | `ONE_DRIVE_DOWNLOAD_FILE` | `item_id`, `file_name` |\n| Create folder | `ONE_DRIVE_ONEDRIVE_CREATE_FOLDER` | `name`, `parent_folder` |\n| Move item | `ONE_DRIVE_MOVE_ITEM` | `itemId`, `parentReference` |\n| Copy item | `ONE_DRIVE_COPY_ITEM` | `item_id`, `parent_reference`, `name` |\n| Delete item | `ONE_DRIVE_DELETE_ITEM` | `item_id` |\n| Share with users | `ONE_DRIVE_INVITE_USER_TO_DRIVE_ITEM` | `item_id`, `recipients`, `roles` |\n| Create share link | `ONE_DRIVE_CREATE_LINK` | `item_id`, link type |\n| Get permissions | `ONE_DRIVE_GET_ITEM_PERMISSIONS` | `item_id` |\n| Update metadata | `ONE_DRIVE_UPDATE_DRIVE_ITEM_METADATA` | `item_id`, fields |\n| Get drive info | `ONE_DRIVE_GET_DRIVE` | `drive_id` |\n| List drives | `ONE_DRIVE_LIST_DRIVES` | user\u002Fgroup\u002Fsite scope |\n| Get quota | `ONE_DRIVE_GET_QUOTA` | (none) |\n| Track changes | `ONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTA` | `site_id`, `token` |\n| Version history | `ONE_DRIVE_GET_ITEM_VERSIONS` | `item_id` |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,177,444,"2026-05-16 13:32:51",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"效率工具","productivity","mdi-lightning-bolt-outline","文档处理、数据分析、自动化工作流",4,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"自动化","automation","mdi-robot-outline","工作流自动化、批处理",3,101,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"75549bdd-2b0b-4c2c-b9cd-d2e86ce63686","1.0.0","one-drive-automation.zip",4858,"uploads\u002Fskills\u002Ff8c4d10b-7318-4fdd-90f6-76a36deaa936\u002Fone-drive-automation.zip","366d0aa5329d9ad6a00e19d48643f0f4f0c5833b2ae124ba69a453d1e839c067","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":13021}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]