anydoc

Convert Word (.doc/.docx/.docm), PowerPoint (.ppt/.pps/.pot/.pptx/.pptm/.ppsx/.ppsm), Excel (.xls/.xlsx/.xlsm/.xlsb), OpenDocument (.odt/.ods/.odp), RTF, EPUB, CSV, and PDF documents to clean GitHub-Flavored Markdown locally with the Any Doc CLI (npx -y @firecrawl/anydoc@0.2.4): headings, GFM tables, slide structure, and footnotes in one pass. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly. Do not use for generating, editing, or validating documents (use documents), for ebook packaging (use epub). For scanned or image-only PDFs, use hosted OCR only when the user explicitly authorizes whole-document upload; otherwise route to local OCR tooling.

Jump to install

Repository: magnus919/agent-skills
Last source activity: August 28, 2026 at 19:33
Detected SKILL.md language: English
Stars: 64
Forks: 7

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/magnus919/agent-skills --skill anydoc

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

36 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	anydoc
description	Convert Word (.doc/.docx/.docm), PowerPoint (.ppt/.pps/.pot/.pptx/.pptm/.ppsx/.ppsm), Excel (.xls/.xlsx/.xlsm/.xlsb), OpenDocument (.odt/.ods/.odp), RTF, EPUB, CSV, and PDF documents to clean GitHub-Flavored Markdown locally with the Any Doc CLI (npx -y @firecrawl/anydoc@0.2.4): headings, GFM tables, slide structure, and footnotes in one pass. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly. Do not use for generating, editing, or validating documents (use documents), for ebook packaging (use epub). For scanned or image-only PDFs, use hosted OCR only when the user explicitly authorizes whole-document upload; otherwise route to local OCR tooling.
license	MIT
compatibility	Node.js >= 20 and npx. The pinned CLI is @firecrawl/anydoc@0.2.4; the native binary ships via npm optionalDependencies (no install step, no postinstall, no compilation). Local conversion needs no service or API key. Hosted OCR sends the whole PDF to Firecrawl Parse and may use FIRECRAWL_API_KEY. The first npx run downloads the package once (network required); later runs use the npm cache.
metadata	{"skills":"anydoc, markdown, conversion, docx, xlsx, pptx, pdf, odt, ods, odp, rtf, epub, csv, office, documents, firecrawl","tags":"conversion, markdown, office, documents","source":"https://github.com/firecrawl/anydoc"}
allowed-tools	Bash Read

Any Doc — office documents to GitHub-Flavored Markdown

The anydoc skill converts office documents, spreadsheets, presentations, ebooks, CSV, and text-based PDFs into GitHub-Flavored Markdown using the pinned Any Doc CLI (@firecrawl/anydoc v0.2.4). One shared document model and one GFM serializer produce the same logical output across formats. Local conversion runs without a service, API key, or file upload; hosted OCR is a separate explicit route.

Overview

Load this skill when a task needs the contents of a document the agent cannot read directly: a Word report to summarize, a spreadsheet to turn into a table, a slide deck to extract, a CSV to analyze, or an ebook or PDF to quote from.

The skill ships a small Python helper (scripts/anydoc) that wraps the pinned CLI and adds input pre-validation, friendly error hints, batch conversion, and --dry-run/--json output. Every recipe in references/workflows.md also shows the raw npx invocation, so the skill works with or without the helper.

First-use decision gate

Before invoking anydoc, classify the request:

If the user needs...	Do this
The contents of an existing supported document	Continue to Command Map.
Generation, editing, validation, EPUB packaging, HTML scraping, or password decryption	Stop and use the route in When not to use.
A format-fidelity or failure decision	Load the matching row in Reference Routing before choosing a command.
A conversion result	Choose stdout, `-o`, or batch; run it; then follow Verification.

Hard boundary: local anydoc conversion reads existing supported documents to Markdown without uploading them. Hosted OCR is opt-in only: it sends the whole OCR-required PDF to the configured Parse service. AnyDoc does not create, edit, validate, package, decrypt, or scrape documents.

When to use

Convert a document to markdown — Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, or text-based PDF.
Extract structure — headings, GFM tables, slide titles, speaker notes (as blockquotes), and footnotes.

Family	Extensions	Expected GFM output	Decision cue
Word	`.doc` `.docx` `.docm`	`#`–`######` headings, GFM tables, `[^n]` footnotes	Use when content extraction is enough; use `documents` when rendered layout matters.
PowerPoint	`.ppt` `.pps` `.pot` `.pptx` `.pptm` `.ppsx` `.ppsm`	slide titles as plain paragraphs, bullet lists, speaker notes as `>` blockquotes, GFM tables (PPTX/ODP; legacy `.ppt` flattens tables to text lines)	Need table fidelity? Prefer PPTX or ODP; legacy `.ppt` preserves cell text but not table structure.
Excel	`.xls` `.xlsx` `.xlsm` `.xlsb`	`## <sheet name>` heading + one GFM table per worksheet; number formats dropped (raw cell values)	Need displayed percentages, currency, or number formats? Prefer ODS; XLS/XLSX output is raw values.
OpenDocument	`.odt` `.ods` `.odp`	same document/slide shapes as DOCX/PPTX; ODS keeps formatted display values	Prefer ODS when spreadsheet display formatting is part of the meaning.
Rich Text Format	`.rtf`	same document shape as DOCX/ODT	Use for text extraction, not layout preservation.
EPUB	`.epub`	`#` chapter headings, GFM tables, internal anchor links	Use to read an existing EPUB; use `epub` to author or package one.
CSV	`.csv`	one GFM table; label-like first row promoted to header; delimiter sniffing; UTF-16 with BOM	Use for delimited tabular content; inspect delimiter and encoding when output looks wrong.
PDF	`.pdf`	headings + inline emphasis, but a lower-fidelity pipeline: tables flatten to text, footnotes and links degrade. Text-based PDFs stay local; scanned/image-only PDFs require explicit hosted OCR or another OCR tool	Use local mode by default; hosted mode uploads the whole PDF and has no page selection.

Need	Command	Choose it when
Convert one file to small markdown on stdout	`anydoc/scripts/anydoc convert <file>`	The caller needs immediate content and does not need a saved artifact.
Convert one file to a markdown file	`anydoc/scripts/anydoc convert <file> -o out.md`	The output is large, must be reviewed later, or should be preserved as an artifact.
Convert many files to a directory	`anydoc/scripts/anydoc batch <file1> <file2> ... --out-dir out/`	The request is a bounded batch and per-file output/status is useful.
Show the tool and pinned CLI version	`anydoc/scripts/anydoc info`	You need to confirm the executable and version before troubleshooting or reporting an environment issue.
Raw pinned CLI, one document	`npx -y @firecrawl/anydoc@0.2.4 <file> [-o out.md]`	The wrapper is unavailable; preserve the pinned CLI and its documented semantics.
Raw pinned CLI, read stdin	`cat data.csv \| npx -y @firecrawl/anydoc@0.2.4 - --format csv`	Bytes already arrive on stdin and the format is known; keep the producer pipeline separate from the converter.

When you need to...	Load	It answers
Choose a format or predict fidelity	references/formats.md	Supported families, output shapes, and caveats such as raw XLSX values, ODS display values, legacy `.ppt` table flattening, and PDF degradation.
Select flags, stdin syntax, output behavior, or version details	references/cli-reference.md	Verbatim help, accepted options, stdin rules, stdout/stderr behavior, pinning, and runtime requirements.
Classify a failure or decide whether to retry	references/errors.md	Exit codes, exact error vocabulary, no-OCR/encryption boundaries, and the next route.
Choose a single-file, stdin, batch, vault, or large-output recipe	references/workflows.md	End-to-end recipes, safe output handling, per-file failure routing, and resource-limit behavior.
Verify a documented upstream or fixture claim	references/sources.md	Source URLs, access dates, fixture provenance, and the verification basis for documented claims.
Shape the final evidence report	references/report-examples.md	Complete success, expected-failure, and fidelity-boundary reports to imitate after following Verification.

User's request	Reach for	Why
Generate, edit, inspect rendered layout, or validate a PDF/Word/Excel/PowerPoint artifact	`documents` skill	anydoc extracts existing document contents to Markdown; it does not author, preserve rendered layout, or validate artifacts.
Package or author an EPUB	`epub` skill	anydoc reads an existing EPUB to Markdown but never writes or validates an EPUB container.
OCR a scanned or image-only PDF	Local OCR tooling, or AnyDoc hosted OCR after explicit authorization	Local mode reports the OCR-required error without uploading; hosted mode sends the whole PDF to Firecrawl Parse.
Scrape HTML or other web content	A web-scraping skill	HTML is not a supported anydoc input.
Transcribe binary media such as images, video, or audio	A media or transcription tool	Embedded images become alt text; anydoc cannot transcribe media.
Preserve pagination, fonts, templates, or rendered layout	A document/layout tool	The only output contract is GitHub-Flavored Markdown.
Convert a password-protected file	An unencrypted copy from the document owner	anydoc has no password or decryption option.

Condition	Do not	Next
Scanned or image-only PDF / OCR-required error	Retry unchanged or upload implicitly	Use local OCR, or explicitly authorize and run `--ocr hosted --allow-hosted-upload`; page selection is unavailable.
Encrypted or password-protected document	Guess a password or retry unchanged	Request an unencrypted copy or owner-authorized re-export.
Unsupported, malformed, or resource-limit error	Guess a parser or claim partial success	Match the exact error in references/errors.md and follow its bounded route.
Exit 0 but expected structural markers are absent	Report success from the exit code alone	Inspect the output shape and source fidelity before reporting completion.

anydoc

Install options

Review the source files

Any Doc — office documents to GitHub-Flavored Markdown

Overview

First-use decision gate

When to use

Any Doc — office documents to GitHub-Flavored Markdown

Overview

First-use decision gate

When to use

Format coverage (summary)

Command Map

Reference Routing

When not to use

Verification

Common stop conditions

anydoc

Source facts

Install options

Review the source files

More from this repository

More from this repository

Any Doc — office documents to GitHub-Flavored Markdown

Overview

First-use decision gate

When to use

Any Doc — office documents to GitHub-Flavored Markdown

Overview

First-use decision gate

When to use

Format coverage (summary)

Command Map

Reference Routing

When not to use

Verification

Common stop conditions