SKILL.md
Google Docs
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
Use gog for Google Docs operations. Read ../gog/SKILL.md first for shared auth, output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema docs --json
gog --readonly --account [email protected] docs cat DOCUMENT_ID --json --wrap-untrusted- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose | ||||
|---|---|---|---|---|---|
add-tab |
Add a tab to a Google Doc | ||||
cat |
Print a Google Doc as plain text | ||||
cell-style |
Apply table cell, border, padding, alignment, and text styling | ||||
cell-update |
Replace or append content inside a specific table cell | ||||
clear |
Clear all content from a Google Doc | ||||
comments |
Manage comments on files | ||||
copy |
Copy a Google Doc | ||||
create |
Create a Google Doc | ||||
delete |
Delete text range from document | ||||
delete-tab |
Delete a tab from a Google Doc | ||||
edit |
Find and replace text in a Google Doc | ||||
export |
Export a Google Doc (pdf\ | docx\ | txt\ | md\ | html) |
find-range |
Find text and print Docs API UTF-16 index ranges | ||||
find-replace |
Find and replace text. Supports plain text or markdown with images; use --first for a single occurrence. | ||||
footer |
List, create, or delete document footers | ||||
format |
Apply text or paragraph formatting to a Google Doc | ||||
header |
List, create, or delete document headers | ||||
headings |
List document headings | ||||
images |
List document images | ||||
info |
Get Google Doc metadata | ||||
insert |
Insert text at a specific position | ||||
insert-date-chip |
Insert a native date smart chip | ||||
insert-file-chip |
Insert a native Drive file smart chip | ||||
insert-footnote |
Insert and populate a footnote | ||||
insert-horizontal-rule |
Insert a paragraph-border horizontal rule | ||||
insert-image |
Insert a public image URL or upload a local image into a Google Doc | ||||
insert-page-break |
Insert a page break at a specific position (or end-of-doc with --at-end) | ||||
insert-person |
Insert a native person smart chip | ||||
insert-section-break |
Insert a continuous or next-page section break | ||||
insert-table |
Insert a native table at a specific position (or end-of-doc with --at-end), optionally populated via --values-json | ||||
list-tabs |
List all tabs in a Google Doc | ||||
named-range |
Manage named ranges | ||||
page-layout |
Set page layout (pageless\ | pages) on an existing Google Doc | |||
paragraphs |
List document paragraphs | ||||
raw |
Dump raw Google Docs API response as JSON (Documents.Get; lossless; for scripting and LLM consumption) | ||||
rename-tab |
Rename a tab in a Google Doc | ||||
replace-image |
Replace an existing image without changing its position or bounds | ||||
section-columns |
Set the column count for a document section | ||||
sed |
Regex find/replace (sed-style: s/pattern/replacement/g) | ||||
structure |
Show document structure with numbered paragraphs | ||||
suggestions |
List pending text suggestions | ||||
table-column |
Insert or delete native table columns | ||||
table-column-width |
Set or reset native table column widths | ||||
table-merge |
Merge a native table cell range | ||||
table-row |
Insert, delete, style, or pin native table rows | ||||
table-unmerge |
Unmerge the region containing a native table cell | ||||
tables |
List native tables | ||||
tabs |
Manage Google Doc tabs | ||||
update |
Insert or replace text at a specific index or range in a Google Doc | ||||
write |
Write content to a Google Doc |
Run gog docs <command> --help for flags and gog schema docs <command> --json for the machine-readable contract. Do not guess command syntax.