docx-to-md

docx-to-md is a skill for Claude Code, Codex from fabioc-aloha/Alex_Skill_Mall. It costs 22 tokens per session (1,986 once invoked), scanned A, original, MIT.

A document converter that turns Word files into clean Markdown and extracts their images. It also normalizes headings and cleans up tables for use in version-controlled documentation.

In plain words
What is it for?
Migrate legacy documentation, specifications, statements of work, requests for proposals, and other .docx files into docs-as-code repositories or static-site projects.
Why use it?
It removes manual copying and cleanup when bringing Word documents into a Markdown-based workflow.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is node .github/muscles/docx-to-md.cjs report.docx.

Good fit Migrate legacy documentation, specifications, statements of work, requests for proposals, and other .docx files into docs-as-code repositories or static-site projects.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/fabioc-aloha/Alex_Skill_Mall
agentmods
npx agentmods add skills/fabioc-aloha/alex_skill_mall/docx-to-md

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for docx-to-md

README.md
[![agentmods](https://agentmods.dev/badge/skills/fabioc-aloha/alex_skill_mall/docx-to-md/github.svg)](https://agentmods.dev/skills/fabioc-aloha/alex_skill_mall/docx-to-md)
Your own site
<a href="https://agentmods.dev/skills/fabioc-aloha/alex_skill_mall/docx-to-md"><img src="https://agentmods.dev/badge/skills/fabioc-aloha/alex_skill_mall/docx-to-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for docx-to-md

Your own site · 80×15
<a href="https://agentmods.dev/skills/fabioc-aloha/alex_skill_mall/docx-to-md"><img src="https://agentmods.dev/badge/skills/fabioc-aloha/alex_skill_mall/docx-to-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 22 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,986 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00022 $0.01986
Opus 5 $0.00011 $0.00993
Sonnet 5 $0.00004 $0.00397
Haiku 4.5 $0.00002 $0.00199

Measured 7d ago against content hash aeb3e6b1bc78, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

docx-to-md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/converters/docx-to-md/skills/docx-to-md/SKILL.md · 251 lines

How it starts

The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Word to Markdown Conversion

Ingest Word documents into your Markdown workflow — clean, linted, version-control ready

Staleness Watch: Recheck external API and tool URLs before release or after upstream changes.

Convert .docx files into clean, linted Markdown with extracted images, normalized headings, and cleaned table formatting. The reverse converter for ingesting external documents into a Markdown-based workflow.


When to Use

  • Importing Word documents from stakeholders into a Markdown-based workflow
  • Converting legacy documentation to Markdown for version control
  • Extracting content from .docx for further processing (presentations, email, web)
  • Onboarding external resources (SOWs, RFPs, specs) into project repositories
  • Migrating from Word-based documentation to docs-as-code
  • Preparing content for static site generators (VitePress, Docusaurus, etc.)

Supported Content

Content Type Status Notes
Headings Hierarchy normalized to start at H1
Bold/Italic Converted to Markdown syntax
Links Preserved as Markdown links
Images Extracted to images/ folder
Tables Cleaned and aligned
Lists Ordered, unordered, nested
Code blocks ⚠️ Detected if styled as code
Footnotes Converted to Markdown footnotes
Comments ⚠️ Stripped with --strip-comments
Track changes Accept/reject before converting
Embedded objects Extract manually

Key Features

Feature Details
Image extraction Embedded images saved to images/ folder with sequential naming
Pandoc cleanup Removes escaped brackets, span classes, trailing backslashes
Table normalization Aligns columns, adds proper separators
Heading fix Normalizes hierarchy to start at H1
Frontmatter Optional YAML frontmatter with title and date
Comment stripping Removes Word review comments

Read the full file on GitHub · 251 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 251 lines · 22 tokens per session scan A aeb3e6b1bc78

Subscribe to this mod's changes

docx-to-md is a skill published in the GitHub repository fabioc-aloha/Alex_Skill_Mall (4 stars, last pushed today), licensed MIT. It adds 22 tokens to every session and 1,986 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

design-policy-management-lifecycle

Use when an organization's internal policies accumulate without a defined process for creating, approving, reviewing, and retiring them — establishing a formal policy lifecycle with an accountable owner, a defined review cadence, and a single authoritative repository, rather than letting policies proliferate as…

jeffreytse/grimoire-core · 66 tokens

write-ops-runbook

Use when documenting a repeatable operational procedure that on-call engineers or operators must execute under pressure.

jeffreytse/grimoire-core · 24 tokens

tech-doc-writer

A guide for writing, reviewing, and improving technical documents such as API documentation, design documents, runbooks, and incident reports.

johnqtcg/awesome-skills · 133 tokens

ai-provider-claude-vision

Image understanding and document analysis with Claude's multimodal capabilities -- image input formats, PDF processing, multi-image patterns, structured extraction, and token cost estimation.

agents-inc/skills · 38 tokens

docs-writer

WORKFLOW SKILL — Maintains repository documentation accuracy and freshness across the docs site, agent files, and changelog. WHEN: "update docs", "doc gardening", "staleness check", "changelog entry", "repo explanation", "agent change docs", "skill change docs". DO NOT USE FOR: agent definitions (edit .agent.md…

jonathan-vella/apex-accelerator · 91 tokens

apply-cross-functional-leadership

Use when a manager needs to lead a project or initiative that depends on team members or stakeholders they do not formally manage — to build voluntary cooperation, alignment, and momentum across organizational boundaries through influence rather than authority.

jeffreytse/grimoire-core · 49 tokens