v1-io/v1-md2docs
plugins/v1tamins/skills/v1-md2docs/SKILL.md
Convert a Markdown file into a nicely formatted Google Doc and open it in the browser. Use when the user wants to create a Google Doc from a .md file, share markdown content as a Google Doc, or invoke md2docs. Handles headings, bold, italic, inline code, fenced code blocks, tables, lists, links, horizontal rules, and mermaid diagrams.
$ install --global
skillsauthnpx skillsauth add v1-io/v1tamins v1-md2docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 2:14 AM150.2s3 files scanned
SKILL.md
- name:
- v1-md2docs
- description:
- Convert a Markdown file into a nicely formatted Google Doc and open it in the browser. Use when the user wants to create a Google Doc from a .md file, share markdown content as a Google Doc, or invoke md2docs. Handles headings, bold, italic, inline code, fenced code blocks, tables, lists, links, horizontal rules, and mermaid diagrams.
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-md2docsfrom 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-opento skip opening the browser
Workflow
- Resolve the markdown file path from the user input.
- Run the conversion script from the skill root:
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
for dir in \
"$REPO_ROOT/plugins/v1tamins/skills/v1-md2docs" \
"${CLAUDE_PLUGIN_ROOT:-}" \
"$HOME/.codex/skills/v1-md2docs" \
"$HOME/.claude/skills/v1-md2docs"; do
[ -n "$dir" ] && [ -f "$dir/scripts/md2docs.py" ] && SKILL_ROOT="$dir" && break
done
if [ -z "${SKILL_ROOT:-}" ]; then
echo "ERROR: Could not find scripts/md2docs.py" >&2
exit 1
fi
python3 "$SKILL_ROOT/scripts/md2docs.py" <file_path> [--title "Title"] [--no-open]
- 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:
- Go to Google Cloud Console
- Create a project or use an existing one
- Enable the Google Drive API
- Go to APIs & Services > Credentials
- Create an OAuth 2.0 Client ID with application type Desktop app
- Download the JSON file
- 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 codewith 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
mmdcornpxis available
Environment Variables
MD2DOCS_CLIENT_SECREToverrides the defaultclient_secret.jsonpath
Dependencies
The script auto-installs these pip packages on first run if missing:
markdowngoogle-authgoogle-auth-oauthlibgoogle-api-python-client
Optional for Mermaid diagram rendering:
mmdcornpxwith@mermaid-js/mermaid-cli
Related Skills
v1-io/v1-testing-prototypes
tools
VerifiedTrustedCommunity
Use when planning or synthesizing user tests for prototypes, mockups, clickable demos, product concepts, design flows, landing pages, or early product specs. Triggers on "test this prototype", "prototype testing", "user test plan", "validate this product idea", "test with users".
5SKILL.mdUpdated Jun 13, 2026
v1-io/v1-html-it
development
VerifiedTrustedCommunity
Use when creating a polished self-contained HTML page would help the user understand, compare, review, present, tune, or interact with information better than Markdown. Triggers on "make an HTML page", "HTML artifact", "nice HTML", "visual report", "interactive explainer", "one-page dashboard", "shareable page".
5SKILL.mdUpdated Jun 13, 2026
v1-io/v1-canon2skill
data-ai
VerifiedTrustedCommunity
Use when turning a textbook, PDF, blog post, article, paper, course, notes, transcript, or other source material into suggested agent skills or skill improvements. Triggers on "what skills could come from this", "extract skills from", "turn this into skills", "skill ideas from this source".
5SKILL.mdUpdated Jun 13, 2026
v1-io/v1-deep-review
development
VerifiedTrustedCommunity
Run an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth. Use for large prs, new features/architectures, a deep code quality audit, or especially harsh maintainability review.
5SKILL.mdUpdated May 23, 2026