Agent Skills
› Chachamaru127/claude-code-harness
› gogcli-ops
gogcli-ops
GitHub标准化gogcli操作Google Workspace文件。通过URL解析ID、验证认证，优先执行只读检查，经确认后才进行写入操作，涵盖Drive/Sheets/Docs/Slides的元数据查询与导出。
Trigger Scenarios
需要操作Google Drive文件
读取或更新Google Sheets表格
查看或导出Google Docs文档
处理Google Slides演示文稿
从URL提取Google文件ID
Install
npx skills add Chachamaru127/claude-code-harness --skill gogcli-ops -g -y
SKILL.md
Frontmatter
{
"name": "gogcli-ops",
"description": "gogcli for Google Workspace ops (Drive\/Sheets\/Docs\/Slides). Triggers: list\/search\/export\/read\/update Google files, URL\/ID parsing, auth selection. Skip for: non-Google storage, generic shell."
}
Gogcli Ops
Overview
Standardize gogcli usage: verify auth, resolve IDs from URLs, default to read-only checks, then run the minimum command needed.
Quick start
- Confirm gogcli is available:
gog --version - List accounts and pick one explicitly if more than one:
gog auth list - Resolve URL to ID with
python3 scripts/gog_parse_url.py "<url-or-id>" - Run a read-only metadata command first (Drive/Sheets/Docs/Slides)
Workflow decision tree
- Identify target type:
sheet | doc | slide | file | folder | id | unknownviascripts/gog_parse_url.py. - Choose the smallest read-only command to confirm access:
- Sheets:
gog sheets metadata <spreadsheetId> - Docs:
gog docs info <docId> - Slides:
gog slides info <presentationId> - Drive file/folder:
gog drive get <fileId>orgog drive permissions <fileId>
- Sheets:
- Only proceed to write operations (update/append/move/share/delete) after explicit user confirmation.
Core tasks
Auth and account selection
- Show stored accounts:
gog auth list - Show auth configuration:
gog auth status - Add/authorize account:
gog auth add <email> - Always use
--account <email>when multiple accounts exist.
Resolve IDs from URLs
- Parse a URL or ID:
python3 scripts/gog_parse_url.py "<url-or-id>"
- If output type is
unknown, ask for a direct ID or a different URL.
Drive (files/folders)
- List root or a folder:
gog drive ls - Search by query:
gog drive search "<query>" - Get metadata:
gog drive get <fileId> - Download/export:
gog drive download <fileId> - Permissions check:
gog drive permissions <fileId>
Sheets
- Metadata:
gog sheets metadata <spreadsheetId> - Read values:
gog sheets get <spreadsheetId> <range> - Export:
gog sheets export <spreadsheetId> - Write operations (update/append/clear/format): require explicit confirmation and exact range.
Docs
- Metadata:
gog docs info <docId> - Read text:
gog docs cat <docId> - Export:
gog docs export <docId>
Slides
- Metadata:
gog slides info <presentationId> - Export:
gog slides export <presentationId>
Output modes
- Use
--plainfor stable TSV output. - Use
--jsonwhen a caller wants structured output. - Use
--no-inputin non-interactive flows to avoid hanging.
Error handling
- 403/404: verify account (
gog auth list), check permissions (gog drive permissions <fileId>), and confirm the ID. - If access fails, request the user to share the file with the selected account or provide the correct account.
Resources
- See
${CLAUDE_SKILL_DIR}/references/gogcli-cheatsheet.mdfor a compact command list. - Use
scripts/gog_parse_url.pyto normalize URLs into IDs before running commands.
Version History
- c220671 Current 2026-07-05 14:46
