1coos-markdown-converter

v1.0.1

Convert files to beautifully formatted Markdown. TRIGGER when user asks to convert a file to Markdown, extract text from PDF/DOCX/PPTX/XLSX, or format a docu...

0· 16·1 current·1 all-time
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
The name/description (convert many file types to Markdown) matches the code and install spec: the skill runs a local converter (markitdown[all]) and then formats the Markdown. Requested binaries (bun to run the included script, uvx to run or install the markitdown package) are reasonable for this purpose. Minor inconsistencies: the install spec uses an 'uv' package entry while runtime checks and instructions reference 'uvx'; SKILL.md instructs 'bun run ${CLAUDE_SKILL_DIR}/scripts/main.ts' but the bundle contains scripts/main.js (filename/type mismatch) which could cause runtime failures.
Instruction Scope
Runtime instructions are focused on converting a user-supplied file and formatting the output; the code checks file existence, runs the converter, and applies formatting. The skill may read an optional config.json in its own directory. It does not request or attempt to read unrelated system files or environment variables. Note: it supports optional Azure Document Intelligence (mentioned in docs) but does not declare Azure credentials — using that feature would require extra configuration outside this bundle.
Install Mechanism
The install spec installs markitdown[all] via 'uv' (astral/uv ecosystem). This will pull in the 'all' set of dependencies (OCR, audio transcription, PDF tooling), which can be large and may pull native libraries. The installer referenced in SKILL.md (https://astral.sh/uv/install.sh) is the official uv installer URL, not an opaque shortener or personal host. This is a moderate-risk install because it downloads external packages/dependencies, but it's coherent for a converter that claims OCR and audio transcription support.
Credentials
The skill declares no required environment variables or credentials, which matches the bundle. One caveat: the docs reference optional Azure Document Intelligence usage (CLI flags -d / -e) — enabling that would require an Azure endpoint or credential configured outside the declared requirements. No other unrelated credentials are requested.
Persistence & Privilege
The skill does not request persistent or system-wide privileges (always is false). It does not attempt to modify other skills or system-wide agent configuration. It only installs/uses the markitdown binary and caches dependencies in the normal uv ecosystem.
Assessment
This skill appears to do what it says, but check a few things before installing: 1) Fix the filename mismatch: SKILL.md runs scripts/main.ts but the bundle provides scripts/main.js — confirm the runtime command will actually invoke the included script. 2) Ensure you want the 'markitdown[all]' bundle: the 'all' variant pulls in OCR, audio-transcription and PDF toolchains (potentially large native deps). 3) Confirm you are comfortable with the uv/uvx installer (the SKILL.md points to the official astral.sh installer) and that your environment has bun available. 4) If you plan to use Azure Document Intelligence, prepare and secure any Azure endpoint/credentials — the skill mentions that feature but does not declare or manage Azure secrets itself. 5) Test with non-sensitive files first to validate behavior. If you are not comfortable with the installer/network downloads or with enabling optional cloud OCR/transcription, do not install or run the skill until those concerns are resolved.

Like a lobster shell, security has layers — review code before you run it.

latestvk97633z0k44k1j8v0yafxewxgx848ymd

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

📝 Clawdis
Binsbun, uvx

Install

uv
Bins: markitdown
uv tool install markitdown[all]

Comments