How do I install the Office To Markdown skill?

Run npx skillmds@latest add to-aoki/office-to-markdown in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Office To Markdown safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Office To Markdown?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Office To Markdown free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Office To Markdown?

to-aoki (@to-aoki) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Office To Markdown by to-aoki — Agent Skill

Name: Office To Markdown
Rating: 4.2 (5 reviews)
Author: to-aoki

Office To Markdown

Use this skill when the user asks to convert a Microsoft Word, Excel, or PowerPoint file into Markdown. The file path may be explicit, partial, or omitted if the target Office file can be inferred from the workspace. Use it for .docx, .xlsx, and .pptx files, and create or return Markdown output.

to-aoki Updated Sep 22, 2026

File contents

Office to Markdown

Use this skill only for Office to Markdown conversion. For every conversion request, you must use the bundled script scripts/office_to_markdown.py. Do not convert Office files manually in your own reasoning or by writing the Markdown yourself.

Supported files

.docx
.xlsx
.pptx

Do not use this skill for .doc, .xls, or .ppt. If the user gives one of those old formats, tell them to save it as .docx, .xlsx, or .pptx.

Do This

Find the target Office file.
Run scripts/office_to_markdown.py once. This step is mandatory.
If the user asked for a file, use --output.
If the user did not ask for a file, return the Markdown result.
After the conversion result is available, stop.

Workspace discovery and output paths must stay inside the workspace scope provided by the host runner.

Do Not Do This

Do not think in loops.
Do not repeat the same judgment.
Do not output self-talk.
Do not output filler such as Yes., Ok., The end.
Do not run the script more than once unless the first run clearly failed.
Do not do extra formatting passes.
Do not answer from memory instead of running the script.
Do not inspect Office XML and then compose the Markdown by hand.
Do not skip the script even if the expected output seems obvious.

Commands

Basic:

python scripts/office_to_markdown.py --input <path>

Write file:

python scripts/office_to_markdown.py --input <path> --output <path-to-markdown>

If the file path is missing, use workspace discovery:

python scripts/office_to_markdown.py --kind pptx

If the file path is vague, use a query:

python scripts/office_to_markdown.py --kind pptx --query "quarterly roadmap"

Optional:

--title <title>
--template <path>
--kind <word|excel|powerpoint|docx|xlsx|pptx>
--query <text>

The host runner prepends --workspace <path> automatically.

Templates

Default template:

assets/markdown-template.md

Format-specific templates:

assets/docx-template.md
assets/excel-template.md
assets/pptx-template.md

Use a format-specific template only if the user asks for a specific layout.

Output Rules

Preserve the extracted structure.
Word: keep headings, paragraphs, and tables when possible.
Excel: output one section per sheet.
PowerPoint: output one section per slide.
If there is little or no text, say so plainly.

Final Response

If you created a file, say which file you created. If you did not create a file, return the converted Markdown. Do not add analysis before or after the result. Before the final response, confirm that the script was run and use its result.

---name: office-to-markdowndescription: Use this skill when the user asks to convert a Microsoft Word, Excel, or PowerPoint file into Markdown. The file path may be explicit, partial, or omitted if the target Office file can be inferred from the workspace. Use it for .docx, .xlsx, and .pptx files, and create or return Markdown output.---# Office to MarkdownUse this skill only for Office to Markdown conversion.For every conversion request, you must use the bundled script `scripts/office_to_markdown.py`.Do not convert Office files manually in your own reasoning or by writing the Markdown yourself.## Supported files- `.docx`- `.xlsx`- `.pptx`Do not use this skill for `.doc`, `.xls`, or `.ppt`.If the user gives one of those old formats, tell them to save it as `.docx`, `.xlsx`, or `.pptx`.## Do This1. Find the target Office file.2. Run `scripts/office_to_markdown.py` once. This step is mandatory.3. If the user asked for a file, use `--output`.4. If the user did not ask for a file, return the Markdown result.5. After the conversion result is available, stop.Workspace discovery and output paths must stay inside the workspace scope provided by the host runner.## Do Not Do This- Do not think in loops.- Do not repeat the same judgment.- Do not output self-talk.- Do not output filler such as `Yes.`, `Ok.`, `The end.`- Do not run the script more than once unless the first run clearly failed.- Do not do extra formatting passes.- Do not answer from memory instead of running the script.- Do not inspect Office XML and then compose the Markdown by hand.- Do not skip the script even if the expected output seems obvious.## CommandsBasic:`python scripts/office_to_markdown.py --input <path>`Write file:`python scripts/office_to_markdown.py --input <path> --output <path-to-markdown>`If the file path is missing, use workspace discovery:`python scripts/office_to_markdown.py --kind pptx`If the file path is vague, use a query:`python scripts/office_to_markdown.py --kind pptx --query "quarterly roadmap"`Optional:- `--title <title>`- `--template <path>`- `--kind <word|excel|powerpoint|docx|xlsx|pptx>`- `--query <text>`The host runner prepends `--workspace <path>` automatically.## TemplatesDefault template:- `assets/markdown-template.md`Format-specific templates:- `assets/docx-template.md`- `assets/excel-template.md`- `assets/pptx-template.md`Use a format-specific template only if the user asks for a specific layout.## Output Rules- Preserve the extracted structure.- Word: keep headings, paragraphs, and tables when possible.- Excel: output one section per sheet.- PowerPoint: output one section per slide.- If there is little or no text, say so plainly.## Final ResponseIf you created a file, say which file you created.If you did not create a file, return the converted Markdown.Do not add analysis before or after the result.Before the final response, confirm that the script was run and use its result.

Frequently asked questions