google-docs-sheets
将 Google Docs 和 Google Sheets(电子表格)导出到 Markdown 文件或标准输出。当要求获取、下载或提取 Google 文档/表格内容以进行摘要、分析或上下文加载时使用。首先尝试使用浏览器 OAuth 回退的 gcloud ADC。
📖 中文导读:将 Google Docs 和 Google Sheets(电子表格)导出到 Markdown 文件或标准输出。当要求获取、下载或提取 Google 文档/表格内容以进行摘要、分析或上下文加载时使用。首先尝试使用浏览器 OAuth 回退的 gcloud ADC。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: google-docs-sheets description: Export Google Docs and Google Sheets (spreadsheets) to Markdown files or stdout. Use when asked to fetch, download, or ingest Google Docs/Sheets content for summarization, analysis, or context loading. Tries gcloud ADC first with browser OAuth fallback. allowed-tools: Bash(uv run:*)
Google Docs & Sheets
Export Google Docs and Google Sheets content as Markdown. Uses Google APIs with read-only scopes, prefers gcloud ADC, and falls back to browser OAuth when needed.
Quick Start
Auth (preferred: gcloud ADC, run by default)
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/spreadsheets.readonly
Google Docs
# Export to stdout
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py docs export <DOC_ID_OR_URL> --stdout
# Export to files (default ./exports when --stdout is not set)
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py docs export <DOC_ID_OR_URL>
# Write to a specific directory
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py docs export <DOC_ID_OR_URL> --output-dir ./exports
# Write and print
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py docs export <DOC_ID_OR_URL> --output-dir ./exports --stdout
Notes:
- Export uses HTML -> Markdown conversion and strips images.
- Output filename defaults to the Doc title (sanitized) with
.mdextension.
Google Sheets
# Export all tabs to stdout
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py sheets export <SHEET_ID_OR_URL> --stdout
# Export all tabs to files (default ./exports when --stdout is not set)
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py sheets export <SHEET_ID_OR_URL>
# Export specific tabs
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py sheets export <SHEET_ID_OR_URL> --tab "Summary" --tab "Data"
# Header control
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py sheets export <SHEET_ID_OR_URL> --header-row 2
uv run --directory ${CLAUDE_PLUGIN_ROOT}/skills/google-docs-sheets scripts/cli.py sheets export <SHEET_ID_OR_URL> --no-header
Notes:
- Each tab is exported to its own Markdown table.
- Output filenames are
Spreadsheet Title - Tab Title.md. - If the URL includes
gid=..., that tab is selected automatically (unless--tabis used).