feat: add convert-excel-to-md, convert-pdf-to-md, and convert-word-to-md skills by 1YaoWei0 · Pull Request #2294 · github/awesome-copilot

1YaoWei0 · 2026-07-14T08:03:15Z

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

Pull Request Checklist

I have read and followed the CONTRIBUTING.md guidelines.
I have read and followed the Guidance for submissions involving paid services.
My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
The file follows the required naming convention.
The content is clearly structured and follows the example format.
I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
I have run npm start and verified that README.md is up to date.
I am targeting the main branch for this pull request.

Description

Type of Contribution

Additional Notes

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

…-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>

github-actions · 2026-07-14T08:03:42Z

🔒 PR Risk Scan Results

Scanned 17 changed file(s).

Severity	Count
🔴 High	0
🟠 Medium	5
ℹ️ Info	3

Severity	Rule	File	Line	Match
🟠	`package-exec-command`	`docs/README.skills.md`	31	\| [acreadiness-assess](../skills/acreadiness-assess/SKILL.md)<br />`gh skills install github/awesome-copilot acreadiness-assess` \| Run the AgentRC readiness assessment on the curre
ℹ️	`skill-script-touched`	`skills/convert-excel-to-md/scripts/convert_excel_to_md.py`	1	`skills/convert-excel-to-md/scripts/convert_excel_to_md.py`
🟠	`unpinned-version-indicator`	`skills/convert-excel-to-md/scripts/requirements.txt`	1	`markitdown[xlsx]>=0.1.0`
ℹ️	`skill-script-touched`	`skills/convert-pdf-to-md/scripts/convert_pdf_to_md.py`	1	`skills/convert-pdf-to-md/scripts/convert_pdf_to_md.py`
🟠	`unpinned-version-indicator`	`skills/convert-pdf-to-md/scripts/requirements.txt`	1	`markitdown[pdf]>=0.1.0`
🟠	`unpinned-version-indicator`	`skills/convert-pdf-to-md/scripts/requirements.txt`	2	`pymupdf>=1.24.0`
ℹ️	`skill-script-touched`	`skills/convert-word-to-md/scripts/convert_word_to_md.py`	1	`skills/convert-word-to-md/scripts/convert_word_to_md.py`
🟠	`unpinned-version-indicator`	`skills/convert-word-to-md/scripts/requirements.txt`	1	`markitdown[docx]>=0.1.0`

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

github-actions · 2026-07-14T08:05:26Z

🔍 Vally Lint Results

✅ All checks passed

Scope	Checked
Skills	3
Agents	0
Total	3

Severity	Count
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	npm warn EBADENGINE Unsupported engine {
ℹ️	npm warn EBADENGINE package: 'commander@15.0.0',
ℹ️	npm warn EBADENGINE required: { node: '>=22.12.0' },
ℹ️	npm warn EBADENGINE current: { node: 'v20.20.2', npm: '10.8.2' }
ℹ️	npm warn EBADENGINE }
ℹ️	npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
ℹ️	✅ convert-excel-to-md (2/2 checks passed)
ℹ️	✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️	✓ spec-compliance: All spec checks passed.
ℹ️	✓ [valid-refs] All file references across 1 skill(s) are valid.

Full linter output

### Linting skills/convert-excel-to-md
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'commander@15.0.0',
npm warn EBADENGINE   required: { node: '>=22.12.0' },
npm warn EBADENGINE   current: { node: 'v20.20.2', npm: '10.8.2' }
npm warn EBADENGINE }
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
✅ convert-excel-to-md (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

### Linting skills/convert-pdf-to-md
✅ convert-pdf-to-md (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

### Linting skills/convert-word-to-md
✅ convert-word-to-md (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

Copilot

Pull request overview

Adds three document-to-Markdown skills using MarkItDown, with image extraction, batch conversion, setup guidance, and generated catalog entries.

Changes:

Adds Excel, PDF, and Word conversion scripts.
Documents installation, usage, output, and troubleshooting.
Registers all three skills in the skills catalog.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
`skills/convert-excel-to-md/SKILL.md`	Defines the Excel conversion skill.
`skills/convert-excel-to-md/scripts/requirements.txt`	Declares Excel dependencies.
`skills/convert-excel-to-md/scripts/convert_excel_to_md.py`	Converts workbooks and extracts images.
`skills/convert-excel-to-md/references/setup.md`	Documents Excel setup.
`skills/convert-pdf-to-md/SKILL.md`	Defines the PDF conversion skill.
`skills/convert-pdf-to-md/scripts/requirements.txt`	Declares PDF dependencies.
`skills/convert-pdf-to-md/scripts/convert_pdf_to_md.py`	Converts PDFs and extracts images.
`skills/convert-pdf-to-md/references/setup.md`	Documents PDF setup.
`skills/convert-word-to-md/SKILL.md`	Defines the Word conversion skill.
`skills/convert-word-to-md/scripts/requirements.txt`	Declares Word dependencies.
`skills/convert-word-to-md/scripts/convert_word_to_md.py`	Converts DOCX files and extracts images.
`skills/convert-word-to-md/references/setup.md`	Documents Word setup.
`docs/README.skills.md`	Adds the skills to the catalog.

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>

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

…etup

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 9 comments.

… documentation

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 5 comments.

bishop335 · 2026-07-14T08:47:39Z

#2294 (review)

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

…ert-to-md skills

…1YaoWei0/awesome-copilot into contribute-convert-to-md-skills

Copilot

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.

Copilot

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 6 comments.

Copilot

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 12 comments.

Copilot

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 5 comments.

aaronpowell

The comment I have on the Excel setup is applicable to all skills

aaronpowell · 2026-07-14T23:35:38Z

There are also some copilot comments worth reviewing, esp the one about the README.

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

Copilot

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 8 comments.

… error handling

Copilot

Pull request overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 12 comments.

1YaoWei0 requested a review from aaronpowell as a code owner July 14, 2026 08:03

Copilot AI review requested due to automatic review settings July 14, 2026 08:03

github-actions Bot added new-submission PR adds at least one new contribution skills PR touches skills labels Jul 14, 2026

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 08:03 View session

github-actions Bot added the skill-check-error Skill validator reported errors label Jul 14, 2026

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 14, 2026 08:10

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 08:10 View session

github-actions Bot removed the skill-check-error Skill validator reported errors label Jul 14, 2026

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Comment thread docs/README.skills.md Outdated

Comment thread skills/convert-word-to-md/references/setup.md Outdated

Comment thread skills/convert-pdf-to-md/references/setup.md Outdated

Comment thread skills/convert-excel-to-md/references/setup.md Outdated

fix: update pip install command to use scripts/requirements.txt for s…

4fc8366

…etup

Copilot AI review requested due to automatic review settings July 14, 2026 08:16

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 08:16 View session

Copilot AI reviewed Jul 14, 2026

View reviewed changes

fix: clarify installation instructions for requirements-file in setup…

a1b4d52

… documentation

Copilot AI review requested due to automatic review settings July 14, 2026 08:23

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 08:24 View session

fix: correct indentation in image extraction function

4f3404c

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 14, 2026 08:26

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 08:27 View session

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Potential fix for pull request finding

d90ffbd

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

Copilot AI review requested due to automatic review settings July 14, 2026 09:44

1YaoWei0 added 2 commits July 14, 2026 21:52

feat: add comprehensive documentation and setup instructions for conv…

b6291e8

…ert-to-md skills

Merge branch 'contribute-convert-to-md-skills' of https://github.com/…

c8f1a6e

…1YaoWei0/awesome-copilot into contribute-convert-to-md-skills

Copilot AI review requested due to automatic review settings July 14, 2026 13:53

github-actions Bot added the plugin PR touches plugins label Jul 14, 2026

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 13:53 View session

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

95f21d2

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Comment thread plugins/convert-to-md/.github/plugin/plugin.json Outdated

Comment thread plugins/convert-to-md/.github/plugin/plugin.json

Copilot AI review requested due to automatic review settings July 14, 2026 13:58

fix: reorder skills in plugin.json for consistency

09c28de

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 13:58 View session

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

c81779e

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 14, 2026 14:09

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 14:09 View session

Copilot AI reviewed Jul 14, 2026

View reviewed changes

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

6946f55

Copilot AI review requested due to automatic review settings July 14, 2026 14:48

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 14:49 View session

Copilot AI reviewed Jul 14, 2026

View reviewed changes

aaronpowell requested changes Jul 14, 2026

View reviewed changes

Comment thread skills/convert-excel-to-md/references/setup.md Outdated

1YaoWei0 changed the title ~~feat: add convert-to-md, convert-pdf-to-md, and convert-word-to-md skills~~ feat: add convert-excel-to-md, convert-pdf-to-md, and convert-word-to-md skills Jul 14, 2026

Potential fix for pull request finding

54f33c3

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

Copilot AI review requested due to automatic review settings July 14, 2026 23:56

Copilot started reviewing on behalf of 1YaoWei0 July 14, 2026 23:57 View session

Copilot AI reviewed Jul 15, 2026

View reviewed changes

fix: enhance conversion skills to handle mixed file types and improve…

cf5714d

… error handling

Copilot AI review requested due to automatic review settings July 15, 2026 05:08

Copilot started reviewing on behalf of 1YaoWei0 July 15, 2026 05:08 View session

Copilot AI reviewed Jul 15, 2026

View reviewed changes

Uh oh!

Conversation

1YaoWei0 commented Jul 14, 2026

Pull Request Checklist

Description

Type of Contribution

Additional Notes

Uh oh!

github-actions Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔒 PR Risk Scan Results

Uh oh!

github-actions Bot commented Jul 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Vally Lint Results

Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bishop335 commented Jul 14, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 14, 2026 •

edited

Loading

github-actions Bot commented Jul 14, 2026 •

edited

Loading