poly-gents Google Drive
Purpose
Navigate and search Google Drive: list folders, plain-text search, fetch metadata, download files, and create folders—supplying file IDs downstream to Docs or Sheets skills.
When to Use
- Find a file or spreadsheet by name or phrase.
- Browse a folder’s contents.
- Get metadata or download file bytes.
- Create a folder.
When NOT to Use
- Editing Doc body or Sheet cells → google-docs / google-sheets (after resolving
documentId/spreadsheetIdhere). - Gmail or Calendar → gmail / google-calendar.
Expected Outcome
- Search/list results with names, types, and IDs.
- Downloads only when the user needs file content.
- Clear handoff IDs when the next step is Docs or Sheets.
Inputs to Gather
- Plain-text search phrase (no Drive query DSL in
drive_search). folderIdfor browse vs global search.- Whether the user needs metadata only or a download.
Workflow
- Confirm Drive tools are available.
- Browse with
drive_list_files(folderId, optionalq,pageSize) or search withdrive_search(plain text only). - Metadata:
drive_get_filewith file ID. - Download when requested:
drive_download_file. - Create folder when requested:
drive_create_folder. - If the user will edit a Doc or Sheet, pass the ID to the appropriate skill.
Domain rules
- Plain-text search:
drive_searchaccepts normal phrases only—no special query syntax. - IDs for Docs/Sheets: Resolve file ID here; edit in google-docs or google-sheets.
- List vs search: Folder browse →
drive_list_files; name/content discovery →drive_search.
Main tools
drive_list_files,drive_get_file,drive_download_file,drive_create_folder,drive_search
Examples
Find Budget 2026 spreadsheet: drive_search with "Budget 2026"; return IDs and offer Sheets read via google-sheets.
Root listing: drive_list_files without folderId or with root folder ID; concise name/type list.
Tool Availability Rules
| Access | Behavior |
|---|---|
| Full tool access | Search, list, download, create folders. |
| Read-only | Search/list/get only. |
| No integration | Do not fabricate file IDs or contents. |
Related tool sets
google-drive
Review / Decision / Execution Criteria
- Paginate large folders.
- Prefer search when the user knows a name, list when they know a folder.
Output Format
- Actions and tools used.
- Files (name, type, id).
- Errors.
- Next skill if editing Docs/Sheets.
Quality Bar
- Never invent Drive query syntax.
- IDs must come from tool responses.
Safety and Boundaries
- Do not download or expose sensitive files without user intent.
- No secrets in paths or examples.
Escalation / Dispatch Rules
- Doc/Sheet edits → google-docs / google-sheets with resolved IDs.
- No integration → state blocker explicitly.
References
- Legacy:
skills/old_skills.json(google-drive). skills/skill.instruction.md,skills/meta.instructions.md