gdoc-to-markdown

1# Google Docs & Sheets Fetcher
2 
3Internal module — invoked by `/bedrock:teach` Phase 1 and `/bedrock:sync` Phase 2, not user-invocable.
4 
5Fetches a Google Docs document or Google Sheets spreadsheet and converts it to a local Markdown file.
6Supports both document types with automatic detection. Three layers in fallback order:
7**MCP (preferred) → API / Public Export → Browser DOM extraction.**
8 
9**Dependency:** Browser fallback (Layer 3) requires `scripts/extract.js` (relative to this skill directory).
10 
11---
12 
13## Step 1 — Parse URL and Detect Type
14 
15Parse the URL. Accept these formats:
16 
17**Google Docs:**
18- `https://docs.google.com/document/d/{docId}/edit`
19- `https://docs.google.com/document/d/{docId}/edit#heading=...`
20- `https://docs.google.com/document/d/{docId}/edit?tab=t.0`
21- `https://docs.google.com/document/d/{docId}`
22- Raw document ID (no URL) — treat as Doc by default
23 
24**Google Sheets:**
25- `https://docs.google.com/spreadsheets/d/{docId}/edit`
26- `https://docs.google.com/spreadsheets/d/{docId}/edit#gid=0`
27- `https://docs.google.com/spreadsheets/d/{docId}`
28- Raw spreadsheet ID — only if the user explicitly mentions "sheet" or "spreadsheet"
29 
30**Detect type:**
31- URL contains `/spreadsheets/d/` → **Sheet**
32- URL contains `/document/d/` → **Doc**
33- Raw ID with no URL → default to **Doc** unless user context indicates Sheet
34 
35Extract the `{docId}` — the string between `/d/` and the next `/` or end of path.
36 
37---
38 
39## Step 2 — Layer 1: MCP (Google Docs)
40…