office-docs-to-markdown

name	office-docs-to-markdown
description	Convert local office and document files into Markdown, excluding PDFs. Use when the user asks to convert DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, EPUB, or similar local files into Markdown.

Office Docs To Markdown

Use this skill to convert a local file into reusable Markdown in any workspace.

Default behavior:

• Use the office-document converter runtime provided by this skill.
• Do not use this skill for PDF input. Route PDF conversion to pdf-to-markdown.
• Write the final Markdown next to the source file unless the user provides a destination.
• Keep the converted body as close as possible to raw output.
• Add a metadata block at the top, but avoid rewriting the document into a separate summary structure unless the user explicitly asks for that.

Workflow

1. Verify the source file exists and is a local path.
2. Infer the file type from the extension and fail clearly if the file is obviously unsupported or is a PDF.
3. Run bash scripts/run_document_to_markdown.sh "<source-path>" from this skill directory to get the raw conversion.
4. Inspect the raw Markdown before writing anything. If the conversion fails, is empty, or is clearly unusable, stop and report the failure.
5. Build the final Markdown by prepending a metadata block when source metadata is available, then keep the converter output body substantially intact.
6. Apply only minimal cleanup when needed for readability:
   • normalize an obviously bad title derived from the filename if better metadata is unavailable
   • remove accidental leading or trailing empty noise
   • keep page breaks, lists, headings, and extracted wording unless the user asks for a rewrite
   • add a short note only when a conversion caveat is important enough that the raw body would otherwise be misleading
7. Default the output path to a sibling Markdown file with the same basename as the source file.