docx-reader
Reads Microsoft Word (.docx) files and extracts text content. Use when needing to read .docx documents. Requires python-docx package.
- Installs
- 308
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/childbamboo/claude-code-marketplace-sample --skill docx-reader- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads docx-reader automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
DOCX Reader
Microsoft Word (.docx) ファイルをテキスト形式で読み込むスキルです。
クイックスタート
基本的な使い方
# WSL環境でPythonスクリプトを実行
wsl python3 scripts/read_docx.py "/mnt/c/path/to/file.docx"
Markdown形式で保存
- スクリプトでテキスト抽出
- Write ツールで .md ファイルに保存
前提条件
python-docx パッケージが必要です：
wsl pip3 install python-docx
使用例
例1: .docx ファイルを読み込んで内容を表示
User: "C:\Users\keita\repos\file.docx を読み込んで"
Assistant:
1. Windowsパスを WSL パスに変換: /mnt/c/Users/keita/repos/file.docx
2. wsl python3 scripts/read_docx.py を実行
3. 抽出されたテキストを表示
例2: .docx を Markdown に変換して保存
User: "申請書.docx を Markdown に変換して保存"
Assistant:
1. scripts/read_docx.py でテキスト抽出
2. Markdown形式で整形
3. Write ツールで 申請書.md に保存
4. 保存完了を報告
ワークフロー
単一ファイルの読み込み
- ユーザーが .docx ファイルパスを指定
- Windows パスを WSL パス形式に変換 (
C:\→/mnt/c/) wsl python3 scripts/read_docx.pyを実行- 抽出されたテキストを表示または保存
複数ファイルの一括処理
- Glob で .docx ファイルを検索
- 各ファイルに対してスクリプトを実行
- 結果をまとめて報告
スクリプト詳細
Python スクリプトは scripts/read_docx.py に配置されています。
主な機能:
- 段落テキストの抽出
- テーブルデータの抽出
- エラーハンドリング
使い方:
python scripts/read_docx.py <file_path>
制限事項
- 画像は抽出されません
- 複雑なレイアウトは簡略化されます
- フォント情報、色などのスタイルは失われます
- 埋め込みオブジェクトは抽出されません
トラブルシューティング
python-docx がインストールされていない
wsl pip3 install python-docx
"No module named 'docx'" エラー
wsl pip3 uninstall docx
wsl pip3 install python-docx
ファイルが開けない
- ファイルパスが正しいか確認（Windows → WSL パス変換）
- ファイルが他のプログラムで開かれていないか確認
- ファイルのアクセス権限を確認
パス変換
Windows パスから WSL パスへの変換：
C:\Users\...→/mnt/c/Users/...D:\Projects\...→/mnt/d/Projects/...- バックスラッシュ
\をスラッシュ/に変換
関連ツール
- pandoc: より高度な変換が必要な場合
- python-docx2txt: 軽量な代替ライブラリ
- mammoth: HTML形式での変換
バージョン履歴
- v1.0.0 (2026-01-06): 初期リリース
- 基本的なテキスト抽出機能
- テーブル抽出対応
- WSL環境での動作
FAQ
What does the docx-reader skill do?
Reads Microsoft Word (.docx) files and extracts text content. Use when needing to read .docx documents. Requires python-docx package.
How do I install docx-reader?
Run npx skills add https://github.com/childbamboo/claude-code-marketplace-sample --skill docx-reader in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/docx-reader/ (personal) or .claude/skills/docx-reader/ (project).
Which AI agents can use docx-reader?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is docx-reader safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains docx-reader?
It is published by childbamboo in childbamboo/claude-code-marketplace-sample. It has 308 recorded installs.
More from childbamboo/claude-code-marketplace-sample
pdf-reader
childbamboo/claude-code-marketplace-sample
Reads PDF files and extracts text content in Markdown format. Handles tables and multi-page documents. Use when needing to read PDF documents. Requires pdfplumber package.
pdf-vision-reader
childbamboo/claude-code-marketplace-sample
Converts PDF pages to images and uses vision analysis to extract content including diagrams, charts, and visual elements. Use for PDFs with rich visual content. Requires pdf2image and poppler-utils.
xlsx-reader
childbamboo/claude-code-marketplace-sample
Reads Excel (.xlsx) files and converts to Markdown format. Handles multiple sheets and large tables. Use when needing to read Excel spreadsheets. Requires openpyxl package.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.