convert-word-to-md
Converts Word (.docx) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Use this skill whenever the user shares, references, or asks about a .docx file — even if they don''t say "convert" or "markdown" explicitly. This includes requests to "read", "summarize", "review", "extract data from", "compare", or "analyze" a Word document, resume, report, contract, or proposal. Always run the bundled conversion script to produce Markdown first; do not attempt to parse .docx content directly or write ad-hoc conversion code. Also use this skill
Profile →npx skills add github/awesome-copilot --skill convert-word-to-md --agent copilot
Same command for any agent — swap --agent for claude-code, codex, cursor.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Convert Word to Markdown ## When to use this skill Trigger this skill any time there is a `.docx` file that needs to be understood or processed — for example, a user attaches a Word document and asks questions about it, wants a summary, wants specific data pulled out, or wants multiple Word documents in a folder processed together. Word's native `.docx` format is a zipped XML bundle that is not reliably readable as plain text, so always convert it to Markdown first using the script in this skill rather than trying to open or parse the file directly. This skill only supports `.docx`. If asked to convert a legacy `.doc` file, tell the user it isn't supported and ask them to re-save it as `.docx` (Word: File > Save As > Word Document (.docx)) first. **Mixed file types:** When the user references a folder or set of documents containing multiple supported file types (`.pdf`, `.docx`, `.xlsx`), this skill handles only `.docx` files. The agent MUST also invoke the sibling skills in parallel: - `convert-pdf-to-md` for any `.pdf` files - `convert-excel-to-md` for any `.xlsx` files Never process a folder and silently skip a supported file type. All three skills must be invoked together whe
- When to use this skill
- Setup (once per environment)
- Usage
- Deciding where output goes
- Troubleshooting
macOS / Linux python scripts/convert_word_to_md.py "/path/to/document.docx"
What does the convert-word-to-md skill do?
Converts Word (.docx) documents into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Use this skill whenever the user shares, references, or asks about a .docx file — even if they don''t say "convert" or "markdown" explicitly. This includes requests to "read", "summarize", "review", "extract data from", "compare", or "analyze" a Word document, resume, report, contract, or proposal. Always run the bundled conversion script to produce Markdown first; do not attempt to parse .docx content directly or write ad-hoc conversion code. Also use this skill
How do I install it?
Run `npx skills add github/awesome-copilot --skill convert-word-to-md --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From github/awesome-copilot, a repository with 37,432 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.