Cursor plugin specification and official plugins
TypeScript
Match the skill to the renamed Drive tool surface
Cursor Agent861d5c0cae26
diff --git a/third_party/google-drive/.cursor-plugin/plugin.json b/third_party/google-drive/.cursor-plugin/plugin.jsonindex cb0fa12c..a26d1c8d 100644--- a/third_party/google-drive/.cursor-plugin/plugin.json+++ b/third_party/google-drive/.cursor-plugin/plugin.json@@ -29,5 +29,6 @@"mcp","google-workspace"],- "mcpServers": "./mcp.json"+ "mcpServers": "./mcp.json",+ "skills": "./skills/"}diff --git a/third_party/google-drive/skills/google-drive/SKILL.md b/third_party/google-drive/skills/google-drive/SKILL.mdindex 27ef588f..cb717cc0 100644--- a/third_party/google-drive/skills/google-drive/SKILL.md+++ b/third_party/google-drive/skills/google-drive/SKILL.md@@ -1,64 +1,68 @@---name: google-drive-description: Work with Google Drive through the google_drive_* tools - search, read, create, organize, share, comment, and export files. Use when creating files in specific folders, moving or renaming, converting Markdown/CSV into Docs/Sheets, managing comments, or exporting a rendered PDF.+description: Work with Google Drive through its MCP tools - search, read, create, organize, share, comment, and export files. Use when creating files in specific folders, moving or renaming, converting Markdown/CSV into Docs/Sheets, managing comments, or exporting a rendered PDF.---# Google Drive files## Ids come from search, never guesses-Every tool takes Drive file ids. Get them from `google_drive_search` (or-`google_drive_list_folder` for a known folder,-`google_drive_list_recent_files` for "what was I just working on"), or from+Every tool takes Drive file ids. Get them from `search` (or+`list_folder` for a known folder,+`list_recent_files` for "what was I just working on"), or fromthe id in a URL the user pasted. `exact_name` beats `query` for a knownfilename; add `mime_type_filter` to cut noise. Never invent an id or reuseone from a stale conversation - re-search first.## Folder targeting-- `google_drive_create_folder` takes `parent_folder_id`; without it the+- `create_folder` takes `parent_folder_id`; without it thefolder lands in My Drive root. When the user names a destination folder,resolve its id and pass it - a file created in root when a folder wasspecified is a wrong result even if the content is perfect.-- `google_drive_create_file` also takes `parent_folder_id`, so create files+- `create_file` also takes `parent_folder_id`, so create filesdirectly where they belong instead of creating then moving.- The Docs/Sheets/Slides providers' own create tools CANNOT target a folder(their APIs have no parent parameter). When placement matters, either- create the artifact there with `google_drive_create_file` (Markdown to- Doc, CSV to Sheet), or create it and then `google_drive_move_or_rename`+ create the artifact there with `create_file` (Markdown to+ Doc, CSV to Sheet), or create it and then `move_or_rename`with `destination_folder_id`.-- `google_drive_move_or_rename` does either or both in one call; renaming+- `move_or_rename` does either or both in one call; renamingdoes not change the id.+- `update_file` is the same rename/move with the hosted Drive tool's+ argument names (`fileId`; `title` renames, `parentId` moves by replacing+ the current parent); it exists on both the translator and hosted+ surfaces, so prefer it in guidance that must work on either.- Grant limits: this app's grant is `drive.file`, so moving into or writingfiles/folders this app never created (and the user never picked) can 403.That 403 is a permission fact, not a transient error; do not retry it.## Markdown and CSV conversion-`google_drive_create_file` with `target_mime_type:+`create_file` with `target_mime_type:application/vnd.google-apps.document` converts Markdown (headings, lists,tables) into a real Google Doc in one call; `...spreadsheet` converts CSVinto a Sheet. This is the fastest correct way to produce a formatted Doc:prefer it over create-then-insert when the content is known up front.-`google_drive_update_file_content` converts in place the same way.+`update_file_content` converts in place the same way.## Copying, metadata, and sharing-- `google_drive_copy_file` duplicates a file (optionally into a folder) -+- `copy_file` duplicates a file (optionally into a folder) -the right way to instantiate a template without touching the original.-- `google_drive_get_file_metadata` returns the full record (mime type,+- `get_file_metadata` returns the full record (mime type,parents, size, owners, modified time); use it to confirm a move landed.-- `google_drive_get_file_permissions` lists who has access;- `google_drive_share_file` grants a role to an email. Share only when the+- `get_file_permissions` lists who has access;+ `share_file` grants a role to an email. Share only when theuser asked; report the link rather than widening access speculatively.-- `google_drive_download_file` returns the raw bytes base64-encoded for+- `download_file` returns the raw bytes base64-encoded fornon-Google files (images, PDFs, plain text).## Reading and exporting-- `google_drive_read_file` returns text: Docs as Markdown, Sheets as CSV per+- `read_file` returns text: Docs as Markdown, Sheets as CSV pertab, Slides as plain text. Use it to verify content after writes.-- `google_drive_export_file` returns rendered bytes base64-encoded: `pdf`+- `export_file` returns rendered bytes base64-encoded: `pdf`for Docs/Sheets/Slides (Sheets PDF renders every tab, charts included),`png`/`svg` for Drawings, plus office formats (docx/xlsx/pptx). Use PDFwhen the user wants to see the final look; exports cap at 10 MB.@@ -70,24 +74,24 @@ prefer it over create-then-insert when the content is known up front.Comments live on the Drive file, so one tool set covers Docs, Sheets, andSlides alike:-- `google_drive_list_comments` returns each comment's text, quoted document+- `list_comments` returns each comment's text, quoted documenttext, resolved state, and replies; it pages, so follow `nextPageToken`before concluding a thread does not exist.-- `google_drive_add_comment` adds a file-level comment (no text anchor).-- `google_drive_reply_to_comment` replies by comment id, and its+- `add_comment` adds a file-level comment (no text anchor).+- `reply_to_comment` replies by comment id, and its`action: "resolve"` (content optional) is the ONLY way to resolve athread; editing document text near a comment never resolves it. Leavealready-resolved threads alone.## Deleting-`google_drive_trash_file` is recoverable (~30 days) and works on files and+`trash_file` is recoverable (~30 days) and works on files andfolders (a trashed folder takes its contents). Permanent deletion isdeliberately not available; never promise it.## Verify your work-After creates and moves, confirm placement with `google_drive_list_folder`-on the destination or `google_drive_get_file_metadata` (check `parents`).-After content writes, `google_drive_read_file` is the ground truth for text-and `google_drive_export_file` (pdf) for the rendered result.+After creates and moves, confirm placement with `list_folder`+on the destination or `get_file_metadata` (check `parents`).+After content writes, `read_file` is the ground truth for text+and `export_file` (pdf) for the rendered result.