Agent-Skills.md

Agent Skills: md2docs

Use when explicitly converting a Markdown file into a formatted Google Doc. Triggers on "Markdown to Google Doc" or "publish this markdown as a doc".

UncategorizedID: v1-io/v1tamins/v1-md2docs

Repository

v1-io/v1tamins
v1-ioLicense: MIT
61

Install this agent skill to your local

pnpm dlx add-skill https://github.com/v1-io/v1tamins/tree/HEAD/plugins/v1tamins/skills/v1-md2docs

Skill Files

Browse the full folder contents for v1-md2docs.

Download Skill

Loading file tree…

plugins/v1tamins/skills/v1-md2docs/SKILL.md

Skill Metadata

Name
v1-md2docs
Description
Use when explicitly converting a Markdown file into a formatted Google Doc. Triggers on "Markdown to Google Doc" or "publish this markdown as a doc".

md2docs

Convert a Markdown file to a formatted Google Doc with one command.

Usage

Typical invocations:

  • Claude Code: /v1-md2docs path/to/file.md
  • Codex: invoke v1-md2docs from the skills menu or use $v1-md2docs path/to/file.md

Optional arguments after the file path:

  • --title "Custom Title" to override the doc title (default: filename as title case)
  • --no-open to skip opening the browser

Workflow

  1. Resolve the markdown file path from the user input.
  2. Run the conversion script from the skill root:
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
RESOLVER=""
for candidate in \
  "$REPO_ROOT/plugins/v1tamins/scripts/resolve-skill-root.sh" \
  "${CLAUDE_PLUGIN_ROOT:-}/scripts/resolve-skill-root.sh" \
  "$HOME/.claude/skills/v1-md2docs/../../scripts/resolve-skill-root.sh" \
  "$HOME/.codex/skills/v1-md2docs/../../scripts/resolve-skill-root.sh" \
  "$HOME/.claude/plugins/cache"/*/v1tamins/*/scripts/resolve-skill-root.sh \
  "$HOME/.codex/plugins/cache/v1tamins/v1tamins"/*/scripts/resolve-skill-root.sh; do
  [ -x "$candidate" ] && RESOLVER="$candidate" && break
done
if [ -z "${RESOLVER:-}" ]; then
  echo "ERROR: Could not find resolve-skill-root.sh" >&2
  exit 1
fi
SKILL_ROOT="$("$RESOLVER" v1-md2docs scripts/md2docs.py)"

python3 "$SKILL_ROOT/scripts/md2docs.py" <file_path> [--title "Title"] [--no-open]
  1. Report the Google Doc URL back to the user.

First-Time Setup

If the script reports No client_secret.json found, guide the user through setup:

  1. Go to Google Cloud Console
  2. Create a project or use an existing one
  3. Enable the Google Drive API
  4. Go to APIs & Services > Credentials
  5. Create an OAuth 2.0 Client ID with application type Desktop app
  6. Download the JSON file
  7. Save it to ~/.md2docs/client_secret.json

The first run opens a browser for OAuth consent. After that, the token is cached at ~/.md2docs/token.json and no browser auth is needed until the token expires.

Each developer authenticates with their own Google account. Docs are created in their personal Google Drive.

What Gets Formatted

  • H1-H6 headings with native Google Docs heading styles
  • Bold, italic, and bold+italic
  • inline code with Courier New font and gray background
  • Fenced code blocks with Courier New font, gray background, and border
  • Tables with bordered cells and header row styling
  • Unordered and ordered lists with proper nesting
  • Links as clickable hyperlinks
  • Horizontal rules
  • Mermaid diagrams rendered as embedded images when mmdc or npx is available

Environment Variables

  • MD2DOCS_CLIENT_SECRET overrides the default client_secret.json path

Dependencies

The script auto-installs these pip packages on first run if missing:

  • markdown
  • google-auth
  • google-auth-oauthlib
  • google-api-python-client

Optional for Mermaid diagram rendering:

  • mmdc or npx with @mermaid-js/mermaid-cli