the-focus-ai/google-skill · Archived

gdocs

This skill should be used when the user asks to "read document", "create document", "edit document", "google doc", "list documents", "insert text", "append text", "find and replace", "export document", "export to pdf", "export to word", "download as pdf", or mentions Google Docs operations.

First seen Mar 30, 2026

Installation

$ npx skills add the-focus-ai/google-skill --skill gdocs

Summary

  • This skill should be used when the user asks to "read document", "create document", "edit document", "google doc", "list documents", "insert text", "append text", "find and replace", "export document", "export to pdf", "export to word", "download as pdf", or mentions Google Docs operations.
  • Provides Google Docs API integration for reading, writing, exporting, and managing documents.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from the-focus-ai/google-skill.

npx skills add the-focus-ai/google-skill

Browse all from the-focus-ai/google-skill

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 2
License MIT
Default branch main
Open issues 0
Status Archived

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.3.0
Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,730 B
  • docs SUMMARY.md 398 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 8 installs

SKILL.md

Google Docs Skill

Create, read, edit, and export Google Docs documents.

First-Time Setup

Run npx tsx ${CLAUDEPLUGINROOT}/skills/gmail/scripts/gmail.ts auth to authenticate with Google. This opens a browser for OAuth consent and grants access to all Google services including Docs.

Tokens are stored per-project in .claude/google-skill.local.json.

Using Your Own Credentials (Optional)

By default, this skill uses embedded OAuth credentials. To use your own Google Cloud project instead, save your credentials to ~/.config/google-skill/credentials.json.

Commands

# List your documents
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts list
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts list --max=50

# Get document metadata
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts get <documentId>

# Read document content as plain text
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts read <documentId>

# Create new document
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts create --title="My Document"

# Insert text at beginning (index 1)
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts insert <documentId> --text="Hello World\n"

# Insert text at specific position
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts insert <documentId> --text="Inserted here" --index=50

# Append text to end of document
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts append <documentId> --text="\n\nNew paragraph at the end."

# Find and replace text
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts replace <documentId> \
  --find="old text" \
  --replace="new text"

# Find and replace (case-sensitive)
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts replace <documentId> \
  --find="Hello" \
  --replace="Hi" \
  --match-case

# Export to PDF (default)
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts export <documentId>

# Export to Word (.docx)
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts export <documentId> --format=docx

# Export to other formats (odt, txt, html, rtf, epub)
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts export <documentId> --format=odt

# Export to specific file path
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts export <documentId> --format=pdf --output=./report.pdf

Export Formats

Format Extension Description
pdf .pdf Portable Document Format (default)
docx .docx Microsoft Word
odt .odt OpenDocument Text
txt .txt Plain text
html .html Web page
rtf .rtf Rich Text Format
epub .epub E-book format

Text Formatting Notes

  • Use \n for newlines in text arguments
  • Use \t for tabs
  • Text is inserted as plain text (no rich formatting via CLI)
  • For complex formatting, use the Google Docs web interface

Document IDs

Document IDs can be found in the URL of any Google Doc: https://docs.google.com/document/d/{documentId}/edit

Or use the list command to see your recent documents with their IDs.

Output

All commands return JSON with success and data fields.

Help

npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/gdocs/scripts/gdocs.ts --help