musingfox/MarkItDown Read
markitdown/skills/markitdown-read/SKILL.md
Use when reading, summarizing, or extracting from non-plain-text files — PDF, Office docs (Word/Excel/PowerPoint), images, audio, HTML, EPUB, archives, and structured data (CSV/JSON/XML). Converts via the markitdown CLI.
$ install --global
skillsauthnpx skillsauth add musingfox/cc-plugins MarkItDown ReadInstall 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 11, 2026, 5:47 AM160.7s1 file scanned
SKILL.md
- name:
- MarkItDown Read
- description:
- >-
MarkItDown Read
Convert non-plain-text files to Markdown for reading and analysis using Microsoft's markitdown CLI.
Supported Formats
| Category | Extensions |
|----------|-----------|
| Documents | .pdf, .docx, .pptx, .xlsx, .xls |
| Web | .html, .htm |
| Images | .jpg, .jpeg, .png, .gif, .bmp, .tiff, .webp |
| Audio | .mp3, .wav, .m4a, .ogg, .flac |
| Data | .csv, .json, .xml |
| Other | .epub, .zip |
Workflow
Step 1: Check Installation
Before converting, verify markitdown is available:
command -v markitdown
If not installed, inform the user and offer installation options:
- Recommended:
uv tool install 'markitdown[all]'(isolated install, no virtual env pollution) - Alternative:
pip install 'markitdown[all]'
Ask the user which method they prefer before installing. Do NOT install without confirmation.
Step 2: Convert and Read
Run markitdown on the target file and capture stdout:
markitdown <file-path>
The output is Markdown text printed to stdout. Read the output directly — do not save to a file unless the user explicitly asks.
Step 3: Present Content
After conversion, work with the Markdown output as if the file had been read natively:
- Answer questions about the content
- Summarize, extract, or analyze as requested
- Reference specific sections, tables, or data points
Important Notes
- For large files, the output may be extensive. Summarize first, then dive into specifics if asked.
- Image conversion requires OCR capabilities — results depend on image quality and content.
- Audio conversion requires speech recognition — results may vary by audio quality.
- If
markitdownfails on a specific file, report the error and suggest alternative approaches. - When the user asks to "read" or "open" a supported file type, prefer this skill over the Read tool for binary formats (PDF, DOCX, PPTX, XLSX, images, audio, EPUB, ZIP). For plain-text formats (HTML, CSV, JSON, XML), use this skill only when the user specifically wants Markdown conversion or when the Read tool output is insufficient.
Related Skills
musingfox/jot
data-ai
VerifiedTrustedCommunity
Unified entry point for Obsidian daily-note captures and long-form notes. Triggers on "記一下 / log / 紀錄 / capture this / 寫到 journal" (→ cap mode) and "建立筆記 / new note / 寫一份筆記 / create a note on" (→ note mode). Also via `/obw:cap` and `/obw:note`. Requires `.obsidian.yaml`.
2SKILL.mdUpdated May 11, 2026
musingfox/gog
tools
VerifiedTrustedCommunity
Use the `gog` CLI to operate Google Workspace — Gmail (read/search/send/labels/drafts), Calendar (events/RSVP/freebusy/focus-time/out-of-office), and Drive (list/search/upload/ download/share/move). Triggers on any Gmail, inbox, email, calendar, agenda, meeting, schedule, RSVP, Drive, Google Doc/Sheet/Slides, file share, or upload/download request.
2SKILL.mdUpdated May 11, 2026
musingfox/init
documentation
VerifiedTrustedCommunity
Interactively create .obsidian.yaml for a project and install starter templates (task / doc / adr) into the vault's Templates folder. Skips templates that already exist; never overwrites.
2SKILL.mdUpdated May 3, 2026
musingfox/hook-guard
tools
VerifiedTrustedCommunity
Manage project hook-guard installation — set up, diagnose, or update Claude Code hooks, git pre-commit, and commit-msg scripts with security checks, code-quality gates, and CLAUDECODE skip logic. Triggers on "set up hooks", "configure pre-commit", "add linting hooks", "initialize hook-guard", "check hooks", "hook doctor", "verify hook setup", "troubleshoot hooks", "update hooks", "regenerate hooks", "sync hooks with current tools", or similar requests.
2SKILL.mdUpdated May 3, 2026