Skip to content

feat(skill): add Claude Code skill for gog CLI#353

Closed
TimPietrusky wants to merge 1 commit intoopenclaw:mainfrom
TimPietrusky:feat/claude-code-skill
Closed

feat(skill): add Claude Code skill for gog CLI#353
TimPietrusky wants to merge 1 commit intoopenclaw:mainfrom
TimPietrusky:feat/claude-code-skill

Conversation

@TimPietrusky
Copy link
Copy Markdown
Contributor

Summary

  • Adds a skills/gog/SKILL.md file following the Claude Code skill convention
  • Documents all gog commands with practical examples: Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks, Chat, Keep, Groups, People, Classroom
  • Includes agent-specific tips (--json, --no-input, --force flags)
  • Follows the same pattern used by agent-slack and agent-media skills

What is a Claude Code skill?

A skill is a SKILL.md file with YAML frontmatter (name, description, trigger keywords) and markdown documentation that teaches Claude Code how to use a CLI tool. When installed under ~/.claude/skills/<name>/SKILL.md, Claude Code automatically knows when and how to invoke the tool.

How users install it

# Copy the skill to the Claude Code skills directory
mkdir -p ~/.claude/skills/gog
cp skills/gog/SKILL.md ~/.claude/skills/gog/SKILL.md

Or the skill can be distributed via a package manager / installer in the future.

Test plan

  • Verify SKILL.md YAML frontmatter parses correctly
  • Verify skill triggers match expected use cases (gmail, calendar, sheets, etc.)
  • Spot-check command examples against gog --help output for accuracy
  • Install locally and confirm Claude Code detects and uses the skill

@TimPietrusky TimPietrusky force-pushed the feat/claude-code-skill branch 3 times, most recently from 9d83a09 to a7d4838 Compare February 22, 2026 19:22
Adds a skills/gog/SKILL.md following the Claude Code skill convention
(same pattern as agent-slack, agent-media, runpodctl).

Covers all gog services with command examples derived from the README:
Gmail, Calendar, Drive, Sheets, Docs, Slides, Forms, Apps Script,
Contacts, Tasks, Chat, Keep, Groups, People, Classroom, Time.

Includes installation instructions (Homebrew, AUR, binary, source),
full auth setup (OAuth, service accounts, headless/CI flows,
multi-account, aliases), environment variables, configuration,
command sandboxing, and agent-specific tips.

Tested: subagent successfully ran gog version, auth list,
calendar events, and gmail search using the skill.
@steipete
Copy link
Copy Markdown
Collaborator

steipete commented May 5, 2026

Thanks @TimPietrusky. I landed a rewritten version in #552 / 3ed5235.

What changed from this PR:

  • kept the repo-native .agents/skills/gog/SKILL.md path instead of adding a parallel skills/gog/SKILL.md
  • trimmed the skill into a concise safety-first agent guide with auth preflight, JSON-first patterns, command guards, sanitized Gmail reads, and live-test cleanup guidance
  • linked it from README/docs and added changelog credit
  • folded in the security concern from claude work skill to access google workspace #451 by avoiding plaintext GOG_KEYRING_PASSWORD setup guidance

Verification: make ci, make docs-site, built ./bin/gog, live read-only auth/Gmail/Drive smokes against clawdbot@gmail.com, and a --disable-commands gmail.send guard smoke.

Closing this PR as superseded by the landed maintainer version. Co-authored-by credit is included in the landed commit.

@steipete
Copy link
Copy Markdown
Collaborator

steipete commented May 5, 2026

Superseded by #552, merged as 3ed5235.

@steipete steipete closed this May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants