drive_skill

Overview

This skill integrates Google Drive through the AtrisOS API to browse, search, read, upload files, and work with Google Sheets. It handles authentication bootstrap, supports shared drives, and exposes export/download endpoints for Docs, Sheets, and other files. Use it to automate Drive tasks from an agent or script with secure token-based access.

How this skill works

Before any operation the skill runs a bootstrap that verifies the Atris CLI token and Google Drive connection. It calls AtrisOS endpoints to list shared drives, search and list files, get metadata, download or export content, upload files, and read/write spreadsheet ranges. Spreadsheet operations use A1 notation and support reading, updating, and appending rows.

When to use it

• Search or locate files across My Drive and shared drives
• Read or export Google Docs, Sheets, or Slides programmatically
• Upload local files or add documents to a specific Drive folder
• Inspect file metadata or download file contents as base64
• Read, update, or append rows in Google Sheets from an agent

Best practices

• Always run the bootstrap step first to ensure the Atris token and Drive connection are valid
• Use Drive query syntax for precise searches (e.g., mimeType filters, name contains, modifiedTime)
• Export Google Docs/Sheets to text or CSV for easier processing by agents
• Show users a preview and request confirmation before appending or uploading files
• Handle common errors (token expired, not connected, rate limits) with clear retry or re-authentication flows

Example use cases

• Find the latest quarterly budget spreadsheet, read the header row, and append new expense lines
• Search for a meeting notes Doc, export it as plain text, and summarize action items
• List shared drives and enumerate files in a team drive for audit or migration planning
• Upload a generated report to a specific Drive folder and return the new file ID and link
• Read a sheet range (Sheet1!A1:D50), perform calculations, and write back results