Google Drive Files

Use this managed skill when the user wants to work with Google Drive files that Shift created or that the user explicitly opened with Shift, inspect file metadata, create folders, or share a file with someone.

This skill uses Shift's local Skill Router. Do not ask the user to paste Google credentials into chat.

Invocation

Base URL:

SHIFT_LOCAL_GATEWAY

Endpoint:

POST /skill-router/invoke

Request body to list files:

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "list",
  "input": {
    "query": "mimeType = 'application/vnd.google-apps.folder'",
    "pageSize": 10,
    "orderBy": "modifiedTime desc"
  }
}

Request body to get file details:

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "get",
  "input": {
    "fileId": "1AbCdEfGhIjKlMnOp"
  }
}

Request body to create a folder:

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "create-folder",
  "input": {
    "name": "Launch assets",
    "parentIds": ["1AbCdEfGhIjKlMnOp"]
  }
}

Request body to share a file:

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "share",
  "input": {
    "fileId": "1AbCdEfGhIjKlMnOp",
    "type": "user",
    "role": "writer",
    "emailAddress": "teammate@example.com"
  }
}

Authentication

This skill requires a Google Drive connection configured in Shift.

Google Drive access is intentionally limited to files created by or explicitly opened with Shift.

Agent behavior

1. Use list before get when the user has not provided a file id.
2. Remember that this provider only works with files created by or explicitly opened with Shift.
3. Prefer folders and metadata operations before attempting more complex file editing flows.
4. Use share only when the user clearly names the recipient and required role.