mcpField
G
gogcli-ops

gogcli-ops

github.com/chachamaru127Documents3.2k39 installsUpdated 2w ago
Repository

About gogcli-ops

gogcli-ops is a skill for agents operating gogcli to inspect and manage Drive, Sheets, Docs, and Slides. It standardizes account checks, URL-to-ID resolution, read-only verification, and confirmation before write operations.

Key features

  1. 01Checks authentication and account selection
  2. 02Resolves URLs to IDs
  3. 03Prefers read-only access checks
  4. 04Requires confirmation before writes
  5. 05Supports plain and JSON output

Use cases

  1. 01Checking access to a Drive file or folder
  2. 02Reading document or spreadsheet content
  3. 03Preparing a confirmed update to a sheet

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/chachamaru127/claude-code-harness --skill gogcli-ops

After installing, type/gogcli-opsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
gogcli-cheatsheet.md
scripts/
gog_parse_url.py

Details

From the project README

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

  1. Identify target type: sheet | doc | slide | file | folder | id | unknown via scripts/gog_parse_url.py.
  2. 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> or gog drive permissions <fileId>
  3. 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 --plain for stable TSV output.
  • Use --json when a caller wants structured output.
  • Use --no-input in 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.md for a compact command list.
  • Use scripts/gog_parse_url.py to normalize URLs into IDs before running commands.

Comments

Markdown supported