extract-tables — Claude Code skill for DOCX 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.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill extract-tables -a claude-codeWhat extract-tables 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.
What it helps with
- 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 for the agent
- Extract every table from
report.docxinto one Markdown file. - Convert the tables in
data.docxand preserve merged cells. - Put the tables from this Word document into Markdown for analysis.
How to install extract-tables
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill extract-tables -a claude-code2Manually: put the files in place
~/.claude/skills/extract-tables/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/extract-tables/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill extract-tables -a codex2Manually: put the files in place
.agents/skills/extract-tables/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill extract-tables -a cursor2Manually: put the files in place
.cursor/skills/extract-tables/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills output-tools/extract-tables/SKILL.md2Manually: put the files in place
.github/skills/extract-tables/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill extract-tables -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path output-tools/extract-tablesManually: put the files in place
.devin/skills/extract-tables/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about extract-tables
How do I install extract-tables in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill extract-tables -a claude-code.
What does extract-tables do?
It exports tables from DOCX files to a single Markdown file and handles cells merged horizontally or vertically.
What does extract-tables need to run?
It requires Python with the python-docx library installed. On Windows, the output encoding should be set to UTF-8.