google-docs

Google Docs

Use this skill for Google Docs work in Codex local-plugin sessions. For blank or basic native Google Docs, create the doc directly with the Google Drive connector. Use [@documents](plugin://documents@openai-primary-runtime) plus DOCX import only when the requested deliverable needs polished document authoring, complex layout, visual design, image/figure placement, page-level QA, branded styling, or export-quality fidelity.

Purpose Of This File

This file is intentionally minimal and covers:

1. connector loading and runtime boundaries in the Codex local-plugin environment
2. the direct native-create route for blank and basic Google Docs
3. the DOCX-first native import route for polished or complex Google Docs
4. the direct-request workflow for existing and newly created Google Docs
5. stateful operation and mandatory routing to reference files

All formatting, citation, table, request-shape, and production rules live in references/. Read only the references required for the task. For the common calendar-backed meeting-notes edit, references/reference-meeting-notes-direct.md is the single task reference unless the task adds tables, figures, citations, import/export, or other non-meeting-notes requirements.

Default Routing

Use this routing:

1. Blank or basic native Google Docs creation: read references/reference-native-create-direct.md, call mcp__codex_apps__google_drive._create_file with mime_type: "application/vnd.google-apps.document", and use direct Docs batchUpdate requests only if content is requested.
2. Polished or complex net-new Google Docs creation: use [@documents](plugin://documents@openai-primary-runtime) to create a local .docx first, explicitly selecting the google_docs_default design preset unless the user asked for a special, branded, or highly polished visual treatment. Then read references/reference-import-docx-to-native-docs.md and import with mcp__codex_apps__google_drive_import_document using upload_mode: "native_google_docs".
3. If the Documents plugin is unavailable for a polished or complex deliverable, report that the required local Documents authoring path is unavailable. Do not block blank or basic native Google Doc creation on the Documents plugin.
4. Existing Google Docs reads, summaries, edits, comments, and template-preserving modifications: use Google Docs connector or app tools directly.