# extract-tables

extract-tables is a Claude Code skill that turns Word tables into one Markdown file while preserving merged-cell structure. It extracts tables for analysis or slides.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/output-tools/extract-tables/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/extract-tables

## What it does

The skill gathers tables from a Word document into a Markdown file. It reads each table’s XML structure and accounts for cells merged across rows or columns. That matters when a basic row-by-row read would repeat cell text or leave continuation cells blank.

The workflow requires Python and the `python-docx` library. It checks the DOCX path before running the extraction script; by default, the Markdown file is saved beside the source document as `<filename>_tables.md`. On Windows, set the output encoding to UTF-8 explicitly to avoid encoding errors with special characters.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill extract-tables -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/extract-tables/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/extract-tables/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill extract-tables -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/extract-tables/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill extract-tables -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/extract-tables/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills output-tools/extract-tables/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/extract-tables/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill extract-tables -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path output-tools/extract-tables
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/extract-tables/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/output-tools/extract-tables/SKILL.md

## When to use it
- export every table in a DOCX file to Markdown
- retain the layout of horizontally merged cells
- recover values across vertically merged cells
- prepare Word tables for analysis or slides

## Example prompts
- Extract every table from `report.docx` into one Markdown file.
- Convert the tables in `data.docx` and preserve merged cells.
- Put the tables from this Word document into Markdown for analysis.

## Similar
- [docx-manipulation](https://affpapa.org/en/nevibecode/skills/docx-manipulation.md) — skill · 6400 installs
- [docx](https://affpapa.org/en/nevibecode/skills/nous-research-docx.md) — skill · 310 installs
- [tor-procurement](https://affpapa.org/en/nevibecode/skills/tor-procurement.md) — skill · 290 installs
- [docx-construction](https://affpapa.org/en/nevibecode/skills/docx-construction.md) — skill · 128 installs
- [doc](https://affpapa.org/en/nevibecode/skills/doc.md) — skill · 99 installs
- [rtl-document-translation](https://affpapa.org/en/nevibecode/skills/rtl-document-translation.md) — skill · 1 install

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
