# docx

Adopt this skill: https://proskills.md/skills/other/axoviq-ai-synthadoc-synthadoc-skills-docx

Page: https://proskills.md/skills/other/axoviq-ai-synthadoc-synthadoc-skills-docx
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: synthadoc/skills/docx/SKILL.md
size: 827
sha: cfa4d6b37b25745000e2493725d788a02ab5475a
upstream: https://github.com/axoviq-ai/synthadoc/blob/main/synthadoc/skills/docx/SKILL.md

````text
---
name: docx
version: "1.0"
description: Extract text from Microsoft Word documents
entry:
  script: scripts/main.py
  class: DocxSkill
triggers:
  extensions:
    - ".docx"
  intents:
    - "word document"
    - "docx"
requires:
  - python-docx
author: axoviq.com
license: AGPL-3.0-or-later
---

# DOCX Skill

Extracts paragraph text from `.docx` files using `python-docx`.

## Setup

```bash
pip install python-docx
```

## Standalone usage

```python
import asyncio
from synthadoc.skills.docx.scripts.main import DocxSkill

skill = DocxSkill()

async def main():
    result = await skill.extract("/path/to/document.docx")
    print(result.text)      # all paragraphs joined as plain text

asyncio.run(main())
```

## When this skill is used

- Source path ends with `.docx`
- User intent contains: `word document`, `docx`
````

## File: synthadoc/skills/docx/scripts/__init__.py
size: 0
sha: e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
upstream: https://github.com/axoviq-ai/synthadoc/blob/main/synthadoc/skills/docx/scripts/__init__.py

```text

```

## File: synthadoc/skills/docx/scripts/main.py
size: 905
sha: fe7d123724fa95e78e56a15aa081fd5875862917
upstream: https://github.com/axoviq-ai/synthadoc/blob/main/synthadoc/skills/docx/scripts/main.py

```text
# SPDX-License-Identifier: AGPL-3.0-or-later
# Copyright (C) 2026 Paul Chen / axoviq.com
from docx import Document
from synthadoc.skills.base import BaseSkill, ExtractedContent, SkillMeta

class DocxSkill(BaseSkill):
    meta = SkillMeta(name="docx", description="Extract text from Word documents",
                     extensions=[".docx"])

    async def extract(self, source: str) -> ExtractedContent:
        try:
            doc = Document(source)
        except Exception as exc:
            raise ValueError(
                f"Cannot read '{source}' as a Word document: {exc}. "
                "Ensure the file is a valid .docx (Office Open XML) document."
            ) from exc
        text = "\n".join(p.text for p in doc.paragraphs if p.text.strip())
        return ExtractedContent(text=text, source_path=source,
                                metadata={"paragraphs": len(doc.paragraphs)})
```

## File: synthadoc/skills/docx/requirements.txt
size: 12
sha: 77894c44c34433687be0a0ca61882bbe7fde7800
upstream: https://github.com/axoviq-ai/synthadoc/blob/main/synthadoc/skills/docx/requirements.txt

```text
python-docx
```

## File: README.md
upstream: https://github.com/axoviq-ai/synthadoc/blob/main/README.md

````text
# Synthadoc

```
      .-+###############+-.
    .##                   ##.
   ##    .----.   .----.    ##
  ##    /######\ /######\    ##
  ##    |######| |######|    ##
  ##    | [SD] | | wiki |    ##
  ##    |######| |######|    ##
  ##    \######/ \######/    ##
   ##    '----'   '----'    ##
    '##                   ##'
      '-+###############+-'

       S Y N T H A D O C
    Community Edition  v1.5.1
  ────────────────────────────────
  Domain-agnostic LLM wiki engine
```

<p>
<a href="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml"><img src="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/actions/workflows/ci.yml"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.coverage&label=Coverage&suffix=%25&color=brightgreen" alt="Coverage"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg" alt="License"/></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.11%2B-yellow.svg" alt="Python"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/tree/main/synthadoc/agents"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.agents&label=AI%20agents&color=crimson" alt="AI agents"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/tree/main/synthadoc/skills"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.skills&label=Skills&color=purple" alt="Skills"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#appendix-i--connect-claude-via-mcp"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.mcp_tools&label=MCP%20tools&color=orange" alt="MCP tools"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/tree/main/hooks"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.hooks&label=Hook%20events&color=teal" alt="Hook events"/></a>
<a href="https://github.com/axoviq-ai/synthadoc"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.cli_commands&label=CLI%20commands&color=darkblue" alt="CLI commands"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/tree/main/obsidian-plugin"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.obsidian_commands&label=Obsidian%20commands&color=blueviolet" alt="Obsidian commands"/></a>
<a href="https://github.com/axoviq-ai/synthadoc/blob/main/docs/user-quick-start-guide.md#agentic-workflows"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Faxoviq-ai%2Fsynthadoc%2Fbadges%2Fdocs%2Fbadges.json&query=%24.maintenance_workflows&label=Maintenance%20workflows&color=green" alt="Maintenance workflows"/></a>
<a href="https://hub.docker.com/r/chenp/synthadoc"><img src="https://img.shields.io/docker/pulls/chenp/synthadoc?label=Docker+pulls" alt="Docker pulls"/></a>
<a href="https://pepy.tech/projects/synthadoc"><img src="https://static.pepy.tech/personalized-badge/synthadoc?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=PyPI+downloads" alt="PyPI downloads"/></a>
<a href="https://github.com/axoviq-ai/synthadoc"><img src="https://img.shields.io/badge/Community%20Edition-v1.5.1-brightgreen.svg" alt="Version"/></a>
</p>

**Document version: v1.5.1**

**Engineered for solo users and enterprises alike, providing a domain-specific knowledge base that scales seamlessly while maintaining accuracy through autonomous self-optimization.**

> Built for individuals, small teams, and large organizations who need a knowledge base that stays accurate as documents accumulate.

**Documentation, FAQ and articles:** https://axoviq.com/resources/synthadoc

Synthadoc reads your raw source documents — PDFs, spreadsheets, PPTs, web pages, images, videos, Word files, TXTs, and AI session transcripts (.jsonl) — and uses an LLM to synthesize them into a persistent, structured wiki. Cross-references are built automatically, contradictions are detected and surfaced, orphan pages are flagged, and every answer cites its sources. Outputs are stored as local Markdown files, ensuring seamless integration and autonomous management within [Obsidian](https://obsidian.md) or any wiki-compliant ecosystem.

---

<table>
  <tr>
    <td align="center" width="33%">
      <a href="https://www.youtube.com/watch?v=rIGO6zi9XQE">
        <img src="https://img.youtube.com/vi/rIGO6zi9XQE/mqdefault.jpg" width="260" alt="From Documents to Wiki — demo walkthrough"/>
      </a>
      <br/>
      <a href="https://www.youtube.com/watch?v=rIGO6zi9XQE">▶ From Documents to Wiki</a>
    </td>
    <td align="center" width="33%">
      <a href="https://youtu.be/ue_kHhG0iog">
        <img src="https://img.youtube.com/vi/ue_kHhG0iog/mqdefault.jpg" width="260" alt="Four Interfaces: CLI, Obsidian, Web UI & MCP"/>
      </a>
      <br/>
      <a href="https://youtu.be/ue_kHhG0iog">▶ Four Interfaces: CLI, Obsidian, Web UI & MCP</a>
    </td>
    <td align="center" width="33%">
      <a href="https://www.youtube.com/watch?v=ojBtNlXVHQk">
        <img src="https://img.youtube.com/vi/ojBtNlXVHQk/mqdefault.jpg" width="260" alt="Agentic Maintenance Workflow"/>
      </a>
      <br/>
      <a href="https://www.youtube.com/watch?v=ojBtNlXVHQk">▶ Agentic Maintenance Workflow</a>
    </td>
  </tr>
</table>

<!-- pypi-strip-start -->

<p align="center">
  <a href="docs/media/README.md">📝 Blogs & Media — YouTube · Coderlegion · DEV.to · Medium</a>
</p>
<p align="center">
  <a href="docs/example/aquaflow/README.md">📂 End-to-end Example — AquaFlow Capital M&A due diligence walkthrough</a>
</p>
<!-- pypi-strip-end -->

---

## Table of Contents

- [Who Is It For?](#who-is-it-for)
- [Inspiration and Vision](#inspiration-and-vision)
- [Problems Addressed](#problems-addressed)
- [Why Synthadoc?](#why-synthadoc)
- [Architecture](#architecture)
- [What's Included](#whats-included)
- [Installation](#installation)
- [Quick-Start Guide](#quick-start-guide)
- [Creating Your Own Wiki](#creating-your-own-wiki)
- [Configuration](#configuration)
- [Command Reference by Use Case](#command-reference-by-use-case)
- [Administrative Reference](#administrative-reference)
- [Understanding Logs and the Audit Trail](#understanding-logs-and-the-audit-trail)
- [Customization](docs/design.md#customization)
- [Links](#links)

---

## Who Is It For?

Synthadoc scales from a single researcher to a company-wide knowledge platform:

| Team size               | Typical use case                                                                                                                                                                                                                                                                                    |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Solo / 1–2 people**  | Personal research wiki, freelance knowledge base, indie hacker documentation - run it free on Gemini Flash or a local Ollama model with zero ongoing cost       
````
