Markdown

A collection of agent skills for AI-assisted development.

Install

npx -y skills add pavelsimo/skills --skill markdown

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Converts files to Markdown using uvx markitdown, supporting PDF, Word, PowerPoint, Excel, HTML, images with OCR, audio with transcription, ZIP archives, and YouTube URLs. Use when the user wants to convert a file or URL to Markdown.

SKILL.md

2.5 KB, 587 tokens by cl100k_base, as published. Nobody here has run it

markdown skill

Convert files to Markdown using uvx markitdown — no installation required.

features

converts documents, web/data files, media files, archives, and URLs to Markdown
supports stdout, -o output files, and stdin conversion
accepts file extension, MIME type, and charset hints for ambiguous input
can enable or list markitdown plugins when needed

usage

# convert to stdout
uvx markitdown input.pdf

# save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# from stdin
cat input.pdf | uvx markitdown

supported formats

Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
Web/Data: HTML, CSV, JSON, XML
Media: Images (EXIF + OCR), Audio (EXIF + transcription)
Other: ZIP (iterates contents), YouTube URLs, EPub

options

-o OUTPUT      # output file
-x EXTENSION   # hint file extension (for stdin)
-m MIME_TYPE   # hint MIME type
-c CHARSET     # hint charset (e.g., UTF-8)
--use-plugins  # enable 3rd-party plugins
--list-plugins # show installed plugins

examples

# convert Word document
uvx markitdown report.docx -o report.md

# convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

# convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md

workflow

identify the input file(s) or URL the user wants to convert
determine the best invocation (stdout vs -o flag vs stdin pipe) based on context
run uvx markitdown <input> — dependencies download on first run, then cache
if output looks malformed, suggest a MIME or extension hint via -x or -m
return the resulting Markdown to the user or confirm the saved file path

best practices

output preserves document structure: headings, tables, lists, links
first run caches dependencies; subsequent runs are faster
for stdin input, always pass -x or -m so markitdown knows the format

credits

Adapted from steipete/agent-scripts — markdown-converter by @steipete.