# Gws Docs To Markdown

> >

- **Type:** Skill
- **Install:** `agentstack add skill-shibayu36-agent-skills-gws-docs-to-markdown`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shibayu36](https://agentstack.voostack.com/s/shibayu36)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shibayu36](https://github.com/shibayu36)
- **Source:** https://github.com/shibayu36/agent-skills/tree/main/skills/gws-docs-to-markdown

## Install

```sh
agentstack add skill-shibayu36-agent-skills-gws-docs-to-markdown
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Google Docs to Markdown

Given a Google Docs URL, generate a lightweight Markdown file and image files.

## Usage

```bash
${SKILL_DIR}/scripts/read_gdoc.sh "GOOGLE_DOCS_URL_OR_DOC_ID" "OUTPUT_DIR"
```

- `GOOGLE_DOCS_URL_OR_DOC_ID` (required): Google Docs URL (e.g. `https://docs.google.com/document/d/DOC_ID/edit`) or DOC_ID
- `OUTPUT_DIR` (required): Output directory (e.g. `tmp/`)

## Workflow

1. Run the script.
2. The path to the generated Markdown file is printed to stdout.
3. Read that path with the Read tool.
4. To inspect images, use the Read tool on files under `{OUTPUT_DIR}/images_{DOC_ID_FIRST_8_CHARS}/` (Claude is multimodal, so it can render images).

## How it works

1. Export the Google Docs as Markdown via `gws drive files export`.
2. Detect base64-embedded images in the exported Markdown.
3. Decode base64 and save them as PNG files under `{OUTPUT_DIR}/images_{DOC_ID_FIRST_8_CHARS}/`.
4. Replace image references in the Markdown with local file paths.
5. Output the cleaned Markdown to `{OUTPUT_DIR}/`.

## Notes

- `gws` CLI authentication is required (must be set up in advance).
- The Google Docs API export has a 10 MB limit.
- Google normalizes exported images to PNG (GIF/JPG uploads are returned as PNG).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shibayu36](https://github.com/shibayu36)
- **Source:** [shibayu36/agent-skills](https://github.com/shibayu36/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shibayu36-agent-skills-gws-docs-to-markdown
- Seller: https://agentstack.voostack.com/s/shibayu36
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.