skills.rest
davidbeglenboyle
davidbeglenboyleCOMMUNITY
Explore all skills by this author →
GitHub

gdocs-sync

Convert Markdown content into Google Docs with a stable URL.

2|1|Updated Feb 4, 2026
Search Tags:#markdown#oauth#sync#google-drive#google-docs#docs-api#permalink
One-click install
npx skills add https://github.com/davidbeglenboyle/davids-claude-code-setup --skill gdocs-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gdocs-sync
Source: https://github.com/davidbeglenboyle/davids-claude-code-setup/tree/main/skills/needs-credentials/gdocs-sync
Command: npx skills add https://github.com/davidbeglenboyle/davids-claude-code-setup --skill gdocs-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps Markdown content synchronized with Google Docs and provides a permanent, shareable URL by storing the document ID alongside the source.

Core Features & Use Cases

  • Creates a Google Doc on the first run and updates the same document on subsequent runs, ensuring the URL remains stable.
  • Stores the document ID next to your Markdown file so collaborators always access the same doc.
  • Enables reliable context sharing across machines for project briefs, reports, and knowledge bases.

Quick Start

Run the sync command with your Markdown file and a doc-id file to create a Google Doc on first run and update it on subsequent runs.

Frequently Asked Questions about gdocs-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Markdown to Google Docs with a stable URL?▼

To sync Markdown to Google Docs with a stable URL, this skill creates a new document on the first run and updates the same document on subsequent runs by storing the document ID locally. This ensures the shareable link remains permanent across updates.

What do I need to connect Markdown files to the Google Docs API?▼

Connecting Markdown files to the Google Docs API requires a Google Cloud project with Docs and Drive APIs enabled, OAuth credentials, and locally installed Python dependencies like google-auth and google-api-python-client for authentication.

Can I update the same Google Doc from Markdown on multiple machines?▼

Yes, you can update the same Google Doc from Markdown across multiple machines. The skill stores the document ID next to your source file, enabling reliable context sharing and consistent access for collaborators via a single permanent link.

Why does syncing Markdown to Google Docs require per-machine authentication?▼

Syncing Markdown to Google Docs requires per-machine authentication via gdocs_auth.py to securely establish OAuth credentials for each environment. This allows the Python client library to access the Drive and Docs APIs independently on every machine.

What is the best way to maintain a permanent link for a shared Markdown report?▼

The best way to maintain a permanent link for a shared Markdown report is storing the document ID locally after the initial Google Doc creation. Subsequent syncs update the existing document, ensuring the URL remains stable for collaborators.

Related Skills

Explore More Software Engineering Skills→
lanejlanej
40

gspace

Automate Google Workspace file and data management via gspace CLI and MCP tools.

Community
Intermediate
m13vm13v
312

recipe-create-doc-from-template

Copy a Google Docs template, fill it with content, and share it with collaborators.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
SantiagoisperSantiagoisper

ce-proof

Upload local Markdown files to Proof for collaborative review and editing.

Community
Advanced