← Back to Skills Marketplace
techlaai

Google Docs from Markdown

by techlaai · GitHub ↗ · v1.0.1
cross-platform ⚠ suspicious
2496
Downloads
0
Stars
10
Active Installs
2
Versions
Install in OpenClaw
/install gdocs-markdown
Description
Create Google Docs from Markdown files. Use when the user wants to create a Google Doc from Markdown content, or when working with gog CLI and need to populate Google Docs with content. This skill handles the conversion Markdown → DOCX → Google Docs via Drive upload, since gog docs CLI only supports create/export/cat/copy but NOT write/update content.
README (SKILL.md)

Google Docs from Markdown

Create Google Docs from Markdown files using the workflow: Markdown → DOCX → Drive Upload → Google Docs.

Why This Skill Exists

gog docs CLI does NOT support writing/updating content to Google Docs. It only supports:

  • create - Create empty doc
  • export - Export to file
  • cat - Read content
  • copy - Copy existing doc

This skill provides the missing workflow to create Google Docs WITH content from Markdown.

Author

Created by techla

Prerequisites

  • gog CLI authenticated with Google account
  • pandoc binary (auto-downloaded on first use if not available)

Installation Note

After installing from ClawHub, fix the script permissions:

chmod +x ~/.openclaw/workspace/skills/gdocs-markdown/scripts/gdocs-create.sh

Usage

Quick Create

# Create Google Doc from markdown file
gdocs-create.sh /path/to/file.md "Tiêu đề Document"

Manual Workflow

If you need more control, follow these steps:

  1. Ensure pandoc is available:

    # Auto-downloaded to /tmp/pandoc-3.1.11/bin/pandoc on first use
    # Or use system pandoc if available
    
  2. Convert Markdown to DOCX:

    /tmp/pandoc-3.1.11/bin/pandoc input.md -o output.docx
    
  3. Upload to Drive (auto-converts to Google Docs):

    gog drive upload output.docx
    
  4. Result: Google Drive returns a link to the converted Google Doc

Script Reference

See scripts/gdocs-create.sh for the helper script that automates this workflow.

Example

# Create a report from markdown
echo "# Báo Cáo\
\
Nội dung..." > /tmp/report.md
gdocs-create.sh /tmp/report.md "Báo Cáo Tháng 2"

# Output: https://docs.google.com/document/d/xxxxx/edit

Notes

  • Google Drive automatically converts DOCX to Google Docs format on upload
  • The resulting document is fully editable in Google Docs
  • Original DOCX file remains in Drive but can be deleted if only Google Docs version is needed
Usage Guidance
Before installing: (1) Review the scripts/gdocs-create.sh contents to see exactly what it downloads and from where — verify the pandoc download URL is an official release (e.g., GitHub releases) and that the script verifies checksums. (2) Ensure you are comfortable with the script writing to /tmp and executing a downloaded binary. (3) Confirm you have the gog CLI installed and authenticated to the intended Google account; the skill will use that existing authentication to upload files. (4) If you want to reduce risk, run the script manually in a sandbox or container first, or modify it to use a system-installed pandoc rather than auto-downloading. Providing the script's full content or the pandoc download URL would allow a higher-confidence assessment.
Capability Analysis
Type: OpenClaw Skill Name: gdocs-markdown Version: 1.0.1 The skill is classified as suspicious due to its automatic download and execution of the `pandoc` binary from a remote GitHub URL (`https://github.com/jgm/pandoc/releases/download/3.1.11/pandoc-3.1.11-linux-amd64.tar.gz`) within `scripts/gdocs-create.sh`. While `pandoc` is a legitimate tool and the source URL is official, downloading and executing external binaries from the internet represents a significant supply chain risk and a powerful capability that could be exploited if the remote source were compromised. The `SKILL.md` also instructs to `chmod +x` the script, granting it execute permissions. There is no clear evidence of intentional malicious behavior like data exfiltration or persistence, and the remote download is plausibly for the stated purpose of Markdown conversion.
Capability Assessment
Purpose & Capability
The SKILL.md clearly requires the gog CLI to be authenticated and pandoc to perform the conversion, but the registry metadata lists no required binaries or primary credential. That mismatch (declaring no required binaries while the workflow requires gog and pandoc) is an inconsistency — the skill should declare these dependencies.
Instruction Scope
The instructions themselves stay on‑topic (convert Markdown → DOCX → upload to Drive). However they instruct an 'auto-download' of pandoc to /tmp on first use. Auto-downloading an executable at runtime expands the scope (network fetch, write to /tmp, execute) beyond simple file conversion and isn't documented in the registry metadata.
Install Mechanism
There is no formal install spec, but the skill's runtime behavior includes auto-downloading a pandoc binary to /tmp. Runtime downloads of executables are higher risk unless the source is explicit and trusted; the SKILL.md does not specify the exact download URL or verification steps. The presence of a helper script that performs these actions increases the need to review it.
Credentials
The skill requests no environment variables or credentials in metadata, which is good. It does rely on an already-authenticated gog CLI (i.e., the user's Google credentials via gog) but does not declare that requirement in the registry fields — this is a minor proportionality/documentation issue rather than an extra privilege demand.
Persistence & Privilege
The skill is not marked always:true and has no special persistence flags. Model invocation is not disabled, so the agent could call the skill. Given the script may perform network downloads and execute a binary, allowing autonomous invocation increases risk; consider requiring explicit user invocation or disabling autonomous invocation if you want to avoid unexpected downloads.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gdocs-markdown
  3. After installation, invoke the skill by name or use /gdocs-markdown
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added installation note about setting executable permission for the helper script after installing from ClawHub. - No changes to workflows or functionality.
v1.0.0
- Initial release of gdocs-markdown skill. - Enables creation of Google Docs from Markdown files by converting Markdown → DOCX → Google Docs via Drive upload. - Fills the gap left by gog CLI, which does not support writing or updating content to Google Docs. - Includes gdocs-create.sh script to automate the workflow. - Automatically downloads pandoc if not available for Markdown to DOCX conversion. - Provides both quick and manual usage instructions.
Metadata
Slug gdocs-markdown
Version 1.0.1
License
All-time Installs 10
Active Installs 10
Total Versions 2
Frequently Asked Questions

What is Google Docs from Markdown?

Create Google Docs from Markdown files. Use when the user wants to create a Google Doc from Markdown content, or when working with gog CLI and need to populate Google Docs with content. This skill handles the conversion Markdown → DOCX → Google Docs via Drive upload, since gog docs CLI only supports create/export/cat/copy but NOT write/update content. It is an AI Agent Skill for Claude Code / OpenClaw, with 2496 downloads so far.

How do I install Google Docs from Markdown?

Run "/install gdocs-markdown" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google Docs from Markdown free?

Yes, Google Docs from Markdown is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Google Docs from Markdown support?

Google Docs from Markdown is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google Docs from Markdown?

It is built and maintained by techlaai (@techlaai); the current version is v1.0.1.

💬 Comments