google-drive

📁 abdullahbeam/nexus-design-abdullah 📅 Jan 19, 2026
10
总安装量
8
周安装量
#30187
全站排名
安装命令
npx skills add https://github.com/abdullahbeam/nexus-design-abdullah --skill google-drive

Agent 安装分布

claude-code 7
antigravity 6
codex 6
windsurf 5
opencode 5

Skill 文档

Google Drive

Upload, download, and manage files and folders in Google Drive via OAuth authentication.


Pre-Flight Check (ALWAYS RUN FIRST)

python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service drive

Exit codes:

  • 0: Ready to use – proceed with user request
  • 1: Need to login – run python3 00-system/skills/google/google-master/scripts/google_auth.py --login
  • 2: Missing credentials or dependencies – see ../google-master/references/setup-guide.md

Quick Reference

List Files (Root)

python3 00-system/skills/google/google-drive/scripts/drive_operations.py list

List Files in Folder

python3 00-system/skills/google/google-drive/scripts/drive_operations.py list --folder <folder_id>

Search Files

python3 00-system/skills/google/google-drive/scripts/drive_operations.py search "report"

Get File Info

python3 00-system/skills/google/google-drive/scripts/drive_operations.py info <file_id>

Download File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py download <file_id> --output ./local_file.pdf

Download Google Doc as PDF

python3 00-system/skills/google/google-drive/scripts/drive_operations.py download <doc_id> --format pdf

Upload File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py upload ./local_file.pdf --folder <folder_id>

Create Folder

python3 00-system/skills/google/google-drive/scripts/drive_operations.py create-folder "New Folder" --parent <parent_id>

Move File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py move <file_id> <destination_folder_id>

Copy File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py copy <file_id> --name "Copy of File"

Rename File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py rename <file_id> "New Name"

Delete File (Trash)

python3 00-system/skills/google/google-drive/scripts/drive_operations.py delete <file_id>

Share File

python3 00-system/skills/google/google-drive/scripts/drive_operations.py share <file_id> user@example.com --role writer

Get Sharing Info

python3 00-system/skills/google/google-drive/scripts/drive_operations.py sharing <file_id>

File/Folder ID

The ID is in the URL:

https://drive.google.com/file/d/[FILE_ID]/view
https://drive.google.com/drive/folders/[FOLDER_ID]

Export Formats

For Google Docs files, use --format when downloading:

File Type Available Formats
Google Docs pdf, docx, txt, html
Google Sheets pdf, xlsx, csv
Google Slides pdf, pptx

Available Operations

Operation Function Description
List list_files() List files in a folder
Search search_files() Search by name
Info get_file_info() Get file metadata
Download download_file() Download to local
Upload upload_file() Upload from local
Create Folder create_folder() Create new folder
Move move_file() Move to different folder
Copy copy_file() Duplicate a file
Rename rename_file() Change name
Delete delete_file() Move to trash
Share share_file() Share with user
Sharing get_sharing_info() Get permissions

Sharing Roles

Role Permissions
reader View only
commenter View and comment
writer View, comment, and edit

Error Handling

See ../google-master/references/error-handling.md for common errors and solutions.


Setup

First-time setup: ../google-master/references/setup-guide.md

Quick start:

  1. pip install google-auth google-auth-oauthlib google-api-python-client
  2. Create OAuth credentials in Google Cloud Console (enable Google Drive API, choose “Desktop app”)
  3. Add to .env file at Nexus root:
    GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
    GOOGLE_CLIENT_SECRET=your-client-secret
    GOOGLE_PROJECT_ID=your-project-id
    
  4. Run python3 00-system/skills/google/google-master/scripts/google_auth.py --login