feat: add convert-excel-to-md, convert-pdf-to-md, and convert-word-to-md skills (#2294)

* feat: add convert-excel-to-md, convert-pdf-to-md, and convert-word-to-md skills

Add three new agent skills that convert common document formats to Markdown
using bundled Python scripts powered by MarkItDown:

- convert-excel-to-md: Converts .xlsx workbooks to Markdown with per-sheet
  tables and embedded image extraction via a bundled Python script.
- convert-pdf-to-md: Converts .pdf documents to Markdown with text/table
  extraction and embedded image extraction via PyMuPDF.
- convert-word-to-md: Converts .docx documents to Markdown with proper
  image extraction replacing MarkItDown's base64 placeholders.

Each skill includes:
- SKILL.md with detailed usage instructions, output structure docs, and
  a troubleshooting table
- scripts/ with the conversion Python script and requirements.txt
- references/setup.md with environment setup instructions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: remove Markdown image syntax from convert-word-to-md SKILL.md

The CI valid-refs linter flagged the literal Markdown image syntax
containing a data URI as an invalid file reference. Replaced it with
a plain text description of the placeholder format.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: update pip install command to use scripts/requirements.txt for setup

* fix: clarify installation instructions for requirements-file in setup documentation

* fix: correct indentation in image extraction function

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* feat: add comprehensive documentation and setup instructions for convert-to-md skills

* fix: add trailing slashes to skill paths in plugin.json

* fix: reorder skills in plugin.json for consistency

* fix: update plugin.json and README.md for clarity and consistency

* feat: add convert-to-md plugin and update related documentation

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* fix: enhance conversion skills to handle mixed file types and improve error handling

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
Willie Yao
2026-07-16 07:06:49 +08:00
committed by GitHub
parent 733c8cd009
commit e4a1f57fd9
17 changed files with 1661 additions and 0 deletions
+24
View File
@@ -0,0 +1,24 @@
{
"name": "convert-to-md",
"description": "A collection of Copilot skills that convert common document formats into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Just tell Copilot what you need — the right skill is invoked automatically and the conversion happens behind the scenes.",
"version": "1.0.1",
"keywords": [
"skills",
"configuration",
"copilot",
"convert-word-to-md",
"convert-excel-to-md",
"convert-pdf-to-md"
],
"author": {
"name": "Willie Yao",
"url": "https://github.com/1YaoWei0"
},
"repository": "https://github.com/github/awesome-copilot",
"license": "MIT",
"skills": [
"./skills/convert-excel-to-md/",
"./skills/convert-pdf-to-md/",
"./skills/convert-word-to-md/"
]
}
+47
View File
@@ -0,0 +1,47 @@
# Convert to Markdown Plugin
A collection of Copilot skills that convert common document formats into Markdown so their contents can be accurately analyzed, summarized, searched, or extracted from. Just tell Copilot what you need — the right skill is invoked automatically and the conversion happens behind the scenes.
## Installation
```bash
copilot plugin install convert-to-md@awesome-copilot
```
## What's Included
This plugin includes Word, Excel, and PDF conversion skills, detailed below.
## Source
This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot).
## Skills
### convert-word-to-md
Converts Word (`.docx`) documents to Markdown. Use it any time you want to read, summarize, review, compare, or extract information from a `.docx` file — even if you don't say "convert" explicitly.
> "Summarize this Word document."
> "Extract all the action items from report.docx."
> "Compare these two contracts."
### convert-excel-to-md
Converts Excel (`.xlsx`) workbooks to Markdown, rendering each sheet as a table. Use it any time you want to analyze, query, or summarize data in a spreadsheet — single file or a whole folder at once.
> "What are the top 5 rows by revenue in this spreadsheet?"
> "Summarize all the worksheets in this workbook."
> "Process every Excel file in this folder."
### convert-pdf-to-md
Converts PDF (`.pdf`) documents to Markdown, extracting both text and embedded images. Use it any time you want to read, summarize, or pull data from a PDF report, invoice, paper, or form.
> "Summarize this PDF."
> "Extract all the dates mentioned in this contract."
> "Process all the PDFs in this folder."
## License
MIT