Agent Skills
› Chachamaru127/claude-code-harness
› gogcli-ops
gogcli-ops
GitHub规范使用gogcli操作Google Workspace（Drive/Sheets/Docs/Slides）。涵盖身份验证、URL转ID解析、只读元数据检查及写入操作，强调最小权限与安全确认。
Trigger Scenarios
用户需要管理或访问Google Drive文件
用户需读取或更新Google Sheets表格
用户需查看或导出Google Docs文档
用户需处理Google Slides幻灯片
用户提供Google资源URL需解析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.",
"allowed-tools": [
"Read",
"Bash",
"Grep",
"Glob"
],
"description-en": "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.",
"description-ja": "gogcli でGoogle Workspace操作（Drive\/Sheets\/Docs\/Slides）。ユーザーがGoogleファイルの確認・検索・エクスポート・読み取り・更新をgogcliで依頼する時に使用。Trigger when a user asks to check, list, search, export, read, or update Google files via gogcli; when a Google URL\/ID needs parsing; when auth\/account selection or safe read-only workflows are needed; or when troubleshooting gogcli access\/errors. Do NOT load for: general file operations, non-Google cloud storage, or standard shell commands.",
"disable-model-invocation": true
}
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:44
